Debugowanie¶

Ta strona opisuje narzędzia pomocnicze do debugowania strumieniowego wyjścia, zwłaszcza gdy dostawca miesza rozumowanie z normalnym tekstem.

Nadpisania debugowania w czasie działania¶

Użyj /debug na czacie, aby ustawić nadpisania konfiguracji tylko w czasie działania (pamięć, nie dysk). /debug jest domyślnie wyłączone; włącz je za pomocą commands.debug: true. Jest to przydatne, gdy musisz przełączyć mało oczywiste ustawienia bez edytowania openclaw.json.

Przykłady:

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

/debug reset czyści wszystkie nadpisania i przywraca konfigurację zapisaną na dysku.

Tryb watch Gateway¶

Do szybkiej iteracji uruchom gateway pod nadzorem obserwatora plików:

pnpm gateway:watch --force

Mapuje się to na:

tsx watch src/entry.ts gateway --force

Dodaj dowolne flagi CLI gateway po gateway:watch, a zostaną one przekazane przy każdym restarcie.

Profil dev + gateway dev (--dev)¶

Użyj profilu dev, aby odizolować stan i uruchomić bezpieczne, jednorazowe środowisko do debugowania. Istnieją dwie flagi --dev:

• Globalna --dev (profil): izoluje stan w ~/.openclaw-dev i domyślnie ustawia port gateway na 19001 (porty pochodne przesuwają się wraz z nim).
• gateway --dev: informuje Gateway, aby automatycznie utworzyć domyślną konfigurację + obszar roboczy, gdy ich brakuje (i pominąć BOOTSTRAP.md).

Zalecany przebieg (profil dev + bootstrap dev):

pnpm gateway:dev
OPENCLAW_PROFILE=dev openclaw tui

Jeśli nie masz jeszcze instalacji globalnej, uruchom CLI przez pnpm openclaw ....

Co to robi:

1. Izolacja profilu (globalne --dev) - OPENCLAW_PROFILE=dev - OPENCLAW_STATE_DIR=~/.openclaw-dev - OPENCLAW_CONFIG_PATH=~/.openclaw-dev/openclaw.json - OPENCLAW_GATEWAY_PORT=19001 (przeglądarka/canvas przesuwają się odpowiednio)

2. Bootstrap dev (gateway --dev) - Zapisuje minimalną konfigurację, jeśli jej brakuje (gateway.mode=local, powiązanie z loopback). - Ustawia agent.workspace na obszar roboczy dev. - Ustawia agent.skipBootstrap=true (bez BOOTSTRAP.md). - Zasiewa pliki obszaru roboczego, jeśli ich brakuje: AGENTS.md, SOUL.md, TOOLS.md, IDENTITY.md, USER.md, HEARTBEAT.md. - Domyślna tożsamość: C3‑PO (droid protokolarny). - Pomija dostawców kanałów w trybie dev (OPENCLAW_SKIP_CHANNELS=1).

Przebieg resetowania (świeży start):

pnpm gateway:dev:reset

Uwaga: --dev jest globalną flagą profilu i bywa przechwytywana przez niektóre narzędzia uruchomieniowe. Jeśli musisz zapisać ją jawnie, użyj formy zmiennej środowiskowej:

OPENCLAW_PROFILE=dev openclaw gateway --dev --reset

--reset usuwa konfigurację, poświadczenia, sesje oraz obszar roboczy dev (używając trash, a nie rm), a następnie odtwarza domyślną konfigurację dev.

Wskazówka: jeśli niedeweloperski gateway jest już uruchomiony (launchd/systemd), najpierw go zatrzymaj:

openclaw gateway stop

Logowanie surowego strumienia (OpenClaw)¶

OpenClaw może rejestrować surowy strumień asystenta przed jakimkolwiek filtrowaniem/formatowaniem. To najlepszy sposób, aby sprawdzić, czy rozumowanie dociera jako zwykłe delty tekstowe (czy jako osobne bloki myślenia).

Włącz przez CLI:

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

Opcjonalne nadpisanie ścieżki:

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

Równoważny env vars:

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

Plik domyślny:

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

Logowanie surowych fragmentów (pi-mono)¶

Aby przechwycić surowe fragmenty zgodne z OpenAI zanim zostaną sparsowane do bloków, pi-mono udostępnia osobny logger:

PI_RAW_STREAM=1

Opcjonalna ścieżka:

PI_RAW_STREAM_PATH=~/.pi-mono/logs/raw-openai-completions.jsonl

Plik domyślny:

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

Uwaga: jest to emitowane tylko przez procesy korzystające z dostawcy openai-completions w pi-mono.

Uwagi dotyczące bezpieczeństwa¶

• Surowe logi strumieni mogą zawierać pełne prompty, wyjście narzędzi oraz dane użytkowników.
• Przechowuj logi lokalnie i usuwaj je po zakończeniu debugowania.
• Jeśli udostępniasz logi, najpierw usuń sekrety i dane osobowe (PII).