Foutopsporing¶

Deze pagina behandelt hulpmiddelen voor het debuggen van streaming-uitvoer, vooral wanneer een provider redenering mengt met normale tekst.

Runtime debug-overschrijvingen¶

Gebruik /debug in chat om alleen-runtime config-overschrijvingen in te stellen (geheugen, niet schijf). /debug is standaard uitgeschakeld; schakel in met commands.debug: true. Dit is handig wanneer je obscure instellingen wilt toggelen zonder openclaw.json te bewerken.

Voorbeelden:

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

/debug reset wist alle overschrijvingen en keert terug naar de on-disk config.

Gateway watch-modus¶

Voor snelle iteratie, draai de Gateway onder de bestandswatcher:

pnpm gateway:watch --force

Deze kaarten naar:

tsx watch src/entry.ts gateway --force

Voeg eventuele Gateway CLI-flags toe na gateway:watch; deze worden bij elke herstart doorgegeven.

Dev-profiel + dev Gateway (--dev)¶

Gebruik het dev-profiel om state te isoleren en een veilige, wegwerpbare setup op te starten voor debugging. Er zijn twee --dev-flags:

• Globale --dev (profiel): isoleert state onder ~/.openclaw-dev en zet standaard de Gateway-poort op 19001 (afgeleide poorten verschuiven mee).
• gateway --dev: vertelt de Gateway om automatisch een standaardconfig + werkruimte aan te maken wanneer deze ontbreekt (en BOOTSTRAP.md over te slaan).

Aanbevolen flow (dev-profiel + dev-bootstrap):

pnpm gateway:dev
OPENCLAW_PROFILE=dev openclaw tui

Als je nog geen globale installatie hebt, voer de CLI uit via pnpm openclaw ....

Wat dit doet:

1. Profielisolatie (globale --dev) - OPENCLAW_PROFILE=dev - OPENCLAW_STATE_DIR=~/.openclaw-dev - OPENCLAW_CONFIG_PATH=~/.openclaw-dev/openclaw.json - OPENCLAW_GATEWAY_PORT=19001 (browser/canvas verschuift overeenkomstig)

2. Dev-bootstrap (gateway --dev) - Schrijft een minimale config als deze ontbreekt (gateway.mode=local, bind loopback). - Zet agent.workspace naar de dev-werkruimte. - Zet agent.skipBootstrap=true (geen BOOTSTRAP.md). - Seedt de werkruimtebestanden indien ontbrekend: AGENTS.md, SOUL.md, TOOLS.md, IDENTITY.md, USER.md, HEARTBEAT.md. - Standaardidentiteit: C3‑PO (protocoldroid). - Slaat kanaalproviders over in dev-modus (OPENCLAW_SKIP_CHANNELS=1).

Reset-flow (schone start):

pnpm gateway:dev:reset

Let op: --dev is een globale profiel-flag en wordt door sommige runners opgeslokt. Als je deze expliciet moet opgeven, gebruik de env-var-vorm:

OPENCLAW_PROFILE=dev openclaw gateway --dev --reset

--reset wist config, credentials, sessies en de dev-werkruimte (met trash, niet rm), en maakt vervolgens de standaard dev-setup opnieuw aan.

Tip: als er al een niet-dev Gateway draait (launchd/systemd), stop die eerst:

openclaw gateway stop

Ruwe stream-logging (OpenClaw)¶

OpenClaw kan de ruwe assistant-stream loggen vóór enige filtering/formattering. Dit is de beste manier om te zien of redenering als platte-tekst-delta’s binnenkomt (of als aparte thinking-blokken).

Inschakelen via de CLI:

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

Optionele pad-overschrijving:

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

Gelijkwaardige env-vars:

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

Standaardbestand:

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

Ruwe chunk-logging (pi-mono)¶

Om ruwe OpenAI-compat chunks vast te leggen voordat ze in blokken worden geparseerd, biedt pi-mono een aparte logger:

PI_RAW_STREAM=1

Optioneel pad:

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

Standaardbestand:

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

Let op: dit wordt alleen uitgezonden door processen die pi-mono’s openai-completions-provider gebruiken.

Veiligheidsnotities¶

• Ruwe streamlogs kunnen volledige prompts, tooluitvoer en gebruikersgegevens bevatten.
• Houd logs lokaal en verwijder ze na het debuggen.
• Als je logs deelt, verwijder eerst geheimen en PII.