Перейти до основного вмісту

​
Налагодження

Ця сторінка описує допоміжні засоби налагодження для потокового виводу, особливо коли провайдер змішує міркування зі звичайним текстом.

​
Перевизначення налагодження під час виконання

Використовуйте /debug у чаті, щоб задавати перевизначення конфігурації лише на час виконання (у пам’яті, не на диску). /debug вимкнено за замовчуванням; увімкніть його за допомогою commands.debug: true. Це зручно, коли потрібно перемкнути маловідомі налаштування без редагування openclaw.json. Приклади: 
/debug show
/debug set messages.responsePrefix="[openclaw]"
/debug unset messages.responsePrefix
/debug reset
/debug reset очищує всі перевизначення та повертає конфігурацію з диска.

​
Режим watch для Gateway

Для швидких ітерацій запускайте gateway під наглядом засобу відстеження файлів: 
pnpm gateway:watch
Це відповідає такому: 
node scripts/watch-node.mjs gateway --force
Засіб відстеження перезапускається при змінах у важливих для збірки файлах у src/, вихідних файлах розширень, метаданих розширень package.json і openclaw.plugin.json, tsconfig.json, package.json і tsdown.config.ts. Зміни в метаданих розширень перезапускають gateway без примусового перебудування tsdown; зміни у вихідних файлах і конфігурації, як і раніше, спочатку перебудовують dist. Додайте будь-які прапорці CLI для gateway після gateway:watch, і вони передаватимуться під час кожного перезапуску. Повторний запуск тієї самої команди 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 (порти browser/canvas відповідно зміщуються)
  2. Dev bootstrap (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-середовище. Порада: якщо вже запущено gateway не в режимі dev (launchd/systemd), спочатку зупиніть його: 
openclaw gateway stop

​
Логування сирого потоку (OpenClaw)

OpenClaw може журналювати сирий потік помічника до будь-якої фільтрації/форматування. Це найкращий спосіб побачити, чи надходять міркування як звичайні текстові дельти (або як окремі блоки thinking). Увімкнення через CLI: 
pnpm gateway:watch --raw-stream
Необов’язкове перевизначення шляху: 
pnpm gateway:watch --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.

​
Примітки щодо безпеки

  • Журнали сирого потоку можуть містити повні запити, вивід інструментів і дані користувача.
  • Зберігайте журнали локально та видаляйте їх після налагодження.
  • Якщо ви ділитеся журналами, спочатку очистьте з них секрети та персональні дані.