ClawCN - OpenClaw 中文版

主题

调试 ​

本页介绍用于流式输出的调试辅助工具，特别是当提供商将推理混入普通文本时。

运行时调试覆盖 ​

在聊天中使用 /debug 来设置仅运行时的配置覆盖（内存中，非磁盘）。 /debug 默认禁用；使用 commands.debug: true 启用。 当您需要切换不常用的设置而不编辑 openclaw.json 时，这很方便。

示例：

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

/debug reset 清除所有覆盖并返回到磁盘上的配置。

Gateway 监视模式 ​

为了快速迭代，在文件监视器下运行 gateway：

bash
pnpm gateway:watch --force

这映射到：

bash
tsx watch src/entry.ts gateway --force

在 gateway:watch 之后添加任何 gateway CLI 标志，它们将在每次重启时传递。

开发配置文件 + 开发 gateway（--dev） ​

使用开发配置文件来隔离状态并启动一个安全的、可丢弃的调试设置。 有两个 --dev 标志：

  • 全局 --dev（配置文件）： 在 ~/.openclaw-dev 下隔离状态，并将 gateway 端口默认设置为 19001（派生端口随之移动）。
  • gateway --dev：告诉 Gateway 在缺失时自动创建默认配置 + 工作空间（并跳过 BOOTSTRAP.md）。

推荐流程（开发配置文件 + 开发引导）：

bash
pnpm gateway:dev
OPENCLAW_PROFILE=dev openclaw tui

如果您还没有全局安装，请通过 pnpm openclaw ... 运行 CLI。

这会做什么：

  1. 配置文件隔离（全局 --dev）

    • OPENCLAW_PROFILE=dev
    • OPENCLAW_STATE_DIR=~/.openclaw-dev
    • OPENCLAW_CONFIG_PATH=~/.openclaw-dev/openclaw.json
    • OPENCLAW_GATEWAY_PORT=19001（浏览器/画布相应移动）

  2. 开发引导（gateway --dev）

    • 如果缺失则写入最小配置（gateway.mode=local，绑定回环）。
    • 将 agent.workspace 设置为开发工作空间。
    • 设置 agent.skipBootstrap=true（无 BOOTSTRAP.md）。
    • 如果缺失则播种工作空间文件： AGENTS.md、SOUL.md、TOOLS.md、IDENTITY.md、USER.md、HEARTBEAT.md。
    • 默认身份：C3‑PO（协议机器人）。
    • 在开发模式下跳过通道提供商（OPENCLAW_SKIP_CHANNELS=1）。

重置流程（全新开始）：

bash
pnpm gateway:dev:reset

注意：--dev 是一个全局配置文件标志，会被某些运行器吞噬。 如果需要明确指定，请使用环境变量形式：

bash
OPENCLAW_PROFILE=dev openclaw gateway --dev --reset

--reset 清除配置、凭据、会话和开发工作空间（使用 trash，而非 rm），然后重新创建默认开发设置。

提示：如果非开发 gateway 已在运行（launchd/systemd），请先停止它：

bash
openclaw gateway stop

原始流日志记录（OpenClaw） ​

OpenClaw 可以在任何过滤/格式化之前记录原始助手流。 这是查看推理是否作为纯文本增量（或作为单独的思考块）到达的最佳方式。

通过 CLI 启用：

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

可选路径覆盖：

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

等效环境变量：

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

默认文件：

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

原始块日志记录（pi-mono） ​

要在解析为块之前捕获原始 OpenAI 兼容块， pi-mono 公开了一个单独的日志记录器：

bash
PI_RAW_STREAM=1

可选路径：

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

默认文件：

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

注意：这仅由使用 pi-mono 的 openai-completions 提供商的进程发出。

安全注意事项 ​

  • 原始流日志可能包含完整提示、工具输出和用户数据。
  • 将日志保存在本地，调试后删除它们。
  • 如果共享日志，请先清理机密信息和个人身份信息（PII）。