oclaw/openclaw/docs/platforms/mac/health.md
oliver dbbe3add6a 重构主控编排与运行时预热链路,统一工作区提示词/专家调度协议并补齐 wiki 记忆注入与写回闭环。
同时收敛启动与运维脚本默认行为(含 wiki worker)、更新 Admin 可观测性与相关测试,降低首轮时延并提高运行稳定性。

Made-with: Cursor
2026-04-26 08:34:33 +08:00

1.5 KiB

summary read_when title
How the macOS app reports gateway/Baileys health states
Debugging mac app health indicators
Health Checks (macOS)

Health Checks on macOS

How to see whether the linked channel is healthy from the menu bar app.

Menu bar

  • Status dot now reflects Baileys health:
    • Green: linked + socket opened recently.
    • Orange: connecting/retrying.
    • Red: logged out or probe failed.
  • Secondary line reads "linked · auth 12m" or shows the failure reason.
  • "Run Health Check" menu item triggers an on-demand probe.

Settings

  • General tab gains a Health card showing: linked auth age, session-store path/count, last check time, last error/status code, and buttons for Run Health Check / Reveal Logs.
  • Uses a cached snapshot so the UI loads instantly and falls back gracefully when offline.
  • Channels tab surfaces channel status + controls for WhatsApp/Telegram (login QR, logout, probe, last disconnect/error).

How the probe works

  • App runs openclaw health --json via ShellExecutor every ~60s and on demand. The probe loads creds and reports status without sending messages.
  • Cache the last good snapshot and the last error separately to avoid flicker; show the timestamp of each.

When in doubt

  • You can still use the CLI flow in Gateway health (openclaw status, openclaw status --deep, openclaw health --json) and tail /tmp/openclaw/openclaw-*.log for web-heartbeat / web-reconnect.