OpenClaw 健康自检器
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @user_f28fdad8/oc-openclaw-health。
技能介绍
要解决什么问题
OpenClaw 作为多渠道网关,往往同时对接飞书、微信、钉钉等渠道。配置分散在 JSON 里,字段缺失、格式错误或端点不可达时,问题通常要到消息链路失败后才暴露。运维需要在不改业务代码的前提下,对整份配置做结构化校验,并区分「配置写错」与「网络/服务不可达」。
技能如何工作
本技能提供四条纯 Python 脚本,输入输出均为 JSON,可用标准库串联成一次自检流程:
config_check.py:检查配置文件的字段、格式与完整性,输出问题清单。connectivity.py:对各渠道端点做 HTTP 连通性探测,记录响应状态与耗时。channel_diag.py:按渠道(飞书/微信/钉钉等)做针对性配置诊断。health_report.py:汇总前三项结果,生成整体健康报告。
数据在脚本间以 JSON 传递,零第三方依赖,适合在 CI、发布前检查或故障排查时快速跑一遍。
适用边界与注意点
- 连通性探测反映的是探测时刻的 HTTP 可达性,不能替代业务侧鉴权、回调或消息格式的端到端验证。
- 渠道诊断覆盖 SKILL 中列出的典型渠道类型;新增或未在诊断逻辑中覆盖的渠道,可能只有配置层校验而无专项结论。
- 报告是诊断汇总,修复动作仍需对照 OpenClaw 官方文档与各渠道开放平台要求人工调整配置。
使用场景
- 上线 OpenClaw 前,用 JSON 配置跑一遍字段校验与各渠道 HTTP 探测,确认端点可达再切流量
- 飞书/微信/钉钉某一渠道消息失败时,先跑 channel_diag 与 connectivity 区分是配置错误还是网络不可达
- 变更网关 JSON 后,在 CI 里串联 config_check 与 health_report,把问题清单写进发布门禁
- 故障复盘需要留档时,汇总 health_report 的 JSON 作为当次配置与连通性快照
适合人员
- 负责 OpenClaw 多渠道网关上线与回滚的 SRE,需要在不改业务代码下做发布前自检
- 维护企业 IM 接入(飞书/钉钉/微信)的集成工程师,要快速定位配置字段与端点连通问题
- 把 OpenClaw 配置纳入流水线门禁的平台工程师,需要零依赖脚本产出标准化 JSON 报告
- 值守消息网关告警的运维,收到渠道异常时要区分配置完整性问题与 HTTP 探测失败