| name | self-heal-watchdog |
| description | Automated self-healing system for OpenClaw gateway with model failover support. Three-layer protection: process watchdog (auto-restart on crash), config guard (backup + rollback), and model health check (auto-switch to fallback model on API failure). Use for: gateway monitoring, automatic recovery, model failover, crash recovery, uptime protection. 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 行）
- 修改配置前先备份
