> ## 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 show
/debug set messages.responsePrefix="[openclaw]"
/debug unset messages.responsePrefix
/debug reset
```

`/debug reset` очищает все переопределения и возвращает конфигурацию на диске.

## Режим наблюдения Gateway (шлюз)

Для быстрой итерации запускайте 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
```

Добавьте любые флаги CLI Gateway (шлюза) после `gateway:watch`, и они будут
передаваться при каждом перезапуске.

## Профиль dev + dev Gateway (--dev)

Используйте профиль dev, чтобы изолировать состояние и развернуть безопасную, одноразовую среду
для отладки. Существуют **два** флага `--dev`:

* **Глобальный `--dev` (профиль):** изолирует состояние под `~/.openclaw-dev` и
  по умолчанию устанавливает порт Gateway (шлюза) в `19001` (производные порты сдвигаются вместе с ним).
* **`gateway --dev`: сообщает Gateway (шлюзу) автоматически создать конфиг по умолчанию +
  рабочее пространство**, если они отсутствуют (и пропустить BOOTSTRAP.md).

Рекомендуемый поток (профиль dev + dev bootstrap):

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

Если у вас ещё нет глобальной установки, запускайте CLI через `pnpm openclaw ...`.

Что это делает:

1. **Изоляция профиля** (глобальный `--dev`)
   * `OPENCLAW_PROFILE=dev`
   * `OPENCLAW_STATE_DIR=~/.openclaw-dev`
   * `OPENCLAW_CONFIG_PATH=~/.openclaw-dev/openclaw.json`
   * `OPENCLAW_GATEWAY_PORT=19001` (браузер/канвас сдвигаются соответствующим образом)

2. **Инициализация для разработки** (`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` — **глобальный** флаг профиля и некоторыми раннерами он «съедается».
Если нужно указать его явно, используйте форму через переменную окружения:

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

`--reset` очищает конфиг, учётные данные, сеансы и рабочее пространство dev (используя
`trash`, а не `rm`), затем пересоздаёт стандартную dev‑настройку.

Совет: если уже запущен не‑dev Gateway (шлюз) (launchd/systemd), сначала остановите его:

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

## Логирование сырого потока (OpenClaw)

OpenClaw может логировать **сырой поток ассистента** до любой фильтрации/форматирования.
Это лучший способ увидеть, приходят ли рассуждения как обычные текстовые дельты
(или как отдельные блоки «мышления»).

Включите через 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
```

Эквивалентные символы:

```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`

## Логирование сырых чанков (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`

> Примечание: это выводится только процессами, использующими провайдер
> `openai-completions` в pi-mono.

## Примечания по безопасности

* Логи сырых потоков могут содержать полные промпты, вывод инструментов и пользовательские данные.
* Храните логи локально и удаляйте их после отладки.
* При передаче логов предварительно удаляйте секреты и персональные данные (PII).