forked from Selig/openclaw-skill
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.
24 lines
1.3 KiB
Markdown
24 lines
1.3 KiB
Markdown
# 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:
|
|
|
|
1. **OpenClaw Raw Streams**: The `--raw-stream` flag logs assistant output before filtering, revealing whether reasoning appears as text deltas or separate blocks. Logs write to `~/.openclaw/logs/raw-stream.jsonl` by default.
|
|
|
|
2. **pi-mono Raw Chunks**: Setting `PI_RAW_STREAM=1` captures 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.
|