ログ記録

• Gateway が書き込む ファイルログ（JSON lines）。
• Gateway を実行しているターミナルの コンソール出力。

​

ログの保存場所

{
  "logging": {
    "file": "/path/to/openclaw.log"
  }
}

​

ログの読み方

​

CLI: ライブ追尾（推奨）

openclaw logs --follow

• TTY セッション: 見やすく色付きの構造化ログ行。
• 非 TTY セッション: プレーンテキスト。

• meta: ストリームメタデータ（file、source、sourceKind、service、cursor、size）
• log: パース済みログエントリ
• notice: 切り詰め / ローテーションのヒント
• raw: 未パースのログ行
• error: Gateway 接続失敗（stderr に書き込み）

openclaw doctor

​

Control UI（Web）

​

チャンネル専用ログ

openclaw channels logs --channel whatsapp

​

ログ形式

​

ファイルログ（JSONL）

• hostname: Gateway ホスト名。
• message: 全文検索用に平坦化されたログメッセージテキスト。
• agent_id: ログ呼び出しがエージェントコンテキストを持つ場合のアクティブなエージェント ID。
• session_id: ログ呼び出しがセッションコンテキストを持つ場合のアクティブなセッション ID/キー。
• channel: ログ呼び出しがチャンネルコンテキストを持つ場合のアクティブなチャンネル。

​

コンソール出力

• サブシステム接頭辞（例: gateway/channels/whatsapp）
• レベルの色分け（info/warn/error）
• オプションのコンパクトモードまたは JSON モード

​

Gateway WebSocket ログ

• 通常モード: 注目すべき結果のみ（エラー、パースエラー、遅い呼び出し）
• --verbose: すべてのリクエスト/レスポンストラフィック
• --ws-log auto|compact|full: verbose 表示スタイルを選択
• --compact: --ws-log compact のエイリアス

openclaw gateway
openclaw gateway --verbose --ws-log compact
openclaw gateway --verbose --ws-log full

​

ログの設定

{
  "logging": {
    "level": "info",
    "file": "/tmp/openclaw/openclaw-YYYY-MM-DD.log",
    "consoleLevel": "info",
    "consoleStyle": "pretty",
    "redactSensitive": "tools",
    "redactPatterns": ["sk-.*"]
  }
}

​

ログレベル

• logging.level: ファイルログ（JSONL）のレベル（デフォルト: info）。
• logging.consoleLevel: コンソールの詳細度レベル。

​

対象を絞ったモデルトランスポート診断

OPENCLAW_DEBUG_MODEL_TRANSPORT=1 openclaw gateway
OPENCLAW_DEBUG_MODEL_PAYLOAD=tools OPENCLAW_DEBUG_SSE=events openclaw gateway

• OPENCLAW_DEBUG_MODEL_TRANSPORT=1: リクエスト開始、fetch レスポンス、SDK ヘッダー、最初のストリーミングイベント、ストリーム完了、トランスポートエラーを info レベルで出力します。
• OPENCLAW_DEBUG_MODEL_PAYLOAD=summary: モデルリクエストログに境界付きのリクエストペイロード要約を含めます。
• OPENCLAW_DEBUG_MODEL_PAYLOAD=tools: ペイロード要約に、モデル向けのすべてのツール名を含めます。
• OPENCLAW_DEBUG_MODEL_PAYLOAD=full-redacted: 編集済みで上限付きの JSON ペイロードスナップショットを含めます。デバッグ中にのみ使用してください。シークレットは編集されますが、 プロンプトやメッセージテキストがまだ含まれる場合があります。
• OPENCLAW_DEBUG_SSE=events: 最初のイベントとストリーム完了のタイミングを出力します。
• OPENCLAW_DEBUG_SSE=peek: 最初の 5 件の編集済み SSE イベントペイロードも出力します。 イベントごとに上限があります。
• OPENCLAW_DEBUG_CODE_MODE=1: ネイティブプロバイダーツールがコードモードによってツールサーフェスを所有しているために隠された場合を含め、 コードモードのモデルサーフェス診断を出力します。

​

トレース相関

​

モデル呼び出しのサイズとタイミング

• requestPayloadBytes: 最終的なモデルリクエストペイロードの UTF-8 バイトサイズ
• responseStreamBytes: ストリーミングされたモデルレスポンスチャンクペイロードの UTF-8 バイトサイズ。 高頻度のテキスト、思考、ツール呼び出し delta イベントは、完全な partial スナップショットではなく、 増分の delta バイトのみをカウントします。
• timeToFirstByteMs: 最初のストリーミングレスポンスイベントまでの経過時間
• durationMs: モデル呼び出しの合計時間

​

コンソールスタイル

• pretty: 人間に読みやすく、色付きで、タイムスタンプ付き。
• compact: より詰めた出力（長いセッションに最適）。
• json: 1 行に 1 JSON（ログプロセッサー向け）。

​

編集

• logging.redactSensitive: off | tools（デフォルト: tools）
• logging.redactPatterns: ログ/トランスクリプト出力用のデフォルトセットを置き換える regex 文字列のリスト。Control UI ツールペイロードでは、カスタムパターンは組み込みデフォルトの上に適用されるため、パターンを追加しても、デフォルトですでに捕捉される値の編集が弱まることはありません。

​

診断と OpenTelemetry

• OpenTelemetry エクスポート — OTLP/HTTP 経由で、任意の OpenTelemetry 互換コレクターまたはバックエンド（Datadog、Grafana、Honeycomb、New Relic、Tempo など）へメトリクス、トレース、ログを送信します。完全な設定、シグナルカタログ、メトリクス/span 名、env var、プライバシーモデルは専用ページにあります: OpenTelemetry エクスポート。
• 診断フラグ — logging.level を上げずに追加ログを logging.file にルーティングする、対象を絞ったデバッグログフラグです。フラグは大文字と小文字を区別せず、ワイルドカード（telegram.*、*）をサポートします。diagnostics.flags の下、または OPENCLAW_DIAGNOSTICS=... env オーバーライド経由で設定します。完全なガイド: 診断フラグ。

​

トラブルシューティングのヒント

• Gateway に到達できませんか？ まず openclaw doctor を実行してください。
• ログが空ですか？ Gateway が実行中で、logging.file のファイルパスに書き込んでいることを確認してください。
• さらに詳細が必要ですか？ logging.level を debug または trace に設定して再試行してください。

​

関連

• OpenTelemetry エクスポート — OTLP/HTTP エクスポート、メトリクス/span カタログ、プライバシーモデル
• 診断フラグ — 対象を絞ったデバッグログフラグ
• Gateway ログ内部構造 — WS ログスタイル、サブシステムプレフィックス、コンソールキャプチャ
• 設定リファレンス — 完全な diagnostics.* フィールドリファレンス