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 密钥，否则归档功能失效

Swarm Janitor 综合评估

核心用法

Swarm Janitor 是专为 OpenClaw 多代理系统设计的运维清理工具，解决子代理会话膨胀导致的磁盘空间问题。其核心工作流程包括：扫描会话目录识别孤儿进程、将重要对话归档至 SuperMemory 记忆系统、安全清理过期会话并生成审计报告。

使用方法灵活，支持命令行直接调用：--dry-run 预览模式为默认安全策略，--archive 启用记忆备份，--clean 执行实际清理，--retention-days 自定义保留周期（默认3天）。企业用户可通过 cron 定时任务实现自动化运维。

显著优点

多层安全防护：六重安全机制确保零误删——进程状态检测、年龄阈值验证、大小异常警告、dry-run 默认、强制 SuperMemory 备份、完整操作日志。这种设计将人为操作风险降至最低。

企业级特性：YAML 配置管理、JSON/CSV 指标导出、审计级日志记录、灵活的保留策略（支持天数和数量双维度），满足生产环境合规要求。

零依赖轻量：纯 Python3 标准库实现，无第三方依赖包，部署简单，维护成本低。

潜在局限

功能边界明确：仅针对 OpenClaw 子代理会话，不支持其他类型临时文件清理；SuperMemory 归档依赖外部记忆系统，需单独配置 API 密钥。

脚本分离风险：文档中引用的 scripts/swarm_janitor.py 未包含在 Skill 包内，实际运行时需要确保脚本来源可信，存在版本不一致或路径配置错误的隐患。

无图形界面：纯命令行工具，对非技术用户不够友好。

适合人群

• OpenClaw 多代理系统的运维工程师
• 需要自动化清理策略的企业团队
• 关注数据保留与合规审计的安全敏感型用户
• 具备基础 Linux/命令行操作能力的技术人员

常规风险

配置风险：保留天数设置过短可能导致重要会话被清理；路径配置错误将导致扫描失败。

权限风险：需要写权限访问会话目录，权限不足时操作会中断。

依赖风险：SuperMemory 归档失败时，若用户强制跳过备份（--no-archive），存在数据永久丢失可能。

定时任务风险：cron 配置不当可能导致高频执行或日志膨胀，建议配合日志轮转策略。