メインコンテンツへスキップ

​
デバッグ

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

​
実行時デバッグ上書き

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