ヘルスチェック

推測せずにチャンネル接続を検証するための短いガイドです。

- openclaw status — ローカル概要：Gateway の到達性/モード、更新ヒント、リンク済みチャンネルの有効期限、セッション + 最近の活動。

- openclaw status --all — 完全なローカル診断（読み取り専用、色付き、デバッグ共有に安全）。

- openclaw status --deep — 実行中の Gateway もプローブ（対応時はチャンネル別）。

- openclaw health --json — 実行中の Gateway に完全なヘルススナップショットを要求（WS のみ；Baileys の直接ソケットなし）。

- WhatsApp/WebChat では /status を単独メッセージとして送ると、エージェントを呼び出さずに状態を返します。

- ログ：/tmp/openclaw/openclaw-*.log を tail し、web-heartbeat、web-reconnect、web-auto-reply、web-inbound をフィルタ。

- ディスク上の資格情報：<code>ls -l ~/.openclaw/credentials/whatsapp/<accountId>/creds.json</code>（mtime は最近であるべき）。

- セッションストア：<code>ls -l ~/.openclaw/agents/<agentId>/sessions/sessions.json</code>（パスは設定で上書き可能）。件数や最近の宛先は <code>status</code> に表示。

- 再リンク：ログに 409–515 または openclaw channels logout && openclaw channels login --verbose が出る場合は loggedOut。（注意：ペアリング後、QR ログインは 1 回自動で再起動し、ステータス 515 になります。）

- logged out または 409–515 → openclaw channels logout の後に openclaw channels login。

- Gateway に到達できない → 起動：openclaw gateway --port 18789（ポート使用中なら --force）。

- 受信がない → 連携した端末がオンラインで送信者が許可されているか確認（channels.whatsapp.allowFrom）。グループは allowlist + mention ルール（channels.whatsapp.groups、agents.list[].groupChat.mentionPatterns）も確認。

<code>openclaw health --json</code> は実行中の Gateway にヘルススナップショットを要求します（CLI からの直接チャンネルソケットなし）。リンク済み資格情報の有効期限（利用可能な場合）、チャンネル別プローブ概要、セッションストア概要、プローブ時間を報告します。Gateway に到達できない/プローブ失敗/タイムアウトの場合は非ゼロ終了します。デフォルト 10 秒は <code>--timeout <ms>'</code> で上書きできます。