openclaw-watchdog

核心用法

openclaw-watchdog 是一款专为 OpenClaw 网关设计的后台自愈监控服务。它以 15 秒为周期向 localhost:3117/health 发送健康检查请求，当连续 3 次检测失败后，自动尝试重启网关服务，并通过 Telegram 向用户推送实时告警。整个部署流程高度自动化：用户仅需提供 Telegram Bot Token 和 Chat ID，系统即完成凭证验证、服务安装、配对测试和状态确认的全流程配置。

该服务深度集成操作系统原生机制——macOS 采用 LaunchAgent、Linux 使用 systemd user 服务——确保低资源占用和稳定的后台运行。诊断分析完全在本地执行，通过模式匹配识别日志异常，无需将任何数据传输至外部服务器。

显著优点

安全架构严谨：敏感凭证采用 AES-256-CBC 加密存储，密钥由机器硬件 UUID、主机名和用户名派生，实现设备绑定保护。关键操作如重新安装（npm install -g）需用户主动创建批准文件，杜绝未授权破坏性操作。

自愈能力完整：从故障检测、自动重启到用户通知形成闭环，最多 2 次重启尝试后转为纯通知模式，避免无限循环。用户可通过 Telegram 实时掌握网关状态，实现"无人值守但可控"的运维体验。

部署体验友好：提供一键式安装脚本，自动适配 macOS 和 Linux 双平台，卸载命令完整清晰，无残留配置困扰。

潜在缺点与局限性

平台绑定性强：加密密钥与机器硬件强关联，更换设备或重装系统后需重新配置全部凭证，不适合频繁迁移的灵活场景。

依赖外部生态：核心功能依赖 Telegram 作为通知通道，在网络受限或无法访问 Telegram 的环境中完全失效。同时依赖 ioreg、、journalctl、、tail 等系统命令的可用性，精简容器环境可能需额外安装工具。

功能边界明确：仅针对 OpenClaw 网关设计，无法扩展为通用服务监控工具；自动修复能力限于重启操作，复杂故障仍需人工介入。

适合的目标群体

• 个人开发者或小型团队运维 OpenClaw 网关，追求"部署后省心"的轻量级监控方案
• 已深度使用 Telegram 作为工作通知渠道的技术用户
• 需要基础自愈能力但不愿投入重量级监控基础设施（如 Prometheus + Alertmanager）的场景
• 重视数据隐私、希望诊断分析完全本地化的敏感环境用户

使用风险

subprocess 执行风险：虽然所有命令参数均为硬编码或已验证输入，但服务本质仍通过 subprocess.run()() 调用系统命令，极端情况下若 OpenClaw 二进制文件被恶意替换，可能引发连锁执行风险。

凭证泄露隐患：Telegram Bot Token 一旦泄露，攻击者可向用户发送伪造告警或尝试社会工程攻击。建议单独创建专用 Bot 而非复用已有高权限 Bot。

服务权限边界：以用户级别运行虽降低了系统级风险，但也意味着若网关故障由系统级资源耗尽（如端口被占用、系统文件损坏）引起，自动重启可能无法奏效。

日志膨胀风险：持续运行的监控服务会产生日志累积，长期未清理可能占用磁盘空间，建议配合日志轮转策略使用。