​

macOS의 Health Checks

​

Menu bar

• status dot은 Baileys health를 반영합니다.
  • 초록: linked 상태이며 socket이 최근에 열림
  • 주황: 연결 중 또는 재시도 중
  • 빨강: logged out 상태이거나 probe 실패
• 보조 줄에는 "linked · auth 12m" 같은 문구 또는 실패 이유가 표시됩니다.
• "Run Health Check" 메뉴 항목은 on-demand probe를 실행합니다.

​

Settings

• General tab에는 Health card가 추가되어 linked auth age, session-store path/count, last check time, last error/status code, 그리고 Run Health Check / Reveal Logs 버튼을 보여 줍니다.
• UI는 즉시 열리도록 cached snapshot을 사용하며, offline일 때도 자연스럽게 fallback합니다.
• Channels tab에서는 WhatsApp/Telegram channel status와 control(login QR, logout, probe, last disconnect/error)을 제공합니다.

​

How the probe works

• app은 ShellExecutor를 통해 약 60초마다, 그리고 요청 시 openclaw health --json을 실행합니다. 이 probe는 메시지를 보내지 않고 credential을 읽어 상태만 보고합니다.
• flicker를 피하기 위해 마지막 성공 snapshot과 마지막 error를 따로 cache하고, 각각의 timestamp를 표시합니다.

​

When in doubt

• 여전히 Gateway health의 CLI 흐름(openclaw status, openclaw status --deep, openclaw health --json)을 사용할 수 있습니다.
• web-heartbeat와 web-reconnect를 보기 위해 /tmp/openclaw/openclaw-*.log를 tail해도 됩니다.