# 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.
