OpenClaw Watchdog

跨平台配置自动备份与网关健康监控。

⚠️ 首次使用请运行安装脚本：

node /usr/lib/node_modules/openclaw/skills/openclaw-watchdog/scripts/install.js

安装后将自动配置持久化运行并启动服务。

安装

从 ClawHub 安装

clawhub install openclaw-watchdog-pro

手动安装（本地）

# 运行安装脚本（推荐）
node /usr/lib/node_modules/openclaw/skills/openclaw-watchdog/scripts/install.cjs

# 安装后自动：
# - 检测系统类型（systemd/launchd/cron/Windows）
# - 配置持久化运行
# - 添加 oc 快捷命令
# - 启动看门狗服务

手动启动

# 启动看门狗（后台运行）
node /usr/lib/node_modules/openclaw/skills/openclaw-watchdog/scripts/watchdog.cjs monitor &

# 或使用包装命令（自动备份）
oc config edit
oc gateway restart

核心功能

1. 自动备份

使用 oc 命令（包装脚本），修改配置前自动备份：

# Linux/macOS - 添加到 ~/.bashrc
alias oc='node /usr/lib/node_modules/openclaw/skills/openclaw-watchdog/scripts/watchdog.cjs wrap'

# Windows (PowerShell) - 添加到 $PROFILE
function oc { node C:pathtowatchdog.cjs wrap $args }

备份位置：~/.openclaw/backups/ 保留策略：最近 5 个备份（可配置）

2. 网关监控

• WebSocket 探针检测 gateway 状态（直接连接 ws://127.0.0.1:18789）
• 每分钟检查一次，连续两次无响应时触发恢复
• 自动恢复最新备份并验证 gateway 启动
• 连续 3 次恢复失败后自动调用 openclaw doctor --fix 进行深度修复

3. 错误模式检测

从 gateway 日志中检测异常错误模式：

智能分析：

• 错误率 (errors/min)
• 突增检测 (3x vs 上次检查)
• 错误集中度 (单一类型 ≥80%)

4. 命令参考

# 启动监控（前台）
node .../watchdog.cjs monitor

# 手动备份
node .../watchdog.cjs backup

# 检查 gateway 状态
node .../watchdog.cjs check

# 检查错误模式
node .../watchdog.cjs check-errors

# 检查状态
node .../watchdog.cjs check

# 恢复并重启
node .../watchdog.cjs recover

# 查看运行状态
node .../watchdog.cjs status

# 配置管理
node .../watchdog.cjs config edit    # 查看当前配置
node .../watchdog.cjs config reset   # 重置为默认

配置

编辑 ~/.openclaw/watchdog.config.json：

{
  "checkIntervalMs": 60000,      // 检查间隔（毫秒）
  "retryDelayMs": 5000,          // 重试延迟（毫秒）
  "maxBackups": 5,               // 最大备份数
  "gatewayStartTimeoutMs": 30000, // gateway 启动超时（毫秒）
  "logLevel": "info",            // 日志级别：debug, info, warn, error
  
  "errorThreshold": 30,          // 错误数阈值，超过则告警
  "errorWindowMs": 1800000,      // 监控窗口（毫秒，30分钟）
  "spikeRatio": 3,               // 突增倍数
  "errorLogPath": null,          // 日志路径（自动检测）
  "extraPatterns": ""            // 自定义正则模式
}

持久化运行

推荐： 运行安装脚本自动配置

node /usr/lib/node_modules/openclaw/skills/openclaw-watchdog/scripts/install.js

手动配置

Linux (systemd)

systemctl status openclaw-watchdog
systemctl restart openclaw-watchdog   # 重启服务
journalctl -u openclaw-watchdog -f    # 查看日志

macOS (launchd)

launchctl list | grep openclaw
launchctl unload ~/Library/LaunchAgents/com.openclaw.watchdog.plist
launchctl load ~/Library/LaunchAgents/com.openclaw.watchdog.plist

Windows

# 查看任务
schtasks /query /tn "OpenClaw Watchdog"

# 删除并重新创建
schtasks /delete /tn "OpenClaw Watchdog" /f

cron (备用方案)

# 每分钟检查
* * * * * node .../watchdog.cjs check || node .../watchdog.cjs recover

文件结构

~/.openclaw/
├── watchdog.cjs              # 主脚本
├── watchdog.config.json      # 用户配置
├── watchdog.state.json       # 运行状态
├── watchdog.pid              # 进程 ID
├── watchdog.log              # 日志文件
└── backups/
    ├── openclaw.2026-03-24T08-00-00.json
    └── ...

故障排查

# 查看服务状态
systemctl status openclaw-watchdog

# 查看日志
tail -f ~/.openclaw/watchdog.log

# 查看运行状态
node .../watchdog.cjs status

# 手动测试
node .../watchdog.cjs check

# 重启服务
systemctl restart openclaw-watchdog

# 调试模式
node .../watchdog.cjs config reset
LOG_LEVEL=debug node .../watchdog.cjs monitor

API 参考

环境变量

退出码

更新日志

• v2.2 - 新增错误模式检测：从 gateway 日志分析 429/限流、5xx、认证/权限、网络错误、投递失败等，智能分析错误率、突增、集中度
• v2.1 - WebSocket 探针检测 gateway（替代 CLI 调用），连续恢复失败自动调用 doctor --fix 修复，增强状态监控
• v2.0 - 重构为 Node.js，跨平台支持，添加状态跟踪、配置管理、优雅关闭
• v1.0 - 初始 Bash 版本