核心功能
Gateway Watchdog 是一款专为 OpenClaw 网关设计的健康监控与故障告警技能,采用状态机模型实现精准的故障检测与低噪音通知。核心能力包括:
健康检测机制
- 双重检测:
openclaw gateway status --json检查网关运行状态,openclaw health --json执行 RPC 探针 - 五类故障识别:运行时停止、RPC 探针失败、健康检查不可达、认证不匹配、配置无效
智能告警系统
- Discord 优先:支持 Webhook 或 Bot Token 双模式投递
- 冷却去重:默认 300 秒冷却期,避免告警风暴
- 状态机驱动:仅报告状态变更(正常→故障→恢复),非持续轰炸
部署灵活性
- 手动模式:即开即用,适合调试
- LaunchAgent 模式:macOS 原生后台守护,30 秒间隔无侵入安装
- OpenClaw Cron 模式:内嵌定时任务,隔离会话运行
可选自愈策略
- 默认只读监控,重启为显式 opt-in
- 失败阈值 + 最大尝试次数双重边界保护
- 零配置入侵:数据隔离于
~/.openclaw/watchdogs/
运维可观测性
- JSON 状态文件 + 自动备份轮转
- 结构化事件日志(JSON Lines 格式)
显著优点
1. 低噪音设计:状态机 + 冷却期解决监控工具最常见的"告警疲劳"问题
2. 平台原生:launchd 集成优于传统 cron,符合 macOS 生态习惯
3. 安全边界:重启策略有明确开关和次数上限,杜绝自动化灾难
4. 审计友好:完整的备份与事件追溯链路
潜在局限
1. 平台限制:LaunchAgent 为 macOS 专属,Linux/Windows 需自行适配 systemd/Task Scheduler
2. 依赖前置:需预装 OpenClaw CLI 及有效 Discord 凭据
3. 无 Web UI:纯 CLI/配置文件驱动,对非技术用户门槛较高
4. 网络单点:Discord 作为唯一告警通道,若网络隔离则无备用路径
适合人群
- 个人开发者/小团队运维 OpenClaw 网关实例
- 追求"告警少但精准"的监控哲学践行者
- macOS 主力工作环境的技术用户
- 需要故障自愈但担心自动化风险的保守派
常规风险提示
- Discord Token/Webhook 需妥善保管,避免硬编码于共享环境
- 启用自动重启前建议充分测试失败阈值逻辑
- 状态文件目录建议纳入常规备份策略