Отладка¶

Эта страница описывает вспомогательные средства отладки для потокового вывода, особенно когда провайдер смешивает рассуждения с обычным текстом.

Переопределения отладки во время выполнения¶

Используйте /debug в чате, чтобы задать переопределения конфига только на время выполнения (в памяти, не на диске). /debug по умолчанию отключён; включите его с помощью commands.debug: true. Это удобно, когда нужно переключать редкие настройки без редактирования openclaw.json.

Примеры:

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

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

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

Для быстрой итерации запускайте Gateway (шлюз) под файловым наблюдателем:

pnpm gateway:watch --force

Это сопоставляется так:

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):

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).

Поток сброса (чистый старт):

pnpm gateway:dev:reset

Примечание: --dev — глобальный флаг профиля и некоторыми раннерами он «съедается». Если нужно указать его явно, используйте форму через переменную окружения:

OPENCLAW_PROFILE=dev openclaw gateway --dev --reset

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

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

openclaw gateway stop

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

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

Включите через CLI:

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

Необязательное переопределение пути:

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

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

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

Файл по умолчанию:

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

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

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

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

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