openclaw-watchdog

描述： OpenClaw 网关的自愈型监控系统。持续监测网关健康状态，发生故障时自动重启，并通过 Telegram 发送告警。诊断与日志分析均在本地设备上执行。告警通知将发送至用户配置的 Telegram bot。适用于需要为网关部署监控、看门狗或自动恢复能力的场景。

前置条件

• Telegram Bot Token — 通过 Telegram 中的 @BotFather 创建
• Telegram Chat ID — 用户用于接收告警的个人聊天 ID
• Python 3 — watchdog 服务所必需
• OpenClaw — 已安装并正在运行

触发关键词

• watchdog、monitoring、auto-fix、gateway health、self-healing、auto-recovery、watch dog

安装步骤

向用户发送**一条**完整消息，包含全部所需信息：

🐕 Watch Dog — 自愈型网关监控器

Watch Dog 是一个后台服务，每 15 秒对您的 OpenClaw 网关发起一次健康检查（ping）。若检测到网关宕机，将自动尝试重启，并通过 Telegram 向您发送告警，确保您始终掌握最新状态。所有诊断任务均在您的本地设备上运行。

要完成安装，请提供以下两项信息：

1. Telegram Bot Token — 在 Telegram 中通过 @BotFather 创建 bot，然后将生成的 token（格式类似 123456:ABC-DEF...）发送给我

2. 您的 Telegram Chat ID — 向您自己的 bot 发送 /start 指令，随后访问 https://api.telegram.org/bot/getUpdates 获取您的 chat ID

请将 token 和 chat ID 一并发送给我，我将为您完成后续全部操作（包括一次完整测试，确保一切正常运行）！

收到凭证后的操作流程

请按顺序执行以下步骤：

1. 验证凭证

python3 ~/.openclaw/workspace/openclaw-watchdog/scripts/validate.py "$TELEGRAM_TOKEN"

2. 运行安装脚本

chmod +x ~/.openclaw/workspace/openclaw-watchdog/scripts/setup.sh
~/.openclaw/workspace/openclaw-watchdog/scripts/setup.sh 
  --telegram-token "$TELEGRAM_TOKEN" 
  --telegram-chat-id "$TELEGRAM_CHAT_ID" 
  --gateway-port "$GATEWAY_PORT"  # 可选；如未指定，将从 openclaw.json 自动探测

3. 通过 Telegram 完成配对（连接）

python3 ~/.openclaw/workspace/openclaw-watchdog/scripts/test-message.py "$TELEGRAM_TOKEN" "$TELEGRAM_CHAT_ID"

请等待用户确认已成功收到 Telegram 消息，再继续后续操作。

4. 验证服务是否正常运行

# 查看服务状态
if [[ "$(uname)" == "Darwin" ]]; then
  launchctl list | grep openclaw.watchdog
else
  systemctl --user status openclaw-watchdog
fi

# 查看最近 20 行日志
tail -20 ~/.openclaw/watchdog/watchdog.log

5. 向用户确认启用成功

告知用户 Watch Dog 已激活，说明其监控范围，并强调：一旦出现异常，用户将立即收到 Telegram 告警。

工作原理

• 每 15 秒向网关健康检查端点（health endpoint）发起一次 ping（端口默认从配置文件自动探测，也可通过 --gateway-port 手动指定）
• 连续 3 次 ping 失败后，执行 openclaw gateway restart 尝试重启
• 最多尝试重启 2 次；若仍失败，则通过 Telegram 向用户申请重新安装权限
• 用户需在终端中运行：touch ~/.openclaw/watchdog/approve-reinstall 以授权
• 若未获授权，仅发送通知，不执行任何破坏性操作
• 本地进行基于模式匹配的日志诊断（日志内容不会外传）
• 在 macOS 上作为 LaunchAgent 运行，在 Linux 上作为 systemd user service 运行
• 凭证使用 AES-256 加密，密钥基于设备唯一生成

卸载方法

if [[ "$(uname)" == "Darwin" ]]; then
  launchctl unload ~/Library/LaunchAgents/com.openclaw.watchdog.plist 2>/dev/null
  rm -f ~/Library/LaunchAgents/com.openclaw.watchdog.plist
else
  systemctl --user stop openclaw-watchdog 2>/dev/null
  systemctl --user disable openclaw-watchdog 2>/dev/null
  rm -f ~/.config/systemd/user/openclaw-watchdog.service
fi
rm -rf ~/.openclaw/watchdog