健康检查 (CLI)

验证渠道连通性的快速指南,无需猜测。

快速检查

• openclaw status — 本地摘要:网关可达性/模式、更新提示、已链接渠道认证时长、会话 + 近期活动。
• openclaw status --all — 完整本地诊断(只读、彩色、可安全粘贴用于调试)。
• openclaw status --deep — 同时探测正在运行的网关(支持时执行单渠道探测)。
• openclaw health --json — 向正在运行的网关请求完整健康快照(仅 WS;无直连 Baileys socket)。
• 在 WhatsApp/WebChat 中发送 /status 作为独立消息,以获取状态回复而不调用代理。
• 日志:tail /tmp/openclaw/openclaw-*.log 并过滤 web-heartbeat、web-reconnect、web-auto-reply、web-inbound。

深度诊断

• 磁盘上的凭证:ls -l ~/.openclaw/credentials/whatsapp/<accountId>/creds.json(mtime 应该是最近的)。
• 会话存储: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 重新链接。
• 网关不可达 → 启动它:openclaw gateway --port 18789(如果端口占用则使用 --force)。
• 无入站消息 → 确认已链接的手机在线且发送者被允许(channels.whatsapp.allowFrom);对于群聊,确保允许列表 + 提及规则匹配(channels.whatsapp.groups、agents.list[].groupChat.mentionPatterns)。

专用 "health" 命令

openclaw health --json 向正在运行的网关请求其健康快照(CLI 不直连渠道 socket)。它会报告已链接凭证/认证时长(如可用)、单渠道探测摘要、会话存储摘要和探测持续时间。如果网关不可达或探测失败/超时,则以非零状态退出。使用 --timeout <ms> 覆盖默认的 10 秒超时。