ヘルスチェック

​

クイックチェック

• openclaw status - ローカル概要: Gateway の到達性/モード、更新ヒント、リンク済みチャネル認証の経過時間、セッション + 最近のアクティビティ。
• openclaw status --all - 完全なローカル診断 (読み取り専用、カラー表示、デバッグ用に貼り付けても安全)。
• openclaw status --deep - 稼働中の Gateway にライブプローブ (health with probe:true) を要求し、対応している場合はアカウント別のチャネルプローブも含めます。
• openclaw status --usage - モデルプロバイダーの使用量/クォータのスナップショットを表示します。
• openclaw health - 稼働中の Gateway にヘルススナップショットを要求します (WS のみ。CLI から直接チャネルソケットには接続しません)。
• openclaw health --verbose (alias --debug) - ライブヘルスプローブを強制し、Gateway 接続の詳細を出力します。
• openclaw health --json - 機械可読のヘルススナップショット出力。
• 任意のチャネルでスタンドアロンのチャットコマンドとして /status を送信すると、エージェントを呼び出さずにステータス返信を取得できます。
• ログ: /tmp/openclaw/openclaw-*.log を tail し、web-heartbeat、web-reconnect、web-auto-reply、web-inbound でフィルターします。

​

詳細診断

• ディスク上の認証情報: ls -l ~/.openclaw/credentials/whatsapp/<accountId>/creds.json (mtime は最近であるべきです)。
• セッションストア: ls -l ~/.openclaw/agents/<agentId>/sessions/sessions.json (パスは config で上書きできます)。件数と最近の受信者は status 経由で表示されます。
• 再リンクフロー: ステータスコード 409-515 または loggedOut がログに表示された場合は、openclaw channels logout && openclaw channels login --verbose を実行します。QR ログインフローは、ペアリング後のステータス 515 に対して一度だけ自動再起動します。
• 診断はデフォルトで有効です (diagnostics.enabled: false で無効化)。メモリイベントは RSS/ヒープのバイト数としきい値/増加圧力を記録します。重大なメモリ圧力は Gateway ロガー経由で記録され、diagnostics.memoryPressureSnapshot: true が設定されている場合は、OOM 前の安定性バンドル (V8 ヒープ統計、利用可能な場合は Linux cgroup カウンター、アクティブリソース数、リダクション済み相対パスごとの最大セッション/トランスクリプトファイル) も書き込みます。生存性警告は、プロセスは実行中だが飽和している場合に、イベントループ遅延/使用率、CPU コア比率、アクティブ/待機中/キュー済みセッション数を記録します。過大ペイロードイベントは、拒否/切り詰め/チャンク化された内容とサイズおよび制限を記録しますが、メッセージ本文、添付ファイル内容、Webhook 本文、生のリクエスト/レスポンス本文、トークン、Cookie、シークレット値は記録しません。
• 同じ Heartbeat が、境界付き安定性レコーダーを駆動します: openclaw gateway stability (または diagnostics.stability Gateway RPC)。致命的な Gateway 終了、シャットダウンタイムアウト、再起動時の起動失敗、および (diagnostics.memoryPressureSnapshot: true の場合) 重大なメモリ圧力は、最新スナップショットを ~/.openclaw/logs/stability/ に永続化します。最新バンドルは openclaw gateway stability --bundle latest で確認します。
• バグ報告では、openclaw gateway diagnostics export を実行し、生成された zip を添付してください。これには Markdown サマリー、最新の安定性バンドル、サニタイズ済みログメタデータ、サニタイズ済み Gateway ステータス/ヘルススナップショット、config 形状が含まれます。チャット本文、Webhook 本文、ツール出力、認証情報、Cookie、アカウント/メッセージ識別子、シークレット値は省略またはリダクションされます。診断エクスポートを参照してください。

​

ヘルスモニター config

• gateway.channelHealthCheckMinutes: Gateway がチャネルヘルスをチェックする頻度。デフォルト: 5。ヘルスモニターによる再起動をグローバルに無効化するには 0 を設定します。
• gateway.channelStaleEventThresholdMinutes: 接続済みチャネルがアイドル状態のまま、ヘルスモニターに古いと見なされ再起動されるまでの時間。デフォルト: 30。これは gateway.channelHealthCheckMinutes 以上にしてください。
• gateway.channelMaxRestartsPerHour: チャネル/アカウントごとのヘルスモニター再起動のローリング 1 時間上限。デフォルト: 10。
• channels.<provider>.healthMonitor.enabled: グローバル監視は有効のまま、特定チャネルのヘルスモニター再起動を無効化します。
• channels.<provider>.accounts.<accountId>.healthMonitor.enabled: チャネルレベル設定より優先されるマルチアカウントの上書き。
• これらのチャネル別上書きは、現在それを公開している組み込みチャネルに適用されます: Discord、Google Chat、iMessage、IRC、Microsoft Teams、Signal、Slack、Telegram、WhatsApp。

​

稼働時間監視

• 使用する: GET /health - 即時応答、セッション作成なし、LLM 呼び出しなし、{"ok":true,"status":"live"} を返します
• 使用しない: ヘルスチェックに /v1/chat/completions を使用 - 各リクエストが、スキルスナップショット、コンテキスト組み立て、LLM 呼び出しを伴う完全なエージェントセッションを作成します

​

監視サービス設定例

• BetterStack: ヘルスチェック URL を https://<your-gateway-host>:<port>/health に設定します
• UptimeRobot: URL https://<your-gateway-host>:<port>/health で新しい HTTP モニターを追加します
• 汎用: Gateway が正常な場合、/health への任意の HTTP GET は {"ok":true} とともに 200 を返します

​

何かが失敗した場合

• 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」コマンド

• --json: 機械可読の JSON 出力
• --timeout <ms>: デフォルトの 10s プローブタイムアウトを上書き
• --verbose: ライブプローブを強制し、Gateway 接続の詳細を出力
• --debug: --verbose のエイリアス

​

関連

• Gateway ランブック
• 診断エクスポート
• Gateway トラブルシューティング