安全扫描（ClawHub）

• VirusTotal ：良性
• OpenClaw ：良性

OpenClaw 评估

The skill's code and instructions match its stated purpose (macOS disk analysis and cleanup); it performs local file deletions and occasional sudo actions but does not contact external services or request unrelated credentials.

安装（复制给龙虾 AI）

将下方整段复制到龙虾中文库对话中，由龙虾按 SKILL.md 完成安装。

请把本段交给龙虾中文库（龙虾 AI）执行：为本机安装 OpenClaw 技能「Mac Cleaner - Because your Mac shouldn't have more baggage than your ex.」。简介：Analyze and safely clean disk space on macOS. Use when the user asks about Mac …。
请 fetch 以下地址读取 SKILL.md 并按文档完成安装：https://raw.githubusercontent.com/openclaw/skills/refs/heads/main/skills/apprithm/mac-cleaner/SKILL.md
（来源：yingzhi8.cn 技能库）

SKILL.md

打开原始 SKILL.md（GitHub raw）

---
name: mac-cleaner
description: Analyze and safely clean disk space on macOS. Use when the user asks about Mac storage, "System Data" taking too much space, disk cleanup, freeing up space, or managing storage on macOS. Covers caches, iOS simulators, Xcode data, trash, logs, and browser caches. Safe for everyday Mac users.
---

# Mac Cleaner

Safely analyze and reclaim disk space on macOS. Designed for everyday Mac users — no technical knowledge required.

## When to use

- "My Mac says System Data is taking too much space"
- "How do I free up disk space?"
- "Why is my disk full?"
- "Clean up my Mac storage"
- "What's taking up space on my Mac?"

## What this skill covers

| Category | Safe to Clean | Notes |
|----------|---------------|-------|
| User Caches | ✅ Yes | App temporary files |
| iOS Simulators | ✅ Yes | Unused simulator devices |
| Xcode Derived Data | ✅ Yes | Build artifacts (rebuildable) |
| Browser Caches | ✅ Yes | Chrome, Safari, Firefox |
| System Logs | ✅ Old only | 7+ days old, requires sudo |
| Trash | ✅ Yes | Empty trash |
| iOS Backups | ⚠️ Review | Check if backups are needed |
| Parallels VMs | ⚠️ Review | Only if Windows not needed |
| Time Machine Snapshots | ⚠️ Review | Can delete old snapshots |

## NEVER delete

- `/System` folder contents
- `/Library/Extensions` or kernel extensions
- `/private/var/db` (system databases)
- Active iOS backups you need
- Parallels VMs you use

## Quick start

### Analyze (safe, read-only)

```bash
bash scripts/mac-cleanup.sh analyze
```

Shows disk usage and identifies large items without making changes.

### Clean (with confirmation)

```bash
bash scripts/mac-cleanup.sh clean
```

Performs safe cleanup after user confirmation.

## What gets cleaned

1. **User Caches** (`~/Library/Caches/*`)
   - App temporary files, thumbnails, downloaded content
   - Safe: apps rebuild these automatically

2. **Xcode Derived Data** (`~/Library/Developer/Xcode/DerivedData/*`)
   - Build artifacts and intermediate files
   - Safe: rebuilds on next compile

3. **iOS Simulators** (unavailable devices only)
   - Old iOS simulator images
   - Safe: easily re-downloaded via Xcode

4. **Browser Caches**
   - Chrome, Safari, Firefox cache files
   - Safe: websites reload, login sessions preserved

5. **Old System Logs** (7+ days)
   - Requires sudo password
   - Preserves recent logs for debugging

6. **Trash**
   - Empties `.Trash` folder
   - Safe: user already chose to delete these

## Manual cleanup for large items

If the script identifies large items you want to handle manually:

### iOS Device Backbacks (~/Library/Application Support/MobileSync/Backup)

```bash
# List backups
ls -lah ~/Library/Application Support/MobileSync/Backup/

# Delete specific backup (use folder name from above)
rm -rf ~/Library/Application Support/MobileSync/Backup/[FOLDER_NAME]
```

Or use **Finder → Locations → [Your iPhone] → Manage Backups**

### Time Machine Local Snapshots

```bash
# List snapshots
tmutil listlocalsnapshots /

# Delete all local snapshots
sudo tmutil deletelocalsnapshots /

# Or delete specific date
sudo tmutil deletelocalsnapshots 2024-01-15-123456
```

### Parallels VMs

Open **Parallels Desktop**:
- Right-click VM → **Reclaim Disk Space** (safest)
- Or **Delete** if you don't need Windows

### WeChat / Large Apps

Clear from within the app:
- WeChat: Settings → General → Storage → Manage
- Telegram: Settings → Data and Storage → Storage Usage
- Slack: Help → Troubleshooting → Clear Cache

## Large folders to review manually

| Path | What it is | Safe to delete? |
|------|-----------|-----------------|
| `~/Downloads` | Downloaded files | Review first |
| `~/Movies` | Videos | Review first |
| `~/Parallels` | Windows VMs | Only if not using |
| `~/Library/Containers/com.tencent.xinWeChat` | WeChat data | Clear from WeChat app |
| `~/Library/Application Support` | App data | Review per app |

## Expected results

Typical cleanup results for an everyday Mac user:

- **Light user**: 2-5 GB freed
- **Developer**: 20-50 GB freed (Xcode, simulators)
- **Heavy messaging apps**: 50-100 GB freed (WeChat, Telegram)
- **With VMs**: 50-200 GB freed (if deleting Parallels)

## Troubleshooting

### "Operation not permitted" errors

Grant Terminal Full Disk Access:
1. System Settings → Privacy & Security → Full Disk Access
2. Add Terminal (or iTerm)
3. Restart terminal

### Cleanup didn't free much space

Run the analyze mode again:
```bash
bash scripts/mac-cleanup.sh analyze
```

Look for:
- iOS device backups (often 50-200GB)
- Parallels VMs (20-100GB each)
- WeChat/Telegram data (can be 100GB+)
- Time Machine snapshots (can accumulate)

These require manual review before deletion.

## References

- Apple's storage documentation: https://support.apple.com/guide/mac-help/check-storage-space-mchlc03eb677/mac
- Safe macOS cleanup practices: https://support.apple.com/en-us/HT202083