macOSでのヘルスチェック管理

「バックグラウンドで動いているはずのサービスが、実は止まっていた」という経験はありませんか？特に外部サービスと連携している場合、接続が切れていることに気づかず、後でエラーログを掘り返すのは非常にストレスが溜まる作業です。

いちいちターミナルを開いてコマンドを打たなくても、一目で現在の状態がわかり、問題があればすぐに気づける仕組みが理想的です。macOS メニューバーアプリを使えば、こうした接続状態の不安から解放されます。

必要なもの

• macOS メニューバーアプリ
• リンク済みのチャネル（WhatsApp または Telegram）

クイックスタート

メニューバーと設定画面を活用して、5分でヘルスチェックの運用を始めましょう。

1. メニューバーで状態を確認する

メニューバーのステータスドットを見るだけで、Baileys の健康状態がすぐにわかります。

• 緑色: チャネルがリンクされ、最近ソケットが開かれた正常な状態です。
• オレンジ色: 現在接続を試みている、または再試行中の状態です。
• 赤色（ログアウト）: ログアウトされている状態です。
• 赤色（エラー）: プローブ（疎通確認）に失敗した状態です。

ドットの横にあるセカンダリラインには、「linked · auth 12m」といった認証の経過時間や、失敗した際の原因が表示されます。

2. 詳細な情報をチェックする

より詳しい状況を知りたい場合は、Settings（設定画面）を開きます。

• General タブ: リンクされた認証の経過時間、session-store のパスとカウント、最終チェック時刻、最後のエラーコードを確認できます。「Run Health Check」ボタンで即時チェックも可能です。
• Channels タブ: WhatsApp や Telegram の個別ステータスを表示します。QRコードによるログイン、ログアウト、プローブの実行、最終切断理由の確認がここで行えます。

UIはキャッシュされたスナップショットを使用するため、オフライン時でも動作が重くなることはありません。

トラブルシューティング

表示がおかしい場合や、より深く調査したいときは CLI を使用するのがベストな方法です。

以下のコマンドをターミナルで実行して、詳細なステータスを確認してください。

openclaw status
openclaw status --deep
openclaw health --json

また、リアルタイムで何が起きているかを知るには、ログファイルを tail するのが確実です。/tmp/openclaw/openclaw-*.log を開き、web-heartbeat や web-reconnect というキーワードを探してみてください。

アプリ内部では ShellExecutor を介して openclaw health --json が約60秒ごとに実行されています。この処理はメッセージを送信せずに認証情報のみをロードするため、安全に状態を監視できます。

AI Setup Assistant

次のステップ

• Gateway health