ログ
ログ出力の設計、ファイルログ、WS ログの形式、コンソールの整形。
ユーザー向けの概要（CLI + コントロール UI + 設定）については、''/logging'' を参照してください。
OpenClaw には 2 つのログ"表面"があります：
- コンソール出力（ターミナル/デバッグ UI で見えるもの）。
- ゲートウェイロガーが書き込むファイルログ（JSON 行）。
ファイルベースのロガー
- デフォルトのローリングログファイルは ''/tmp/openclaw/'' の下にあります（1 日 1 ファイル）：''openclaw-YYYY-MM-DD.log''
- 日付はゲートウェイホストのローカルタイムゾーンを使用します。
- ログファイルのパスとレベルは ''~/.openclaw/openclaw.json'' で設定できます：
- ''logging.file''
- ''logging.level''
ファイル形式は 1 行 1 JSON オブジェクトです。
"コントロール UI ログ"タブは、ゲートウェイ (''logs.tail'') を通じてこのファイルを追跡します。
CLI も同じことができます：
openclaw logs --follow
詳細とログレベル
- ''ファイルログ''は ''logging.level'' でのみ制御されます。
- ''--verbose'' は''コンソールの詳細度''（と WS ログスタイル）のみに影響します；ファイルログレベルは''上げません''。
raise the file log level.
''trace''.
To capture verbose-only details in file logs, set ''logging.level'' to ''debug'' or
コンソールキャプチャ
The file format is one JSON object per line.
The Control UI Logs tab tails this file via the gateway (''logs.tail'').
コンソールの詳細度は以下で独立して調整できます：
- ''logging.consoleLevel''（デフォルト ''info''）
- ''logging.consoleStyle'' (''pretty'' | ''compact'' | ''json'')
ツールサマリーの編集
詳細なツールサマリー（例： ''console.log/info/warn/error/debug/trace''）は、機密トークンが宛先に到達する前に編集できます。
コンソールストリームのみ。これはツールのみであり、ファイルログは変更しません。
- ''logging.consoleLevel'' (default ''info'')
- ''logging.consoleStyle'' (''pretty'' | ''compact'' | ''json'')
- カスタムフラグが必要な場合は、生の正規表現文字列を使用します（自動 ''gi''）または ''/pattern/flags''。
- 一致を、最初の 6 + 最後の 4 文字を保持して編集します（長さ >= 18）、それ以外は ''***''。
- デフォルトは、一般的なキー割り当て、CLI フラグ、JSON フィールド、ベアラーヘッダー、PEM ブロック、人気のあるトークンプレフィックスをカバーします。
ゲートウェイ WebSocket ログ
Verbose tool summaries (e.g. ''🛠️ Exec: ...'') can mask sensitive tokens before they hit the console stream. This is ''tools-only'' and does not alter file logs.
- ''通常モード（''--verbose'' なし）''："興味深い"RPC 結果のみを出力します：
- ''logging.redactSensitive'': ''off'' | ''tools'' (default: ''tools'')
- 遅い呼び出し（デフォルトのしきい値：''logging.redactPatterns''）
- Use raw regex strings (auto ''gi''), or ''/pattern/flags'' if you need custom flags.
- ''詳細モード (''--verbose'')''：すべての WS 要求/応答トラフィックを出力します。
#
WS ログスタイル
The gateway prints WebSocket protocol logs in two modes:
- ''--ws-log auto''（デフォルト）：通常モード最適化；詳細モードはコンパクト出力を使用
- ''--ws-log compact''：詳細時のコンパクト出力（ペアの要求/応答）
- ''--ws-log full''：詳細時の完全なフレームごとの出力
- ''--compact''：''--ws-log compact'' のエイリアス
Examples:
openclaw gateway openclaw gateway --verbose --ws-log compact openclaw gateway --verbose --ws-log full
コンソールフォーマット（サブシステムロギング）
コンソールフォーマッターは TTY を検出し、一貫したプレフィックス行を出力します。
サブシステムロガーは出力をグループ化してスキャン可能に保ちます。
Behavior:
- 各行には''サブシステムプレフィックス''があります（例： ''[gateway]''、''[canvas]''、''[tailscale]''）
- サブシステムカラー（サブシステムごとに安定）+ レベルの色付け
- ''TTY または環境がリッチターミナルのように見える場合の色出力'' (''TERM''/''COLORTERM''/''TERM_PROGRAM'')、''NO_COLOR'' を尊重
- ''短縮されたサブシステムプレフィックス''：先頭の ''gateway/'' + ''channels/'' を削除し、最後の 2 つのセグメントを保持します（例： ''whatsapp/outbound''）
ReferenceGatewayLoggingPage.step06.item5
- ''''logRaw()'''' は QR/UX 出力用（プレフィックスなし、フォーマットなし）
- ''コンソールスタイル''（例： ''pretty | compact | json''）
- ''コンソールログレベル''はファイルログレベルと分離されています（''logging.level'' が ''debug''/''trace'' に設定されている場合、ファイルは完全な詳細を保持します）
- ''WhatsApp メッセージ本文''は ''debug'' で記録されます（''--verbose'' を使用して表示します）
これにより、既存のファイルログを安定させながら、対話型出力をスキャン可能にします。