ClawGuard — 任务与网关看门狗
核心定位
ClawGuard 是 OpenClaw 生态中的轻量级系统级监控服务,专注于两个关键场景的可靠性保障:长时间运行的子代理任务进程监控,以及网关重启失败时的自动配置回滚。
核心用法
1. 任务注册监控:通过 claw-guard register 显式注册任务PID,支持日志文件或输出目录的 freshness 检查(mtime超时告警),任务死亡或停滞时向指定渠道(Matrix/Telegram/Discord/Slack)推送通知
2. 网关重启保护:register-restart 在执行重启前自动快照当前配置(保留5份轮转备份),若30秒内网关未启动则按新→旧顺序尝试回滚并告警
3. 生命周期管理:状态查询、任务移除、清理已完成条目等运维操作
显著优点
- 极简显式模型:拒绝自动发现,只监控明确注册的内容,避免误报和意外行为
- 配置安全网:网关重启失败的自动回滚机制大幅降低配置错误导致的服务中断风险
- 多通道告警:原生集成 OpenClaw 的消息路由体系,支持主流即时通讯平台
- 无状态设计:服务重启后自动清空注册表(进程本就消失),仅保留配置备份,逻辑简洁可预期
潜在缺点与局限
- 非持久化监控:系统重启或服务重启后所有任务注册丢失,必须由代理或用户脚本重新注册,不适合"设置一次永久监控"场景
- 无内容检查:日志监控仅检查 mtime,不解析内容,无法检测逻辑错误或异常输出
- 单点通知:每个任务需单独指定 target,缺乏全局默认通知渠道的优雅降级
- Linux/macOS 专属:依赖 systemd/launchd,无 Windows 支持
适合人群
- 运行长时间训练、导出、批处理等后台任务的 OpenClaw 代理开发者
- 需要安全网关配置变更流程的运维人员
- 追求显式、可预测监控行为而非"智能发现"的谨慎用户
常规风险
- 注册后若未妥善管理(如脚本异常退出未清理),可能残留死任务条目
- 配置回滚虽提供安全网,但5份备份的轮转策略在频繁变更场景下可能覆盖有效历史版本
- 15秒检测周期 + 30秒网关启动等待意味着故障发现存在45秒级延迟