> ## Documentation Index
> Fetch the complete documentation index at: https://openclaw.veiseule.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# デバッグ

# デバッグ

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

## 実行時デバッグ上書き

チャットで `/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 のウォッチモード

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

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
pnpm gateway:watch --force
```

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

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
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 ブートストラップ）:

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
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`）。

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

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
pnpm gateway:dev:reset
```

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

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
OPENCLAW_PROFILE=dev openclaw gateway --dev --reset
```

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

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

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw gateway stop
```

## Raw stream logging（OpenClaw）

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

CLI で有効化します。

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
pnpm gateway:watch --force --raw-stream
```

任意のパス上書き:

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
pnpm gateway:watch --force --raw-stream --raw-stream-path ~/.openclaw/logs/raw-stream.jsonl
```

等価Env vars:

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
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 は別個のロガーを提供します。

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
PI_RAW_STREAM=1
```

任意のパス:

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
PI_RAW_STREAM_PATH=~/.pi-mono/logs/raw-openai-completions.jsonl
```

デフォルトのファイル:

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

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

## 安全性に関する注意

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