swarm-janitor

核心用法

Swarm Janitor 是一款面向 OpenClaw 生态的企业级维护工具，设计目标为自动识别并清理孤立的子代理会话，同时通过 SuperMemory 归档重要工作记录以释放磁盘空间。其工作流程包括：扫描会话目录、分析会话年龄与活动状态、将转录记录归档至 SuperMemory、安全删除孤立会话文件，并生成详细的清理报告。

用户可通过命令行参数控制行为：：--dry-run 预览变更、、--archive 先归档后清理、、--clean 执行实际删除、、--retention-days 自定义保留期限。支持定时任务（Cron）自动化运行，也提供手动清理和紧急清理模式。

显著优点

该工具在设计上体现了多重安全考量：默认启用 dry-run 模式避免误操作；强制检查进程状态确保不删除活跃会话；集成 SuperMemory 备份机制防止数据丢失；提供可配置的保留策略和详细的审计日志。企业级特性包括 YAML 配置管理、JSON/CSV 指标导出、以及完整的操作时间戳记录，适合需要合规审计的生产环境。

潜在缺点与局限性

关键缺陷：SKILL.md 中引用的核心脚本 scripts/swarm_janitor.py 并未实际提供，导致该技能目前仅为纯文档型资产，无法执行任何功能。用户若按文档操作会发现脚本不存在，功能描述与实际交付严重不符。此外，SuperMemory 归档功能依赖外部 API 密钥配置，增加了部署复杂度；紧急清理模式的 --force 参数若与过短的保留期限结合，存在误删风险。

适合的目标群体

• OpenClaw 生态的运维人员和管理员
• 需要自动化子代理会话管理的企业用户
• 具备 Python 开发能力、能够自行补全缺失脚本的开发者
• 关注审计合规和磁盘空间管理的团队

使用风险

1. 功能不可用风险：核心脚本缺失，当前无法执行任何清理操作
2. 自行实现风险：若用户自行编写配套脚本，需独立承担安全审查责任
3. 配置错位风险：config.yaml 中的路径需与本地 OpenClaw 安装匹配，否则扫描失败
4. 权限风险：实际运行时需要对会话目录的写权限，配置不当可能导致权限错误
5. 依赖风险：SuperMemory 技能需单独配置有效 API 密钥，否则归档功能失效