Workspace Cleaner

What This Skill Does

The Workspace Cleaner skill, developed by brandonwise, is an essential utility for OpenClaw agents designed to maintain a clutter-free environment. It intelligently scans your workspace to identify and move non-essential files—such as temporary logs, backup files, and obsolete artifacts—into the system trash. By defaulting to a 'dry-run' mode, it provides a safe, transparent way to preview deletions before they occur, ensuring no important project files or configuration data are accidentally purged.

Installation

To integrate this into your agent instance, use the following command: clawhub install openclaw/skills/skills/brandonwise/workspace-cleaner Once installed, you can trigger the cleanup script directly via Python as defined in your skills directory. It is recommended to add a periodic check to your HEARTBEAT.md to ensure your storage space remains optimized over time.

Use Cases

This skill is perfect for developers working on projects that generate large volumes of temporary build artifacts, developers managing multiple ephemeral virtual environments, or anyone who keeps a messy working directory. It is especially useful for agents that frequently download experimental datasets or generate images, helping to keep project-specific folders clean without manual intervention.

Example Prompts

1. "Check the current workspace for any temporary logs or old backup files and let me know how much space I can save."
2. "Run the cleanup script to remove any files older than 30 days that aren't inside the projects or memory folders."
3. "List all files currently taking up more than 100MB in my workspace so I can decide what to delete."

Tips & Limitations

• Safety First: While the script is designed with safety defaults, always run the default preview command first. If you are unsure about a pattern, check the config/patterns.json file to see exactly what is being targeted.
• Recovery: Files moved by this skill are sent to your system trash, providing a safety net if something is deleted that you needed.
• Limitations: The skill will never touch critical directories like .git, projects/, or memory/. Files modified within the last 24 hours are also protected by default, preventing the accidental removal of currently active work. Be careful when modifying the protected_dirs in the configuration, as removing those entries could put vital configuration files at risk.