デバッグ¶

このページでは、ストリーミング出力のためのデバッグ補助について説明します。特に、プロバイダーが推論を通常のテキストに混在させる場合を対象としています。

実行時デバッグ上書き¶

チャットで /debug を使用して、ランタイムのみ 設定を上書きします（メモリ、ディスクではありません）。 /debug はデフォルトで無効になっています。commands.debug: true で有効にしてください。 openclaw.json を編集せずに、あいまいな設定を切り替える必要がある場合に便利です。

例:

/debug show
/debug set messages.responsePrefix="[openclaw]"
/debug unset messages.responsePrefix
/debug reset

/debug reset はすべての上書きをクリアし、オンディスクの設定に戻します。

Gateway のウォッチモード¶

高速な反復作業のために、ファイルウォッチャー配下でゲートウェイを実行します。

pnpm gateway:watch --force

これは次にマップされます。

tsx watch src/entry.ts gateway --force

gateway:watch の後ろに任意の gateway CLI フラグを追加すると、再起動のたびにそれらが引き渡されます。

Dev プロファイル + dev ゲートウェイ（--dev）¶

開発者プロファイルを使用して状態を分離し、 デバッグ用の安全で使い捨てのセットアップを実行します。 2つ --devフラグがあります。

• グローバル --dev（プロファイル）: 状態を ~/.openclaw-dev 配下に分離し、ゲートウェイのポートをデフォルトで 19001 に設定します（派生ポートもそれに合わせてシフトします）。
• gateway --dev: Gateway（ゲートウェイ）に対し、存在しない場合にデフォルトの設定 + ワークスペースを自動作成し（BOOTSTRAP.md をスキップ）、起動するよう指示します。

推奨フロー（dev プロファイル + dev ブートストラップ）:

pnpm gateway:dev
OPENCLAW_PROFILE=dev openclaw tui

まだグローバルインストールがない場合は、pnpm openclaw ... 経由で CLI を実行してください。

これが何をするか:

1. プロファイルの分離（グローバル --dev） - OPENCLAW_PROFILE=dev - OPENCLAW_STATE_DIR=~/.openclaw-dev - OPENCLAW_CONFIG_PATH=~/.openclaw-dev/openclaw.json - OPENCLAW_GATEWAY_PORT=19001（ブラウザー／キャンバスもそれに応じてシフト）

2. Dev ブートストラップ（gateway --dev） - 存在しない場合に最小構成の設定を書き込みます（gateway.mode=local、loopback にバインド）。 - agent.workspace を dev ワークスペースに設定します。 - agent.skipBootstrap=true を設定します（BOOTSTRAP.md なし）。 - 存在しない場合にワークスペースファイルをシードします: AGENTS.md, SOUL.md, TOOLS.md, IDENTITY.md, USER.md, HEARTBEAT.md。 - デフォルトのアイデンティティ: C3‑PO（プロトコル・ドロイド）。 - dev モードではチャンネルプロバイダーをスキップします（OPENCLAW_SKIP_CHANNELS=1）。

リセットフロー（クリーンスタート）:

pnpm gateway:dev:reset

注記: --dev は グローバル なプロファイルフラグであり、一部のランナーでは消費されてしまいます。 明示的に指定する必要がある場合は、環境変数形式を使用してください。 スペルが必要な場合は、env var フォームを使用してください。

OPENCLAW_PROFILE=dev openclaw gateway --dev --reset

--reset は、設定、認証情報、セッション、および dev ワークスペースを消去し（rm ではなく trash を使用）、その後にデフォルトの dev セットアップを再作成します。

ヒント: すでに非 dev のゲートウェイが稼働している場合（launchd/systemd）、先に停止してください。

openclaw gateway stop

Raw stream logging（OpenClaw）¶

OpenClawは、フィルタリング/フォーマットの前にrawアシスタントストリームをログに記録できます。 これは、推論がプレーンテキストのデルタ (または別々の思考ブロックとして) として到着しているかどうかを確認する最良の方法です。

CLI で有効化します。

pnpm gateway:watch --force --raw-stream

任意のパス上書き:

pnpm gateway:watch --force --raw-stream --raw-stream-path ~/.openclaw/logs/raw-stream.jsonl

等価Env vars:

OPENCLAW_RAW_STREAM=1
OPENCLAW_RAW_STREAM_PATH=~/.openclaw/logs/raw-stream.jsonl

デフォルトのファイル:

~/.openclaw/logs/raw-stream.jsonl

Raw chunk logging（pi-mono）¶

ブロックにパースされる前の 生の OpenAI 互換チャンク を取得するために、 pi-mono は別個のロガーを提供します。

PI_RAW_STREAM=1

任意のパス:

PI_RAW_STREAM_PATH=~/.pi-mono/logs/raw-openai-completions.jsonl

デフォルトのファイル:

~/.pi-mono/logs/raw-openai-completions.jsonl

注記: これは pi-mono の openai-completions プロバイダーを使用しているプロセスのみで出力されます。

安全性に関する注意¶

• Raw ストリームのログには、完全なプロンプト、ツール出力、ユーザーデータが含まれる場合があります。
• ログはローカルに保持し、デバッグ後は削除してください。
• ログを共有する場合は、事前にシークレットや個人情報（PII）を必ずマスキングしてください。