核心用法
infra-watchdog 是 OpenClaw 生态下的原生监控技能，采用完全自托管架构，不依赖任何外部 SaaS 服务。用户通过 CLI 工具配置多类型监控探针，包括 HTTP/HTTPS 端点、TCP 端口、SSL 证书有效期、磁盘/内存/负载使用率、Docker 容器状态、DNS 解析及 ICMP 可达性等 10 类指标。
配置完成后，通过 OpenClaw 的本地 cron 机制周期性执行 watchdog.py check，检查结果支持三种输出模式：彩色终端人类可读格式、JSON 机器格式（便于二次集成）、以及摘要模式（适合聊天推送）。告警通道复用 OpenClaw 内置的消息系统，支持 WhatsApp、Telegram、Discord 等主流 IM 平台。
显著优点
1. 零外部依赖闭环：所有监控逻辑、状态存储、历史记录均在本地完成，无需担心第三方服务宕机导致监控盲区或数据泄露风险。
2. 深度系统集成：原生支持 Docker、系统负载、SSL 证书等基础设施层面的细粒度监控，阈值规则可按业务需求灵活调整。
3. 智能告警策略：内置冷却期（30 分钟防刷屏）、故障 escalation（连续 3 次失败升级严重级别）、自动恢复通知、静音时段（23:00-08:00）及每日摘要，减少无效打扰。
4. 极简运维：纯 Python 单文件脚本，无额外守护进程，故障排查直接阅读源码即可。
潜在缺点与局限性
- 单节点瓶颈：监控任务与业务系统共宿主机，宿主机宕机则监控本身失效且无冗余通知，存在"监控盲区"。
- 无分布式视角：无法跨多机聚合状态或实现集群级故障关联分析，适合中小型单体架构，大型分布式系统需配合额外工具。
- 历史数据局限：仅保留 30 天本地 JSON 历史，缺乏时序数据库的查询与分析能力，长期趋势洞察不足。
- 告警渠道依赖 OpenClaw：若 OpenClaw 消息模块配置不当，告警链路即中断，存在单点依赖。
适合人群
- 个人开发者或小微团队，追求极致隐私、拒绝将监控数据上传云端；
- 已部署 OpenClaw 自动化平台的用户，希望统一技术栈；
- 边缘设备或封闭网络环境下的运维场景（如 IoT 网关、内网服务器）。
常规风险
- 配置持久化风险：监控配置明文存储于
~/.openclaw/workspace/monitoring/watchdog.json，若目录权限配置宽松，敏感目标信息（如内网 IP、端口）可能泄露。 - SSL 证书监控盲区：仅检查有效期，不验证证书链信任或域名匹配，存在证书配置错误但监控显示正常的假阴性。
- 资源竞争：高频监控（如 1 分钟间隔）在宿主机高负载时可能加剧资源争抢，需根据实际负载调整频率。