macOS 健康检查

如何从菜单栏应用判断关联频道是否健康。

菜单栏

• 状态点现在反映 Baileys 的健康状态：
  • 绿色：已关联 + socket 最近打开过。
  • 橙色：连接中/重试中。
  • 红色：已登出或探测失败。
• 第二行文字显示 “linked · auth 12m” 或失败原因。
• “Run Health Check” 菜单项可触发按需探测。

设置面板

• General 标签新增了一个 Health 卡片，显示：关联认证时长、session-store 路径/数量、上次检查时间、上次错误/状态码，以及 Run Health Check / Reveal Logs 按钮。
• 使用缓存快照以便 UI 瞬间加载，离线时优雅降级。
• Channels 标签 展示频道状态及 WhatsApp/Telegram 的控制选项（登录二维码、登出、探测、上次断连/错误）。

探测原理

• 应用每约 60 秒以及按需通过 ShellExecutor 运行 openclaw health --json。探测会加载凭证并上报状态，不会发送消息。
• 分别缓存最近一次正常快照和最近一次错误，避免 UI 闪烁；各自显示时间戳。

拿不准的时候

• 你始终可以用 Gateway 健康检查 中的 CLI 流程（openclaw status、openclaw status --deep、openclaw health --json），以及 tail /tmp/openclaw/openclaw-*.log 查看 web-heartbeat / web-reconnect。