macOS 上的健康检查

如何从菜单栏应用读取已关联渠道的健康状态。

菜单栏

状态指示点：

• 绿色：已关联且探测健康。
• 橙色：已关联，但某个渠道探测报告状态降级或未连接。
• 红色：尚未关联。

次要信息行显示“已关联 · 身份验证 12 分钟”，或显示失败原因。 菜单中的“立即运行健康检查”会触发按需探测。

设置

• General 选项卡显示一张健康状态卡片：状态指示点、摘要行（关联状态和身份验证时长），以及可选的失败详情行，并提供 Retry now 和 Open logs 按钮。
• Channels tab 显示 WhatsApp 和 Telegram 各渠道的状态与控制项（登录二维码、退出登录、探测、最近一次断开连接或错误）。

探测的工作原理

应用通过现有的 WebSocket 连接（而非调用 CLI shell 命令）每隔约 60 秒以及按需调用 Gateway 网关的 health RPC。该 RPC 加载凭据并报告状态，不会发送消息。应用分别缓存最近一次正常快照和最近一次错误，因此 UI 可以立即加载，且离线时不会闪烁。

如有疑问

使用 Gateway 健康 中的 CLI 流程（openclaw status、openclaw status --deep、openclaw health --json），并持续查看 /tmp/openclaw/openclaw-*.log，筛选 web-heartbeat / web-reconnect。

相关内容

• Gateway 健康
• macOS 应用