核心用法
Cache Cleanup 是一个自动化磁盘空间管理工具，专为开发环境和沙箱场景设计。用户可通过手动执行脚本或配置定时任务（默认每3天凌晨2点）触发清理流程。工具按预设规则扫描目标目录，识别超期文件后生成清理报告并执行删除。
工作流：扫描 → 分类 → 统计 → 清理 → 报告
支持目录类型：
- 包管理缓存：NPM 缓存（~/.npm/_cache/）
- 系统缓存：通用缓存（~/.cache/）、临时文件（/tmp/）
- 应用专用：OpenClaw 日志、浏览器缓存、沙箱环境、Canvas 渲染缓存
过期策略分层设计：
| 文件类型 | 保留期 | 典型场景 |
|---------|--------|---------|
| 日志文件 | 14天 | 调试追溯需求 |
| 通用缓存 | 7天 | 依赖包、构建产物 |
| 浏览器/Canvas | 3天 | 高频变动的渲染数据 |
| 临时文件 | 1天 | 系统级短期文件 |
智能增强模式：当检测到磁盘使用率超过80%时，自动提升清理频率和深度。
---
显著优点
1. 自动化运维：内置定时机制，无需人工干预即可维持磁盘健康
2. 策略精细化：按文件类型差异化设置保留期，平衡空间释放与数据可追溯性
3. 风险可控：清理前强制检查磁盘状态，生成详细报告供审计
4. 场景覆盖全：从系统级 /tmp 到应用级沙箱（含特殊标记的「猫娘沙箱」）全面覆盖
5. 轻量无侵入：纯脚本实现，无额外依赖，对运行中的服务零干扰
---
潜在缺点与局限性
1. 误删风险：基于时间戳的硬规则可能误删「长期未访问但重要」的文件（如历史版本依赖）
2. 无白名单机制：无法标记特定文件或目录为「永不清理」
3. 沙箱数据敏感性：sandbox-neko 等特殊目录的命名暗示非标准用途，用户可能 unaware 其数据被清理
4. 跨平台局限：路径硬编码为 Unix 风格（~/.openclaw/），Windows 环境需适配
5. 恢复能力缺失：无回收站或备份机制，删除操作不可逆
---
适合人群
- 开发者/运维人员：本地开发机或 CI/CD 节点磁盘空间紧张
- 沙箱/容器用户：频繁创建销毁临时环境的场景
- 资源敏感型部署：边缘设备、云服务器等小磁盘规格实例
---
常规风险
| 风险等级 | 场景 | 缓解建议 |
|---------|------|---------|
| 🔴 高 | 生产环境直接部署 | 先在测试环境验证清理范围 |
| 🟡 中 | 误删未备份的日志审计链 | 关键日志单独归档至外部存储 |
| 🟡 中 | 定时任务冲突导致 I/O 峰值 | 调整 cron 时间避开业务高峰 |
| 🟢 低 | 脚本权限配置不当 | 确保仅授权用户可执行 |