Swarm Janitor

面向企业的 OpenClaw 子代理管理清理工具。

功能说明

自动识别并清理孤立的子代理会话，同时通过 SuperMemory 归档机制保留重要工作成果。

核心功能

• 扫描（Scan）：分析会话目录，识别孤立/已废弃的子代理
• 归档（Archive）：在删除前将对话记录保存至 SuperMemory
• 清理（Clean）：安全移除孤立会话，释放磁盘空间
• 报告（Report）：生成详细的清理操作报告

安全优先

本技能内置多重安全防护机制：

• ✅ 绝不删除活跃会话 —— 通过检查进程状态实现
• ✅ 预演模式（Dry-run mode） —— 执行前可预览所有变更
• ✅ SuperMemory 备份 —— 删除前自动归档对话记录
• ✅ 可配置的保留策略 —— 支持自定义会话年龄阈值
• ✅ 详细日志记录 —— 完整审计所有操作行为

快速开始

# 预览将被清理的内容（预演模式）
python3 scripts/swarm_janitor.py --dry-run

# 将旧会话归档至 SuperMemory 后执行清理
python3 scripts/swarm_janitor.py --archive --clean

# 自定义保留期限（7 天，而非默认的 3 天）
python3 scripts/swarm_janitor.py --retention-days 7 --clean

安装步骤

1. 将本技能复制到你的 OpenClaw 工作区：

   cp -r skills/swarm-janitor ~/.openclaw/workspace/skills/
   

2. 配置保留策略（可选）：

   # 编辑配置文件以进行自定义
   nano references/config.yaml
   

3. 运行首次扫描：

   python3 ~/.openclaw/workspace/skills/swarm-janitor/scripts/swarm_janitor.py --dry-run
   

使用模式

日常维护（Cron 定时任务）

# 每日凌晨 3 点执行：归档超过 3 天的会话
0 3 * * * python3 ~/.openclaw/workspace/skills/swarm-janitor/scripts/swarm_janitor.py --archive --clean --retention-days 3 >> /var/log/swarm-janitor.log 2>&1

手动清理

# 查看哪些会话将被删除
python3 scripts/swarm_janitor.py --dry-run --verbose

# 将对话记录归档至 SuperMemory
python3 scripts/swarm_janitor.py --archive

# 不归档直接清理（不推荐）
python3 scripts/swarm_janitor.py --clean --no-archive

# 生成完整报告
python3 scripts/swarm_janitor.py --report --output json

紧急清理

# 启用激进清理策略（仅保留 1 天内的会话）
python3 scripts/swarm_janitor.py --clean --retention-days 1 --force

配置说明

详见 references/config.yaml 文件中的以下配置项：

• 保留策略（Retention policies）
• 归档目标地址（Archive destinations）
• 安全阈值（Safety thresholds）
• 日志选项（Logging options）

工作原理

1. 发现阶段（Discovery）：扫描 ~/.openclaw/agents/main/sessions/ 目录
2. 分析阶段（Analysis）：评估会话年龄、活跃状态及占用空间大小
3. 分类阶段（Classification）：区分孤立会话与活跃会话
4. 归档阶段（Archival）：启用时将对话记录保存至 SuperMemory
5. 清理阶段（Cleanup）：安全移除孤立会话相关文件
6. 报告阶段（Reporting）：汇总本次执行的所有操作结果

安全机制

故障排查

Q：提示 “permission denied”（权限拒绝）
A：请确认你对会话目录具有写入权限

Q：未检测到会话
A：请检查 config.yaml 中配置的路径是否与你的 OpenClaw 实际安装路径一致

Q：SuperMemory 归档失败
A：请确认 SuperMemory 技能已正确配置有效的 API 密钥

企业级特性

• 审计日志（Audit Logging）：所有操作均带时间戳记录
• 可配置策略（Configurable Policies）：基于 YAML 的灵活配置方式
• 指标导出（Metrics Export）：支持 JSON/CSV 格式输出，便于监控集成
• 预演模式（Dry-Run Mode）：应用变更前可充分测试效果
• 保留策略（Retention Policies）：支持基于年龄和数量的双重规则

许可证

MIT 许可证 —— 由 OpenClawdad（Redclay）为 OpenClaw 社区开发。