用途:MCP(Model Context Protocol)服务器是 OpenClaw 连接外部工具的方式,但连接可能静默失效——服务器崩溃后直到代理实际调用时才报错,导致任务中途出现难以排查的失败。MCP Health Checker 用于主动监控所有已配置的 MCP 连接,在陈旧连接引发问题之前发出告警。
主要能力:执行多项检查。REACHABLE 测试服务器是否响应连接探测,失败为 CRITICAL;LATENCY 检查响应时间是否低于阈值(默认 5 秒),失败为 HIGH;STALE 检查连接时长是否超过最大年龄(默认 24 小时),失败为 HIGH;TOOL_COUNT 检查服务器暴露的工具数量是否符合预期,失败为 MEDIUM;CONFIG_VALID 校验 MCP 配置项是否含必填字段,失败为 MEDIUM;AUTH_EXPIRY 检查 OAuth/API 令牌是否临近过期,失败为 HIGH。
使用方式:提供命令行接口。python3 check.py --ping 可探测全部已配置服务器;加 --server <name> 指定单个服务器;--timeout 3 自定义超时秒数;--status 查看上次检查摘要;--history 查看历史检查结果;--config 校验配置;--format json 输出机器可读结果。也可每 6 小时通过 cron 自动运行后台静默检查,流程为读取配置、逐个探测、测量延迟、检查陈旧度、核对工具数量与令牌过期、更新状态并输出健康/降级/不可达摘要,若存在 CRITICAL 问题则退出码为 1。
适用场景:定时后台巡检;在依赖 MCP 工具的任务开始前手动检查;MCP 工具调用意外失败时诊断连接;重启 MCP 服务器后验证连接已恢复。
限制:仅做只读监控,不修改 MCP 配置。探测使用与服务器相同的传输方式(stdio 子进程启动或 HTTP GET)。状态与历史保存在 ~/.openclaw/skill-state/mcp-health-checker/state.yaml。延迟与陈旧阈值可分别通过 --timeout 与 --max-age 配置。其余收费、平台支持等信息暂未提供。