Gateway
ヘルスチェック
接続状態を推測せずにチャネル接続性を確認するための短いガイド。
クイックチェック
openclaw status— ローカル要約: Gateway の到達性/モード、更新ヒント、リンク済みチャネル認証の経過時間、セッション + 最近のアクティビティ。openclaw status --all— 完全なローカル診断（読み取り専用、色付き、デバッグ用に貼り付けても安全）。openclaw status --deep— 実行中の Gateway にライブヘルスプローブ（probe:true付きのhealth）を要求し、対応している場合はアカウントごとのチャネルプローブも含めます。openclaw health— 実行中の Gateway にヘルススナップショットを要求します（WS のみ。CLI から直接チャネルソケットには接続しません）。openclaw health --verbose— ライブヘルスプローブを強制し、Gateway 接続の詳細を出力します。openclaw health --json— 機械可読なヘルススナップショット出力。- WhatsApp/WebChat で
/statusを単独メッセージとして送信すると、エージェントを起動せずにステータス返信を取得できます。 - ログ:
/tmp/openclaw/openclaw-*.logを tail し、web-heartbeat、web-reconnect、web-auto-reply、web-inboundでフィルターします。
Discord やその他のチャットプロバイダーでは、セッション行はソケットの生存性ではありません。
openclaw sessions、Gateway sessions.list、エージェントの sessions_list ツールは、保存された会話状態を読み取ります。
プロバイダーは、再接続して正常なチャネルステータスを表示していても、新しいセッション行がまだ作成されていない場合があります。
ライブ接続性チェックには、上記のチャネルステータスとヘルスコマンドを使用してください。
詳細診断
- ディスク上の認証情報:
ls -l ~/.openclaw/credentials/whatsapp/<accountId>/creds.json（mtime は最近である必要があります）。 - セッションストア:
ls -l ~/.openclaw/agents/<agentId>/sessions/sessions.json（パスは設定で上書きできます）。件数と最近の受信者はstatusで表示されます。 - 再リンクフロー: ステータスコード 409–515 または
loggedOutがログに表示される場合は、openclaw channels logout && openclaw channels login --verboseを実行します。（注: QR ログインフローは、ペアリング後のステータス 515 に対して一度だけ自動再起動します。） - 診断はデフォルトで有効です。
diagnostics.enabled: falseが設定されていない限り、Gateway は運用上の事実を記録します。メモリーイベントは RSS/ヒープのバイト数、しきい値プレッシャー、増加プレッシャーを記録します。生存性警告は、プロセスが実行中だが飽和している場合に、イベントループ遅延、イベントループ使用率、CPU コア比、アクティブ/待機中/キュー済みセッション数を記録します。過大ペイロードイベントは、拒否、切り詰め、またはチャンク化された内容に加え、利用可能な場合はサイズと制限を記録します。メッセージ本文、添付ファイルの内容、webhook 本文、生のリクエストまたはレスポンス本文、トークン、Cookie、秘密値は記録しません。同じ Heartbeat が境界付き安定性レコーダーを開始し、これはopenclaw gateway stabilityまたはdiagnostics.stabilityGateway RPC から利用できます。致命的な Gateway 終了、シャットダウンタイムアウト、再起動時の起動失敗は、イベントが存在する場合、最新のレコーダースナップショットを~/.openclaw/logs/stability/配下に永続化します。最新の保存済みバンドルを確認するには、openclaw gateway stability --bundle latestを使用してください。 - バグ報告では、
openclaw gateway diagnostics exportを実行し、生成された zip を添付してください。このエクスポートは、Markdown 要約、最新の安定性バンドル、サニタイズ済みログメタデータ、サニタイズ済み Gateway ステータス/ヘルススナップショット、設定形状をまとめます。共有を意図したものです。チャットテキスト、webhook 本文、ツール出力、認証情報、Cookie、アカウント/メッセージ識別子、秘密値は省略またはマスクされます。診断エクスポートを参照してください。
ヘルスモニター設定
gateway.channelHealthCheckMinutes: Gateway がチャネルヘルスをチェックする頻度。デフォルト:5。ヘルスモニターによる再起動をグローバルに無効化するには0を設定します。gateway.channelStaleEventThresholdMinutes: 接続済みチャネルがアイドル状態のままでいられる時間。この時間を超えると、ヘルスモニターはチャネルを stale とみなして再起動します。デフォルト:30。これはgateway.channelHealthCheckMinutes以上にしてください。gateway.channelMaxRestartsPerHour: チャネル/アカウントごとのヘルスモニター再起動について、ローリング 1 時間の上限。デフォルト:10。channels.<provider>.healthMonitor.enabled: グローバル監視は有効のまま、特定チャネルのヘルスモニター再起動を無効化します。channels.<provider>.accounts.<accountId>.healthMonitor.enabled: チャネルレベル設定より優先されるマルチアカウント上書き。- これらのチャネルごとの上書きは、現在それらを公開している組み込みチャネルモニターに適用されます: Discord、Google Chat、iMessage、Microsoft Teams、Signal、Slack、Telegram、WhatsApp。
何かが失敗した場合
logged outまたはステータス 409–515 →openclaw channels logoutの後にopenclaw channels loginで再リンクします。- Gateway に到達できない → 起動します:
openclaw gateway --port 18789（ポートが使用中の場合は--forceを使用）。 - 受信メッセージがない → リンク済みの電話がオンラインであり、送信者が許可されていることを確認します（
channels.whatsapp.allowFrom）。グループチャットでは、許可リスト + メンションルールが一致していることを確認します（channels.whatsapp.groups、agents.list[].groupChat.mentionPatterns）。
専用の「health」コマンド
openclaw health は、実行中の Gateway にヘルススナップショットを要求します（CLI から直接チャネルソケットには接続しません）。
デフォルトでは、新しいキャッシュ済み Gateway スナップショットを返すことがあります。その後、Gateway はバックグラウンドでそのキャッシュを更新します。
openclaw health --verbose は代わりにライブプローブを強制します。このコマンドは、利用可能な場合はリンク済み認証情報/認証の経過時間、チャネルごとのプローブ要約、セッションストア要約、プローブ時間を報告します。
Gateway に到達できない場合、またはプローブが失敗/タイムアウトした場合は、非ゼロで終了します。
オプション:
--json: 機械可読な JSON 出力--timeout <ms>: デフォルトの 10 秒プローブタイムアウトを上書き--verbose: ライブプローブを強制し、Gateway 接続の詳細を出力--debug:--verboseのエイリアス
ヘルススナップショットには、ok（真偽値）、ts（タイムスタンプ）、durationMs（プローブ時間）、チャネルごとのステータス、エージェントの可用性、セッションストア要約が含まれます。