mac-cleanup

What This Skill Does

The Mac Cleanup skill is a specialized utility designed to help OpenClaw users maintain a healthy and efficient macOS environment. Over time, macOS accumulates significant amounts of digital clutter that can degrade system performance and consume valuable storage capacity. This skill automates the tedious task of manual maintenance by targeting three primary areas: system caches, the user Trash folder, and outdated files in the Downloads directory. By clearing ~/Library/Caches, the agent removes temporary data that is often left behind by applications. Emptying ~/.Trash ensures that deleted files are permanently removed from the drive, rather than just hidden in a temporary state. Furthermore, the skill intelligently scans ~/Downloads for files older than 30 days, assisting users in decluttering one of the most neglected folders on their machine.

Installation

To integrate this skill into your OpenClaw agent, use the official installation command via the terminal. Ensure you have the necessary permissions granted to your agent to interact with the file system. Run the following: clawhub install openclaw/skills/skills/aadipapp/mac-clean-skill Once installed, the cleanup command becomes available for your agent to execute.

Use Cases

This skill is ideal for professionals who download large numbers of documents or installers daily and frequently find their SSD space running low. It is also highly effective for users who perform routine system maintenance but find themselves forgetting to empty the Trash or organize their Downloads folder regularly. It acts as a preventative maintenance tool to ensure consistent performance for high-load workflows.

Example Prompts

1. "OpenClaw, my disk space is getting low. Can you run the cleanup process to free up some room?"
2. "I've been working on this laptop for a month, please use the mac-cleanup skill to remove any junk files and empty my trash."
3. "Run a system cleanup to delete my old downloads and clear out cache files."

Tips & Limitations

• Safety First: The skill deletes files permanently. It does not provide a 'recycle bin' or undo functionality for the cleaned files, so ensure no important documents are sitting in the Trash before triggering the command.
• Downloads: The 30-day age limit is hardcoded. If you keep important files in your Downloads folder for extended periods, move them to a proper directory to avoid accidental deletion.
• Permissions: Ensure your agent has full disk access enabled in macOS Security & Privacy settings for the cleanup script to execute properly.