Felsökning¶

Den här sidan beskriver felsökningshjälpmedel för strömmande utdata, särskilt när en leverantör blandar resonemang i vanlig text.

Körningsbaserade felsökningsöverskrivningar¶

Använd /debug i chatten för att sätta körtid config overrides (minne, inte disk). /debug är inaktiverat som standard; aktivera med commands.debug: true. Detta är praktiskt när du behöver växla oklara inställningar utan att redigera openclaw.json.

Exempel:

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

/debug reset rensar alla överskrivningar och återgår till konfigurationen på disk.

Gateway-bevakningsläge¶

För snabb iteration, kör gatewayen under filbevakaren:

pnpm gateway:watch --force

Detta mappar till:

tsx watch src/entry.ts gateway --force

Lägg till valfria gateway-CLI-flaggor efter gateway:watch så skickas de vidare vid varje omstart.

Dev-profil + dev-gateway (--dev)¶

Använd dev-profilen för att isolera tillståndet och snurra upp en säker, engångsinställning för felsökning. Det finns två --dev-flaggor:

• Global --dev (profil): isolerar tillstånd under ~/.openclaw-dev och sätter gateway-porten som standard till 19001 (härledda portar skiftar med den).
• gateway --dev: säger åt Gateway att automatiskt skapa en standardkonfig + arbetsyta när den saknas (och hoppa över BOOTSTRAP.md).

Rekommenderat flöde (dev-profil + dev-bootstrap):

pnpm gateway:dev
OPENCLAW_PROFILE=dev openclaw tui

Om du inte har en global installation ännu, kör CLI via pnpm openclaw ....

Vad detta gör:

1. Profilisolering (global --dev) - OPENCLAW_PROFILE=dev - OPENCLAW_STATE_DIR=~/.openclaw-dev - OPENCLAW_CONFIG_PATH=~/.openclaw-dev/openclaw.json - OPENCLAW_GATEWAY_PORT=19001 (webbläsare/canvas skiftar i enlighet med detta)

2. Dev-bootstrap (gateway --dev) - Skriver en minimal konfig om den saknas (gateway.mode=local, bind loopback). - Sätter agent.workspace till dev-arbetsytan. - Sätter agent.skipBootstrap=true (ingen BOOTSTRAP.md). - Fröar arbetsytefilerna om de saknas: AGENTS.md, SOUL.md, TOOLS.md, IDENTITY.md, USER.md, HEARTBEAT.md. - Standardidentitet: C3‑PO (protokolldroid). - Hoppar över kanal-leverantörer i dev-läge (OPENCLAW_SKIP_CHANNELS=1).

Återställningsflöde (nystart):

pnpm gateway:dev:reset

Obs: --dev är en global profilflagga och äts av vissa löpare. Om du behöver stava ut, använd env var form:

OPENCLAW_PROFILE=dev openclaw gateway --dev --reset

--reset rensar konfig, autentiseringsuppgifter, sessioner och dev-arbetsytan (med trash, inte rm), och återskapar därefter standard-setupen för dev.

Tips: om en icke-dev-gateway redan körs (launchd/systemd), stoppa den först:

openclaw gateway stop

Loggning av rå ström (OpenClaw)¶

OpenClaw kan logga rå assistentström före filtrering/formatering. Detta är det bästa sättet att se om resonemanget kommer som ren text deltas (eller som separata tankeblock).

Aktivera via CLI:

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

Valfri sökvägsöverskrivning:

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

Motsvarande miljövariabler:

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

Standardfil:

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

Loggning av råa chunkar (pi-mono)¶

För att fånga råa OpenAI-kompatibla chunkar innan de parsas till block, exponerar pi-mono en separat logger:

PI_RAW_STREAM=1

Valfri sökväg:

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

Standardfil:

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

Obs: detta emitteras endast av processer som använder pi-monos openai-completions-leverantör.

Säkerhetsnoteringar¶

• Råa strömloggar kan innehålla fullständiga prompter, verktygsutdata och användardata.
• Behåll loggar lokalt och radera dem efter felsökning.
• Om du delar loggar, rensa hemligheter och personuppgifter (PII) först.