macOS のヘルスチェック

メニューバーアプリで、リンク済みチャネルのヘルス状態を確認する方法です。

メニューバー

ステータスドット：

• 緑：リンク済みで、プローブは正常です。
• オレンジ：リンク済みですが、チャネルプローブが機能低下または未接続を報告しています。
• 赤：まだリンクされていません。

2 行目には「リンク済み · 認証 12 分前」と表示されるか、失敗の理由が表示されます。 メニューの「今すぐヘルスチェックを実行」を選択すると、オンデマンドのプローブが実行されます。

設定

• 「一般」タブにはヘルスカードが表示されます。ステータスドット、概要行（リンク状態 + 認証からの経過時間）、任意の失敗詳細行、および 今すぐ再試行 と ログを開く ボタンが含まれます。
• チャネルタブには、WhatsApp と Telegram のチャネルごとの状態と操作（ログイン用 QR コード、 ログアウト、プローブ、最後の切断／エラー）が表示されます。

プローブの仕組み

アプリは、既存の WebSocket 接続を介して Gateway の health RPC を 約 60 秒ごと、およびオンデマンドで呼び出します（CLI のシェルアウトは使用しません）。RPC は 認証情報を読み込み、メッセージを送信せずに状態を報告します。アプリは直近の 正常なスナップショットと直近のエラーを個別にキャッシュするため、UI は即座に読み込まれ、 オフライン中もちらつきません。

判断に迷う場合

Gateway のヘルスに記載されている CLI の手順（openclaw status、 openclaw status --deep、openclaw health --json）を使用し、 /tmp/openclaw/openclaw-*.log を追跡して、web-heartbeat / web-reconnect で絞り込んでください。

関連項目

• Gateway のヘルス
• macOS アプリ