OpenClaw Watch Dog

OpenClaw网关自愈监控系统,自动检测故障、修复崩溃并发送Telegram告警。

安装

概览

OpenClaw Watch Dog 是一款专为 OpenClaw 网关设计的自愈监控系统,能够在网关运行异常时自动检测故障、尝试恢复并即时通知用户。该系统通过每15秒对本地网关进行健康检查,一旦发现服务无响应,将立即启动重启流程,并在必要时发送 Telegram 告警消息。所有诊断和日志分析均在设备本地完成,确保数据隐私与安全。用户可通过简单的配置流程快速部署该守护服务,无需复杂运维操作即可实现全天候监控。Watch Dog 支持 macOS 和 Linux 系统,分别以 LaunchAgent 或 systemd 用户服务形式运行,具备良好的跨平台兼容性。其核心设计理念是在不依赖外部服务器的情况下,提供轻量级但高效的自动化故障应对机制,特别适合希望减少人工干预、保障网关稳定性的开发者和技术爱好者。

核心功能特点

  1. 每15秒自动检测 OpenClaw 网关健康状态
  2. 连续3次检测失败后自动重启网关服务
  3. 最多执行2次重启尝试,失败后通过 Telegram 请求人工介入
  4. 支持本地日志分析与模式匹配诊断,不上传敏感信息
  5. 采用 AES-256 加密存储 Telegram 凭证,保障通信安全
  6. 跨平台支持:macOS(LaunchAgent)与 Linux(systemd 用户服务)

适用场景

OpenClaw Watch Dog 最适合那些需要持续稳定运行 OpenClaw 网关但又缺乏专职运维支持的个人开发者或小型项目团队。例如,当你在远程服务器上部署 OpenClaw 作为 API 网关或代理节点时,可能无法实时关注其运行状态。此时 Watch Dog 可主动轮询 `localhost:3117/health` 接口,一旦发现服务中断,立即触发重启机制,避免因短暂网络波动或服务僵死导致的长时间停机。对于家庭实验室环境中的物联网网关、私有云入口或本地开发测试平台,该工具能有效降低维护成本,提升系统可用性。尤其适用于使用 Telegram 接收即时通知的用户群体——只需配置好 Bot Token 和 Chat ID,即可在网关崩溃的第一时间收到推送提醒,并根据情况选择是否授权自动重装。此外,由于所有操作均在本地执行且日志不外泄,它也符合对数据主权有较高要求的使用场景。