Selig
4c966a3ad2
6 custom skills (assign-task, dispatch-webhook, daily-briefing, task-capture, qmd-brain, tts-voice) with technical documentation. Compatible with Claude Code, OpenClaw, Codex CLI, and OpenCode.
1.3 KiB
Debugging Documentation
This OpenClaw debugging guide covers tools for troubleshooting streaming output and provider-specific issues.
Key Debugging Features
Runtime Configuration Overrides: The /debug command allows temporary config adjustments without modifying files. Users can display, set, unset, or reset overrides during a session.
Watch Mode for Gateway: Running pnpm gateway:watch --force enables rapid iteration on gateway code with automatic restarts.
Development Profile: The --dev flag creates isolated development environments at ~/.openclaw-dev with custom port routing (19001) and auto-generated workspace setup, including default agent identity and bootstrapping options.
Stream Logging
Two complementary logging systems capture raw data:
-
OpenClaw Raw Streams: The
--raw-streamflag logs assistant output before filtering, revealing whether reasoning appears as text deltas or separate blocks. Logs write to~/.openclaw/logs/raw-stream.jsonlby default. -
pi-mono Raw Chunks: Setting
PI_RAW_STREAM=1captures OpenAI-compatible chunks before parsing into blocks, useful for provider-level debugging.
Security Considerations
Raw logs may contain full prompts, tool output, and user data. The documentation advises keeping logs local, deleting them after use, and scrubbing secrets before sharing.