Skip to content

macOS 健康检查

如何在菜单栏应用中查看已连接渠道的健康状态。

菜单栏

  • 状态圆点现在反映 Baileys 健康状态:
    • 绿色:已链接 + 最近打开了 socket。
    • 橙色:连接中/重试中。
    • 红色:已登出或探测失败。
  • 次要行显示"linked · auth 12m"或失败原因。
  • "Run Health Check"菜单项触发按需探测。

Settings 界面

  • General 标签新增 Health 卡片,显示:已链接认证时间、session-store 路径/数量、上次检查时间、上次错误/状态码,以及 Run Health Check / Reveal Logs 按钮。
  • 使用缓存快照,UI 加载即时,离线时优雅降级。
  • Channels 标签显示 WhatsApp/Telegram 的渠道状态 + 控制项(登录二维码、登出、探测、上次断连/错误)。

探测工作原理

  • 应用每约 60 秒以及按需通过 ShellExecutor 运行 openclaw health --json。探测加载凭据并报告状态,不发送消息。
  • 分别缓存上一个正常快照和上一个错误,避免闪烁;显示每个的时间戳。

排查建议

  • 你仍然可以使用 Gateway 健康检查 中的 CLI 流程(openclaw statusopenclaw status --deepopenclaw health --json),并通过 tail /tmp/openclaw/openclaw-*.log 查看 web-heartbeat / web-reconnect 日志。

橙色圆点意味着龙虾在努力重连,不用慌;红色才需要去看日志排查。