# ログ記録

ユーザー向けの概要（CLI + Control UI + 設定）については、/logging を参照してください。

OpenClaw には 2 つのログ「サーフェス」があります。

• コンソール出力（ターミナル / Debug UI に表示されるもの）。
• ファイルログ（JSON lines）。gateway logger によって書き込まれます。

起動時に、Gateway は解決済みのデフォルトエージェントモデルを、新しいセッションに影響する モードのデフォルトとともにログに記録します。例:

agent model: openai-codex/gpt-5.5 (thinking=medium, fast=on)

thinking はデフォルトエージェント、モデル params、またはグローバルエージェントのデフォルトに由来します。 未設定の場合、起動時の概要には medium と表示されます。fast はデフォルトエージェントまたはモデルの fastMode params に由来します。

# ファイルベースのロガー

• デフォルトのローテーションログファイルは /tmp/openclaw/ 配下です（1 日 1 ファイル）: openclaw-YYYY-MM-DD.log
  • 日付には Gateway ホストのローカルタイムゾーンが使用されます。
• アクティブなログファイルは logging.maxFileBytes（デフォルト: 100 MB）でローテーションされ、 最大 5 つの番号付きアーカイブを保持し、新しいアクティブファイルへの書き込みを継続します。
• ログファイルのパスとレベルは ~/.openclaw/openclaw.json で設定できます:
  • logging.file
  • logging.level

ファイル形式は 1 行に 1 つの JSON オブジェクトです。

Talk、リアルタイム音声、managed-room のコードパスは、有界のライフサイクルレコードに共有ファイルロガーを使用します。 これらのレコードは運用デバッグと OTLP ログエクスポートを目的としています。トランスクリプトのテキスト、音声ペイロード、turn id、call id、 provider item id はログレコードにコピーされません。

Control UI の Logs タブは Gateway 経由でこのファイルを tail します（logs.tail）。 CLI でも同じことができます:

openclaw logs --follow

verbose とログレベル

• ファイルログは logging.level のみで制御されます。
• --verbose は コンソールの詳細度（および WS ログスタイル）にのみ影響します。ファイルログレベルを上げることはありません。
• verbose 限定の詳細をファイルログに取り込むには、logging.level を debug または trace に設定します。
• trace ログには、plugin tool factory の準備など、選択されたホットパスの診断用タイミング概要も含まれます。 /tools/plugin#slow-plugin-tool-setup を参照してください。

# コンソールキャプチャ

CLI は console.log/info/warn/error/debug/trace をキャプチャしてファイルログに書き込み、 stdout/stderr への出力も継続します。

コンソールの詳細度は次で個別に調整できます:

• logging.consoleLevel（デフォルト info）
• logging.consoleStyle（pretty | compact | json）

# リダクション

OpenClaw は、ログまたはトランスクリプト出力がプロセスを離れる前に機密トークンをマスクできます。 このログリダクションポリシーは、コンソール、ファイルログ、OTLP ログレコード、セッショントランスクリプトのテキストシンクに適用されます。 そのため、一致するシークレット値は、JSONL 行やメッセージがディスクに書き込まれる前にマスクされます。

• logging.redactSensitive: off | tools（デフォルト: tools）
• logging.redactPatterns: regex 文字列の配列（デフォルトを上書き）
  • 生の regex 文字列（自動 gi）、またはカスタムフラグが必要な場合は /pattern/flags を使用します。
  • 一致箇所は、最初の 6 文字 + 最後の 4 文字（長さ >= 18）を残してマスクされます。それ以外は *** です。
  • デフォルトでは、一般的なキー代入、CLI フラグ、JSON フィールド、bearer ヘッダー、PEM ブロック、よく使われるトークンプレフィックス、カード番号、CVC/CVV、共有支払いトークン、支払い認証情報などの支払い認証情報フィールド名を対象にします。

一部の安全境界では、logging.redactSensitive に関係なく常にリダクションされます。 これには、Control UI の tool-call イベント、sessions_history tool 出力、診断サポートエクスポート、provider error observations、exec approval command 表示、Gateway WebSocket protocol logs が含まれます。これらのサーフェスは追加パターンとして logging.redactPatterns を使用する場合がありますが、redactSensitive: "off" にしても 生のシークレットを出力するようにはなりません。

# Gateway WebSocket ログ

Gateway は WebSocket protocol logs を 2 つのモードで出力します:

• 通常モード（--verbose なし）: 「興味深い」RPC 結果のみを出力します:
  • エラー（ok=false）
  • 遅い呼び出し（デフォルトのしきい値: >= 50ms）
  • parse errors
• verbose モード（--verbose）: すべての WS request/response トラフィックを出力します。

# WS ログスタイル

openclaw gateway は Gateway ごとのスタイル切り替えをサポートします:

• --ws-log auto（デフォルト）: 通常モードは最適化され、verbose モードはコンパクト出力を使用します
• --ws-log compact: verbose 時にコンパクト出力（対応する request/response）を使用します
• --ws-log full: verbose 時にフレームごとの完全な出力を使用します
• --compact: --ws-log compact のエイリアス

例:

# optimized (only errors/slow)
openclaw gateway

# show all WS traffic (paired)
openclaw gateway --verbose --ws-log compact

# show all WS traffic (full meta)
openclaw gateway --verbose --ws-log full

# コンソール整形（サブシステムログ）

コンソールフォーマッターは TTY-aware で、一貫したプレフィックス付き行を出力します。 サブシステムロガーは出力をグループ化し、読み取りやすく保ちます。

動作:

• すべての行に サブシステムプレフィックス（例: [gateway]、[canvas]、[tailscale]）
• サブシステムの色（サブシステムごとに安定）とレベルの色分け
• 出力が TTY の場合、または環境が高機能ターミナルのように見える場合に色を使用（TERM/COLORTERM/TERM_PROGRAM）。NO_COLOR を尊重します
• 短縮されたサブシステムプレフィックス: 先頭の gateway/ + channels/ を削除し、最後の 2 セグメントを保持します（例: whatsapp/outbound）
• サブシステムごとのサブログガー（自動プレフィックス + 構造化フィールド { subsystem }）
• QR/UX 出力用の logRaw()（プレフィックスなし、整形なし）
• コンソールスタイル（例: pretty | compact | json）
• コンソールログレベルはファイルログレベルと別です（logging.level が debug/trace に設定されている場合、ファイルは完全な詳細を保持します）
• WhatsApp メッセージ本文は debug でログ記録されます（表示するには --verbose を使用）

これにより、既存のファイルログを安定させたまま、インタラクティブ出力を読み取りやすくします。

# 関連

• ログ記録
• OpenTelemetry export
• Diagnostics export