进度草稿

Progress drafts 使长时间的 Agent 轮次在聊天中感觉生动，而不会将对话变成一堆临时状态回复。

当启用 Progress drafts 时，OpenClaw 仅在轮次证明其正在执行实际工作后才创建一条可见的进行中消息，在 Agent 读取、规划、调用工具或等待批准时更新该消息，然后在该渠道可以安全执行此操作时将该草稿转换为最终答案。

Shelling...
📖 from docs/concepts/progress-drafts.md
🔎 Web Search: for "discord edit message"
🛠️ Bash: run tests

当您希望在重度使用工具的工作期间有一条整洁的状态消息，并在轮次完成时得到最终答案，请使用 Progress drafts。

快速开始

为每个渠道启用进度草稿，使用 streaming.mode: "progress"：

{
  channels: {
    discord: {
      streaming: {
        mode: "progress",
      },
    },
  },
}

这通常就足够了。OpenClaw 将选择一个自动的单字标签，等待工作持续至少五秒或发出第二个工作事件，在有实际工作发生时添加紧凑的进度行，并抑制该轮次的重复独立进度闲聊。

用户看到的内容

Progress draft 有两个部分：

部分	目的
标签	简短的起始/状态行，例如 `Working` 或 `Shelling`。
进度行	使用与详细输出相同的工具图标和细节格式化程序的紧凑运行更新。

该标签在代理开始有意义的工作且保持忙碌五秒或发出第二个工作事件后出现。它是滚动进度行列表的一部分，因此一旦出现足够的具体工作，起始状态就会滚动消失。纯文本回复不显示进度草稿。仅当代理发出有用的工作更新（例如 🛠️ Bash: run tests、🔎 Web Search: for "discord edit message" 或 ✍️ Write: to /tmp/file）时，才会添加进度行。默认情况下，它们使用与 /verbose 相同的紧凑解释模式；如果在调试时您还希望附加原始命令/详细信息，请设置 agents.defaults.toolProgressDetail: "raw"OpenClaw。在可能的情况下，最终答案会替换草稿；否则，OpenClaw 会正常发送最终答案，并根据渠道的传输方式清理或停止更新草稿。

选择模式

channels.<channel>.streaming.mode 控制可见的进行中行为：

模式	最适合	聊天中显示的内容
`off`	安静渠道	仅最终答案。
`partial`	观察答案文本出现	一个使用最新答案文本编辑的草稿。
`block`	较大的答案预览块	一个以较大块更新或附加的预览。
`progress`	重度使用工具或长时间运行的轮次	一个状态草稿，然后是最终答案。

当用户更关心“正在发生什么”而不是逐字观看答案文本流时，请选择 progress。

当答案本身就是进度信号时，请选择 partial。

当您希望以较大的文本块进行草稿预览更新时，请选择 blockDiscordTelegram。在 Discord 和 Telegram 上，streaming.mode: "block" 仍然是预览流式传输，而不是普通的块传递。当您需要普通的块回复时，请使用 streaming.block.enabled 或传统的 blockStreaming。

配置标签

进度标签位于 channels.<channel>.streaming.progress 下。

默认标签为 auto，它会从 OpenClaw 的内置单字标签池中进行选择：

Working
Shelling
Scuttling
Clawing
Pinching
Molting
Bubbling
Tiding
Reefing
Cracking
Sifting
Brining
Nautiling
Krilling
Barnacling
Lobstering
Tidepooling
Pearling
Snapping
Surfacing

使用固定标签：

{
  channels: {
    discord: {
      streaming: {
        mode: "progress",
        progress: {
          label: "Investigating",
        },
      },
    },
  },
}

使用您自己的自动标签池：

{
  channels: {
    discord: {
      streaming: {
        mode: "progress",
        progress: {
          label: "auto",
          labels: ["Checking", "Reading", "Testing", "Finishing"],
        },
      },
    },
  },
}

隐藏标签并仅显示进度行：

{
  channels: {
    discord: {
      streaming: {
        mode: "progress",
        progress: {
          label: false,
        },
      },
    },
  },
}

控制进度行

在进度模式下，进度行默认启用。它们来自真实的运行事件：工具启动、项目更新、任务计划、批准、命令输出、补丁摘要以及类似的代理活动。

OpenClaw 对进度草稿和 OpenClaw/verbose 使用相同的格式化程序：

{
  agents: {
    defaults: {
      toolProgressDetail: "explain", // explain | raw
    },
  },
}

"explain" 是默认选项，通过像 🛠️ check JS syntax for /tmp/app.js 这样的简洁标签保持草稿稳定。"raw" 会在可用时追加底层命令/详细信息，这在调试时很有用，但在聊天中会显得更杂乱。

