Files
openclaw/docs/platforms/mac/health.md
Vincent Koc 198ed08a38 docs: fix redirect chains and disambiguate duplicate titles
Redirects:
- /cron now goes directly to /automation/cron-jobs (was chaining via /cron-jobs)
- /model and /model/ now go directly to /concepts/models (was chaining via /models)

Duplicate titles disambiguated (6 of 7 - Logging is orphaned):
- Health Checks (macOS), Skills (macOS), Voice Wake (macOS), WebChat (macOS)
- General Troubleshooting (help/ vs gateway/)
- Provider Directory (providers/index vs concepts/model-providers)

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-18 00:13:25 -07:00

1.5 KiB

summary, read_when, title
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.