- name
- self-heal-watchdog
- description
- >
- Triggers
- watchdog, self-heal, monitoring, recovery, failover, health check, gateway restart.
Self-Heal Watchdog 🛡️
三层自愈保护系统，监控 OpenClaw Gateway 进程、配置完整性和模型响应。
安装
bash skills/self-heal-watchdog/scripts/setup.sh使用 launchd（macOS 原生调度器），每 60 秒运行一次。
手动命令
| 命令 | 说明 |
|---|---|
bash scripts/status.sh | 查看当前状态和最近日志 |
bash scripts/status.sh --full | 查看完整日志 |
bash scripts/watchdog.sh | 手动运行一次看门狗 |
bash scripts/watchdog.sh --dry-run | 干运行（不执行任何操作） |
bash scripts/model-failover.sh | 手动触发模型切换 |
bash scripts/setup.sh --uninstall | 卸载看门狗 |
三层保护
1. Process Watchdog
每分钟检测 gateway 进程是否存活，崩溃自动 restart。
2. Config Guard
每次检查前备份 ~/.openclaw/openclaw.json，配置损坏自动回滚。
3. Model Health Check
通过 /health 端点检测模型响应，连续 2 次失败自动切换 fallback 模型。
文件说明
| 文件 | 用途 |
|---|---|
scripts/watchdog.sh | 主脚本（cron 每分钟调用） |
scripts/health-check.sh | 健康检查逻辑 |
scripts/model-failover.sh | 模型切换逻辑 |
scripts/setup.sh | 安装/卸载 |
scripts/status.sh | 状态查看 |
配置
- 状态文件:
~/.openclaw/watchdog-state.json - 日志文件:
~/.openclaw/watchdog/watchdog.log - Gateway URL:
http://localhost:18789 - 检查间隔: 1 分钟（cron）
- 失败阈值: 连续 2 次触发 failover
安全
- 所有脚本仅监听 localhost
- 不记录 API key/token
- 日志自动轮转（保留 1000 行）
- 修改配置前先备份