Openclaw Cleaner for Openclaw

A safety-first automated cleaning tool designed to prevent workspace bloat by managing temporary files in Openclaw Skills ecosystems.

beforesun
v1.0.0
Apr 22, 2026
0
761
0

Install & Download

1. ClawHub CLI

The fastest way to install a skill directly from the registry.

npx clawhub@latest install cleaner4rookies

2. Manual Installation

Copy the skill folder to one of these locations

Global
~/.openclaw/skills/
Workspace
<project>/skills/

Priority: Workspace > Local > Bundled

3. Prompt Installation

Copy this prompt to OpenClaw to install it automatically.

Help me install cleaner4rookies using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).

Prefer to download?

Get the raw skill files in a ZIP archive.

What is Openclaw Cleaner?

Openclaw Cleaner is a specialized utility built to maintain the health of your local development environment. It automatically scans the ~/.openclaw/workspace/ directory for temporary audio, documents, images, and logs, applying user-defined rules to either archive or delete them. By preventing workspace bloat, it ensures that your AI agents operate in a lean, efficient environment.

The tool is designed with a safety-first philosophy, featuring a mandatory dry-run mode by default. This allows users to preview exactly which files will be affected before any changes are made. With integrated support for white-listing and automated backups, it is the premier choice for developers looking to optimize their Openclaw Skills workflows.

Openclaw Cleaner Use Cases

  • Automatically clearing old test audio and media files to save disk space.
  • Archiving important project documents after 24 hours of inactivity.
  • Preventing workspace clutter by removing temporary log files generated during development.
  • Scheduling weekly maintenance tasks to keep your Openclaw Skills environment performant.

How Openclaw Cleaner Works

  1. The script scans the specified workspace directory based on patterns defined in the configuration file.
  2. It checks each file against the age threshold (age_days) to determine if it is eligible for processing.
  3. A whitelist check is performed to ensure critical files like SOUL.md or MEMORY.md are never touched.
  4. In dry-run mode, the skill provides a visual summary of all pending actions (archive or delete).
  5. Upon execution with the force flag, the skill moves files to the archive directory or permanently deletes them while logging the results.

Openclaw Cleaner Setup

To add this to your Openclaw Skills collection, use the following command:

npx skills add ~/.openclaw/workspace/skills/openclaw-cleaner

Alternatively, you can clone the repository manually:

git clone https://github.com/your-repo/openclaw-cleaner.git ~/.openclaw/workspace/skills/openclaw-cleaner

After installation, you can perform a safety check by running the preview script:

bash ~/.openclaw/workspace/skills/openclaw-cleaner/scripts/cleaner.sh

Openclaw Cleaner Data Schema & Taxonomy

The skill uses a YAML-based configuration for rule definition and directory management. All settings are stored in cleaner.yaml.

Configuration Field Description Default/Example
rules Array of file matching rules (pattern, action, age) pattern: "*.mp3", action: delete
dry_run Boolean flag to enable/disable preview mode true
archive_dir Destination path for archived files ~/.openclaw/workspace/cleaner-archive
cron_schedule Standard cron expression for automation "0 3 * * *"
whitelist List of absolute paths to protect ~/.openclaw/workspace/SOUL.md

Openclaw Cleaner Advanced Features

  • Automated scheduling via integrated cron expressions for hands-off maintenance of Openclaw Skills.
  • Multi-tier aging rules allowing different retention periods for images versus documents.
  • Safety-first archiving which moves files to a recovery directory instead of permanent deletion.
  • Comprehensive whitelist mechanism to explicitly protect critical system and memory files.
  • Detailed execution logs to track every file change within the environment.

SKILL.md


Loading

Related Openclaw Skills

METADATA

Github Stars: 0
forks: 0

Featured*