Debugging
调试工作流
当你不是单纯想修问题，而是准备做本地开发、看原始流、追踪 provider 输出或隔离一套可丢弃的 dev 环境时，应该使用这一页的工作流。
运行时调试覆盖
/debug 命令
用于设置仅在当前运行时生效的调试覆盖，不落盘。适合你想临时切换前缀、行为或某些边缘选项，而不想直接改 openclaw.json。
典型命令
/debug show、/debug set messages.responsePrefix="[openclaw]"、/debug reset
开发与 watch 模式
Gateway 监视模式
pnpm gateway:watch --forcedev 配置文件 + dev Gateway
把状态、配置和工作区隔离到一套可丢弃环境中，避免污染主配置。
pnpm gateway:dev
OPENCLAW_PROFILE=dev openclaw tui重置 dev 环境
pnpm gateway:dev:reset原始流日志
记录 OpenClaw 原始助手流
pnpm gateway:watch --force --raw-stream
pnpm gateway:watch --force --raw-stream --raw-stream-path ~/.openclaw/logs/raw-stream.jsonl记录 pi-mono 原始块
PI_RAW_STREAM=1
PI_RAW_STREAM_PATH=~/.pi-mono/logs/raw-openai-completions.jsonl这类日志可能包含完整提示词、工具输出和用户数据，只建议本地调试后尽快清理。
调试安全注意事项
原始流日志可能包含完整提示、工具输出、用户数据与密钥相关上下文，不应长期保留。
如果要把日志贴给别人，先手动清理 token、个人身份信息和工作区敏感路径。
如果非 dev Gateway 已在运行，先停掉它，再启动 watch / dev 环境，避免你调试的是另一份状态目录。