健康检查（CLI）

验证频道连通性的快速指南，不用瞎猜。

快速检查

• openclaw status — 本地概要：Gateway 可达性/模式、更新提示、关联频道认证时效、会话数与近期活动。
• openclaw status --all — 完整本地诊断（只读、彩色输出，可以安全地粘贴给别人调试）。
• openclaw status --deep — 同时探测运行中的 Gateway（支持的频道会做逐个探测）。
• openclaw health --json — 向运行中的 Gateway 请求完整的健康快照（仅通过 WS；不直接连 Baileys socket）。
• 在 WhatsApp/WebChat 中发送 /status 作为独立消息，可获得状态回复而不触发 Agent。
• 日志：尾读 /tmp/openclaw/openclaw-*.log，过滤 web-heartbeat、web-reconnect、web-auto-reply、web-inbound。

深度诊断

• 磁盘上的凭证：ls -l ~/.openclaw/credentials/whatsapp/<accountId>/creds.json（修改时间应该比较近）。
• 会话存储：ls -l ~/.openclaw/agents/<agentId>/sessions/sessions.json（路径可在配置中覆盖）。计数和近期联系人会通过 status 显示。
• 重新链接流程：当日志中出现状态码 409-515 或 loggedOut 时，运行 openclaw channels logout && openclaw channels login --verbose。（注意：QR 登录流程在状态 515 配对后会自动重启一次。）

出问题时

• logged out 或状态 409-515 → 通过 openclaw channels logout 然后 openclaw channels login 重新链接。
• Gateway 不可达 → 启动它：openclaw gateway --port 18789（端口被占用时用 --force）。
• 收不到消息 → 确认链接的手机在线且发送者被允许（channels.whatsapp.allowFrom）；群聊请确保白名单 + 提及规则匹配（channels.whatsapp.groups、agents.list[].groupChat.mentionPatterns）。

专用 “health” 命令

openclaw health --json 向运行中的 Gateway 请求健康快照（CLI 不直接连频道 socket）。它会报告链接的凭证/认证时效（如果可用）、各频道探测摘要、会话存储概要和探测耗时。Gateway 不可达或探测失败/超时时以非零退出码退出。用 --timeout <ms> 覆盖默认的 10 秒超时。