例如，根据详细模式的不同，同一条命令会显示为不同的形式：

模式	进度行
`explain`	`🛠️ check JS syntax for /tmp/app.js`
`raw`	`🛠️ check JS syntax for /tmp/app.js, node --check /tmp/app.js`

限制保持可见的行数：

{
  channels: {
    discord: {
      streaming: {
        mode: "progress",
        progress: {
          maxLines: 4,
        },
      },
    },
  },
}

进度行会自动压缩，以减少编辑草稿时的聊天气泡重排。

OpenClaw 默认会截断过长的进度行，以免重复的草稿编辑在每次更新时产生不同的换行。默认的每行预算为 120 个字符。散文会在单词边界处截断，而路径或原始命令等长细节会通过中间省略号缩短，以便保留后缀可见。

调整每行预算：

{
  channels: {
    discord: {
      streaming: {
        mode: "progress",
        progress: {
          maxLineChars: 160,
        },
      },
    },
  },
}

Slack 可以将进度行呈现为结构化的 Block Kit 字段，而不是单个文本正文：

{
  channels: {
    slack: {
      streaming: {
        mode: "progress",
        progress: {
          render: "rich",
        },
      },
    },
  },
}

富文本呈现保留相同的纯文本回退，因此不支持更丰富形状的渠道和客户端仍可显示紧凑的进度文本。

保留单个进度草稿，但隐藏工具和任务行：

{
  channels: {
    discord: {
      streaming: {
        mode: "progress",
        progress: {
          toolProgress: false,
        },
      },
    },
  },
}

使用 toolProgress: falseOpenClaw 时，OpenClaw 仍会抑制该回合较旧的独立工具进度消息。渠道在最终答案之前保持视觉上的安静，除非配置了标签。

渠道行为

每个渠道都使用其支持的最干净的传输方式：

渠道	进度传输	备注
Discord	发送一条消息，然后编辑它。	当它适合一条安全的预览消息时，最终文本会就地编辑。
Matrix	发送一个事件，然后编辑它。	账户级别的流式配置控制账户级别的草稿。
Microsoft Teams	在个人聊天中使用原生 Teams 流。	`streaming.mode: "block"` 映射到 Teams 块传递。
Slack	原生流或可编辑的草稿帖子。	线程可用性影响是否可以使用原生流式传输。
Telegram	发送一条消息，然后对其进行编辑。	较旧的可见草稿可能会被替换，以便最终的时间戳保持有效。
Mattermost	可编辑的草稿帖子。	工具活动被折叠到同一条草稿风格的帖子中。

不支持安全编辑的渠道通常会回退到输入指示器或仅发送最终结果。

定稿

当最终答案准备就绪时，OpenClaw 会尽量保持聊天整洁：

如果草稿可以安全地变为最终答案，OpenClaw 会对其进行就地编辑。
如果渠道使用原生进度流传输，当原生传输接受最终文本时，OpenClaw 会完成该流。
如果最终答案包含媒体、审批提示、显式回复目标、过多块，或编辑/发送失败，OpenClaw 会通过正常渠道传送路径发送最终答案。

回退路径是有意为之的。发送一条新的最终答案总比丢失文本、回复串错或用渠道无法安全表示的有效负载覆盖草稿要好。

故障排除

我只看到了最终答案。

检查处理该消息的账户或渠道的 channels.<channel>.streaming.mode 是否设置为 progress。当渠道无法安全编辑正确的消息时，某些群组或引用回复路径可能会在该轮次中禁用草稿预览。

我看到了标签但没有工具行。

检查 streaming.progress.toolProgress。如果它是 false，OpenClaw 将保持单草稿行为，但会隐藏工具和任务进度行。

我看到的是一条新的最终消息，而不是编辑过的草稿。

这是一种安全回退措施。它可能发生在媒体回复、长答案、显式回复目标、旧的 Telegram 草稿、缺失的 Slack 线程目标、已删除的预览消息或原生流完成失败的情况。

我仍然看到独立的进度消息。

当草稿处于活动状态时，进度模式会抑制默认的独立工具进度消息。如果仍然出现独立消息，请验证该轮次是否确实在使用进度模式，而不是 streaming.mode: "off" 或无法为该消息创建草稿的渠道路径。

Teams 的行为与 Discord 或 Telegram 不同。

Microsoft Teams 在个人聊天中使用原生流，而不是通用的发送并编辑预览传输。Teams 还将 streaming.mode: "block" 视为 Teams 阻塞式交付，因为它没有 Discord 和 Telegram 所使用的相同草稿预览块模式。