A specialized tool to safely analyze and reclaim disk space on macOS by targeting system data, caches, and developer artifacts.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install mac-cleaner
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install mac-cleaner 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 Mac Cleaner?
The Mac Cleaner utility is a powerful addition to your library of Openclaw Skills, designed to demystify macOS storage management. It provides a safe, script-based approach to identifying and removing unnecessary files that often hide under the System Data category. Whether you are an everyday user or a developer dealing with massive Xcode build artifacts, this skill helps you regain control over your hardware resources without risking critical system stability.
By utilizing Openclaw Skills for disk maintenance, you gain access to a structured workflow that distinguishes between safe-to-delete temporary files and sensitive data requiring manual review. The tool targets high-impact areas such as user caches, iOS simulator data, and old system logs, ensuring that your Mac runs efficiently with maximum available storage.
Mac Cleaner Use Cases
- Resolving notifications that Mac storage is full or System Data is taking too much space.
- Freeing up substantial disk space by removing obsolete iOS simulator images and Xcode build artifacts.
- Performing routine maintenance to clear browser caches and system logs without losing login sessions.
- Identifying and managing large manual items like legacy iOS device backups and Time Machine snapshots.
How Mac Cleaner Works
- The user initiates the analysis mode to scan the file system for common storage-heavy categories.
- The skill identifies safe-to-clean items including user caches, browser data, and rebuildable developer files.
- A detailed report is generated within the Openclaw Skills interface showing potential space savings.
- Upon receiving user confirmation, the script executes the cleanup process for safe directories.
- The system provides guidance for manual review of high-impact items like VMs and local backups.
Mac Cleaner Setup
To use this skill effectively, you must grant your terminal application Full Disk Access within macOS System Settings. Once permissions are set, follow these steps:
- Run the analysis script to see what can be cleaned:
bash scripts/mac-cleanup.sh analyze
- Execute the cleanup script to reclaim space:
bash scripts/mac-cleanup.sh clean
Mac Cleaner Data Schema & Taxonomy
The Mac Cleaner skill organizes its cleanup operations across several key data categories and paths:
| Category | Location | Safety Level |
|---|---|---|
| User Caches | ~/Library/Caches/* |
Safe (Rebuildable) |
| Xcode Data | ~/Library/Developer/Xcode/DerivedData/* |
Safe (Rebuildable) |
| Simulator Images | ~/Library/Developer/CoreSimulator/Devices |
Safe (Old items) |
| System Logs | /var/log |
Safe (7+ days old) |
| Trash | ~/.Trash |
Safe |
| Backups | ~/Library/Application Support/MobileSync/Backup |
Review Required |
Mac Cleaner Advanced Features
- Advanced developer cleanup targeting iOS simulators and Xcode derived data for massive space recovery.
- Selective log rotation that preserves recent system logs for debugging while removing legacy files.
- Deep integration with Openclaw Skills workflows for identifying large-scale storage consumers like Parallels VMs and WeChat data.
- Automated detection of Time Machine local snapshots with safe deletion commands.
- Built-in safety checks to prevent modification of protected system directories.
SKILL.md
Loading
Related Openclaw Skills
Grid Clash
An automated battle skill that enables AI agents to compete in 8-player grid arenas using strategic equipment loadouts and personalities.
yt-dlp Video Downloader
A robust media downloader that leverages yt-dlp to fetch video, audio, and subtitles from thousands of websites.
IPFS Server Operations
A comprehensive toolset for deploying and managing full IPFS nodes, including content pinning, IPNS publishing, and gateway services.
eth-readonly: Ethereum Blockchain Explorer
A secure, read-only Ethereum query tool for inspecting blockchain state, balances, and contracts via RPC and Etherscan APIs.
Meetup Planner
An intelligent event discovery assistant that proactively finds, tracks, and reminds you about meetups and conferences matching your interests.
ClawStat
A comprehensive system monitoring skill for OpenClaw agents to track server health and performance metrics efficiently.
Featured*
