概述

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 行）
修改配置前先备份

版本历史

共 1 个版本

v1.0.0 当前

2026-05-01 15:17 安全安全

安全检测

腾讯云安全 (Keen)

安全，无风险

查看报告

腾讯云安全 (Sanbu)