Fehlerbehebung¶

Diese Seite behandelt Debugging-Hilfen für Streaming-Ausgaben, insbesondere wenn ein Anbieter Reasoning in normalen Text mischt.

Laufzeit-Debug-Overrides¶

Verwenden Sie /debug im Chat, um nur zur Laufzeit Konfigurations-Overrides zu setzen (Speicher, nicht Festplatte). /debug ist standardmäßig deaktiviert; aktivieren Sie es mit commands.debug: true. Das ist praktisch, wenn Sie seltene Einstellungen umschalten müssen, ohne openclaw.json zu bearbeiten.

Beispiele:

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

/debug reset löscht alle Overrides und kehrt zur Konfiguration auf der Festplatte zurück.

Gateway Watch-Modus¶

Für schnelle Iterationen führen Sie den Gateway unter dem Dateiwächter aus:

pnpm gateway:watch --force

Diese Karten zu:

tsx watch src/entry.ts gateway --force

Fügen Sie beliebige Gateway-CLI-Flags nach gateway:watch hinzu; sie werden bei jedem Neustart durchgereicht.

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

Verwenden Sie das Dev-Profil, um Zustand zu isolieren und ein sicheres, wegwerfbares Setup für das Debugging zu starten. Es gibt zwei --dev-Flags:

• Globales --dev (Profil): isoliert den Zustand unter ~/.openclaw-dev und setzt den Gateway-Port standardmäßig auf 19001 (abgeleitete Ports verschieben sich entsprechend).
• gateway --dev: weist den Gateway an, automatisch eine Standardkonfiguration + einen Workspace zu erstellen, falls diese fehlen (und BOOTSTRAP.md zu überspringen).

Empfohlener Ablauf (Dev-Profil + Dev-Bootstrap):

pnpm gateway:dev
OPENCLAW_PROFILE=dev openclaw tui

Wenn Sie noch keine globale Installation haben, führen Sie die CLI über pnpm openclaw ... aus.

Was das bewirkt:

1. Profil-Isolation (globales --dev) - OPENCLAW_PROFILE=dev - OPENCLAW_STATE_DIR=~/.openclaw-dev - OPENCLAW_CONFIG_PATH=~/.openclaw-dev/openclaw.json - OPENCLAW_GATEWAY_PORT=19001 (Browser/Canvas verschieben sich entsprechend)

2. Dev-Bootstrap (gateway --dev) - Schreibt eine minimale Konfiguration, falls sie fehlt (gateway.mode=local, bind loopback). - Setzt agent.workspace auf den Dev-Workspace. - Setzt agent.skipBootstrap=true (kein BOOTSTRAP.md). - Befüllt die Workspace-Dateien, falls sie fehlen: AGENTS.md, SOUL.md, TOOLS.md, IDENTITY.md, USER.md, HEARTBEAT.md. - Standardidentität: C3‑PO (Protokoll-Droide). - Überspringt Kanal-Anbieter im Dev-Modus (OPENCLAW_SKIP_CHANNELS=1).

Reset-Ablauf (Neustart von Grund auf):

pnpm gateway:dev:reset

Hinweis: --dev ist ein globales Profil-Flag und wird von einigen Runnern geschluckt. Wenn Sie es explizit angeben müssen, verwenden Sie die Env-Variante:

OPENCLAW_PROFILE=dev openclaw gateway --dev --reset

--reset löscht Konfiguration, Anmeldedaten, Sitzungen und den Dev-Workspace (unter Verwendung von trash, nicht rm), und erstellt anschließend das Standard-Dev-Setup neu.

Tipp: Wenn bereits ein Nicht-Dev-Gateway läuft (launchd/systemd), stoppen Sie ihn zuerst:

openclaw gateway stop

Rohes Stream-Logging (OpenClaw)¶

OpenClaw kann den rohen Assistant-Stream vor jeglicher Filterung/Formatierung protokollieren. Dies ist der beste Weg, um zu sehen, ob Reasoning als reine Text-Deltas ankommt (oder als separate Thinking-Blöcke).

Aktivieren Sie es per CLI:

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

Optionale Pfadüberschreibung:

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

Äquivalente env vars:

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

Standarddatei:

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

Rohes Chunk-Logging (pi-mono)¶

Um rohe OpenAI-kompatible Chunks zu erfassen, bevor sie in Blöcke geparst werden, stellt pi-mono einen separaten Logger bereit:

PI_RAW_STREAM=1

Optionaler Pfad:

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

Standarddatei:

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

Hinweis: Dies wird nur von Prozessen ausgegeben, die den openai-completions-Anbieter von pi-mono verwenden.

Sicherheitshinweise¶

• Rohe Stream-Logs können vollständige Prompts, Werkzeugausgaben und Benutzerdaten enthalten.
• Bewahren Sie Logs lokal auf und löschen Sie sie nach dem Debugging.
• Wenn Sie Logs teilen, entfernen Sie zuvor Geheimnisse und personenbezogene Daten (PII).