Documentation Index
Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt
Use this file to discover all available pages before exploring further.
进度草稿让长时间运行的智能体回合在聊天中显得有进展，而不会把对话变成一堆临时状态回复。
启用进度草稿后，OpenClaw 只会在回合证明正在执行真实工作后创建一条可见的进行中消息，并在智能体读取、规划、调用工具或等待批准时更新它；当渠道可以安全地这样做时，再把该草稿变成最终答案。
Shelling...
📖 Read: from docs/concepts/progress-drafts.md
🔎 Web Search: for "discord edit message"
🛠️ Exec: run tests
快速开始
使用 streaming.mode: "progress" 按渠道启用进度草稿：
{
channels: {
discord: {
streaming: {
mode: "progress",
},
},
},
}
用户会看到什么
进度草稿包含两部分：
| 部分 | 用途 |
|---|
| 标签 | 一个简短标题，例如 Thinking... 或 Shelling...。 |
| 进度行 | 使用与详细输出相同工具标签和图标的紧凑运行更新。 |
🛠️ Exec、🔎 Web Search 或 ✍️ Write: to /tmp/file。默认情况下，它们使用与 /verbose 相同的紧凑解释模式；调试时如果也想追加原始命令/详情，请设置 agents.defaults.toolProgressDetail: "raw"。
在可能时，最终答案会替换草稿；否则 OpenClaw 会正常发送最终答案，并根据渠道的传输方式清理草稿或停止更新草稿。
选择模式
channels.<channel>.streaming.mode 控制可见的进行中行为：
| 模式 | 最适合 | 聊天中显示的内容 |
|---|
off | 安静的渠道 | 只有最终答案。 |
partial | 观察答案文本逐步出现 | 一个草稿，编辑为最新答案文本。 |
block | 更大的答案预览分块 | 一个预览，以更大的分块更新或追加。 |
progress | 工具密集型或长时间运行的回合 | 一个状态草稿，然后是最终答案。 |
progress。
当答案本身就是进度信号时，选择 partial。
当你希望以更大的文本分块更新草稿预览时，选择 block。在 Discord 和 Telegram 上，streaming.mode: "block" 仍然是预览流式传输，而不是普通的分块交付。当你想要普通的分块回复时，请使用 streaming.block.enabled 或旧版 blockStreaming。
配置标签
进度标签位于 channels.<channel>.streaming.progress 下。
默认标签是 auto，它会从 OpenClaw 内置的带省略号单词标签池中选择：
Thinking...
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 对进度草稿和 /verbose 使用相同的格式化器：
{
agents: {
defaults: {
toolProgressDetail: "explain", // explain | raw
},
},
}
"explain" 是默认值，会用简洁标签保持草稿稳定，例如 🛠️ Exec: check JS syntax for /tmp/app.js。"raw" 会在可用时追加底层命令/详情，这在调试时有用，但在聊天中更嘈杂。
例如，同一个命令会根据详情模式显示为不同形式：
| 模式 | 进度行 |
|---|
explain | 🛠️ Exec: check JS syntax for /tmp/app.js |
raw | 🛠️ Exec: check JS syntax for /tmp/app.js, node --check /tmp/app.js |
{
channels: {
discord: {
streaming: {
mode: "progress",
progress: {
maxLines: 4,
},
},
},
},
}
{
channels: {
slack: {
streaming: {
mode: "progress",
progress: {
render: "rich",
},
},
},
},
}
{
channels: {
discord: {
streaming: {
mode: "progress",
progress: {
toolProgress: false,
},
},
},
},
}
toolProgress: false 时，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 所使用的同类草稿预览分块模式。
