磁盘清理

面向 OpenClaw 部署的自动化磁盘空间回收工具。覆盖 OpenClaw 当前（截至 2026.3.13）未原生支持的 12 类清理场景。

OpenClaw 已原生支持的内容（无需重复处理）

• 会话存储：session.maintenance 配置项（pruneAfter、maxEntries、rotateBytes）
• Sandbox 容器：sandbox.prune 配置项（idleHours、maxAgeDays）
• 上下文裁剪：contextPruning 配置项（cache-ttl 模式）

本技能覆盖的内容（填补空白）

快速开始

直接运行：

# 预览将被清理的内容（安全，不执行任何删除）
bash scripts/disk-cleanup.sh --dry-run

# 常规清理
bash scripts/disk-cleanup.sh

# 深度清理：包含 SQLite VACUUM + 启用激进模式的 git gc
bash scripts/disk-cleanup.sh --aggressive

# Cron 模式：仅输出摘要行
bash scripts/disk-cleanup.sh --quiet

配置为 Cron 任务

推荐每周日 04:00 CET 执行：

使用 cron 工具：
  schedule: { kind: "cron", expr: "0 3 * * 0", tz: "Europe/Luxembourg" }
  payload: { kind: "agentTurn", message: "Run disk cleanup: bash scripts/disk-cleanup.sh --aggressive --quiet. Report results." }
  sessionTarget: "isolated"

或集成至现有 infra-health-check 脚本中，并添加磁盘使用率阈值触发逻辑：

DISK_PCT=$(df / --output=pcent | tail -1 | tr -d ' %')
if [ "$DISK_PCT" -ge 85 ]; then
  bash /path/to/disk-cleanup.sh --quiet
fi
if [ "$DISK_PCT" -ge 90 ]; then
  bash /path/to/disk-cleanup.sh --aggressive --quiet
fi

环境变量

退出码

• 0 — 成功（已清理或无可清理内容）
• 1 — 清理过程中发生错误

输出格式

最后一行为机器可解析格式：

CLEAN|0|0B|44%          # 未执行任何清理
CLEANED|5|1.2GB|67%     # 共执行 5 项操作，释放 1.2GB，当前磁盘使用率为 67%

安全性保障

• --dry-run 模式下仅预览所有操作，不执行任何删除
• SQLite VACUUM 仅在启用 --aggressive 且检测到碎片率 ≥5% 时执行
• Docker prune 仅清理悬空（dangling，即未打标签）镜像；已命名镜像不受影响
• btmp 文件被截断（truncate），而非删除——系统依赖该文件存在
• journal vacuum 会持久化设置 500MB 的上限，防止日志再次无限制增长
• Git gc 默认使用 --auto；仅在显式指定 --aggressive 时启用激进模式