健康检查

概述

OpenClaw 提供多层次的健康检查和诊断能力，帮助你快速发现和解决问题。

诊断命令

基础状态检查

openclaw status

显示 Gateway 是否在运行、已连接的渠道、使用的模型等关键信息。

深度健康检查

openclaw status --deep

深度检查会额外验证：

• API 连接是否正常
• 模型是否可用
• 各渠道连接状态
• 配置文件是否有效

自动诊断修复

openclaw doctor

openclaw doctor 是内置的智能诊断工具，会自动检查常见问题并给出修复建议：

• Node.js 版本是否满足要求（22+）
• 配置文件格式是否正确
• API Key 是否有效
• Gateway 端口是否被占用
• 系统依赖是否完整

实时日志

openclaw logs --follow

实时查看 Gateway 运行日志，按 Ctrl + C 退出。

健康检查端点

Gateway 提供 HTTP 健康检查端点：

GET http://localhost:18789/health

返回各组件运行状态，适用于外部监控系统集成。

常用诊断速查

openclaw status              # 基础状态
openclaw status --deep       # 深度检查
openclaw doctor              # 智能诊断
openclaw logs --follow       # 实时日志
openclaw channels status     # 渠道连接状态
openclaw cron list           # 定时任务状态
openclaw config get          # 查看配置
openclaw gateway restart     # 重启网关

自动化监控

结合定时任务实现自动化监控：

每 10 分钟检查服务器状态，如果 CPU 超过 90% 或内存超过 85% 就发送告警到飞书

详见 定时任务 章节。