流式传输和分块

• 分块流式传输（渠道）：在助手写入时发送已完成的块。这些是普通渠道消息，而不是 token delta。
• 预览流式传输（Telegram/Discord/Slack/Matrix/Mattermost/MS Teams）： 在生成期间更新临时预览消息（发送 + 编辑/追加）。

​

分块流式传输（渠道消息）

Model output
  └─ text_delta/events
       ├─ (blockStreamingBreak=text_end)
       │    └─ chunker emits blocks as buffer grows
       └─ (blockStreamingBreak=message_end)
            └─ chunker flushes at message_end
                   └─ channel send (block replies)

• text_delta/events：模型流事件（对于非流式模型可能很稀疏）。
• chunker：EmbeddedBlockChunker，应用最小/最大边界 + 断点偏好。
• channel send：实际出站消息（分块回复）。

• text_end：chunker 一旦发送块就进行流式发送；在每个 text_end 时刷新。
• message_end：等待助手消息完成，然后刷新缓冲的输出。如果缓冲文本超过 maxChars，仍会使用 chunker，因此可能在末尾发送多个分块。

​

分块流式传输中的媒体递送

​

分块算法（低/高边界）

• **低边界：**在 buffer >= minChars 之前不要发送（除非强制）。
• **高边界：**优先在 maxChars 之前拆分；如果强制，则在 maxChars 处拆分。
• 断点偏好链：paragraph -> newline -> sentence -> 空白 -> 硬断点。
• **代码围栏：**绝不在围栏内拆分；当在 maxChars 处强制拆分时，关闭并重新打开围栏，以保持 Markdown 有效。

​

合并（合并流式块）

• 合并会等待空闲间隔（idleMs）后再刷新。
• buffer 受 maxChars 限制，超过时会刷新。
• minChars 会阻止过小片段在积累足够文本前发送（最终刷新始终发送剩余文本）。
• 连接符来自 blockStreamingChunk.breakPreference：paragraph -> \n\n，newline -> \n，sentence -> 空格。
• 可通过 *.blockStreamingCoalesce 配置渠道覆盖（包括按账号配置）。
• Discord、Signal 和 Slack 默认合并为 { minChars: 1500, idleMs: 1000 }，除非被覆盖。

​

分块之间的类人节奏

​

“流式发送分块或全部内容”

• 流式发送分块：blockStreamingDefault: "on" + blockStreamingBreak: "text_end" （边生成边发送）。非 Telegram 渠道还需要 *.blockStreaming: true。
• 在末尾流式发送全部内容：blockStreamingBreak: "message_end"（刷新一次，如果很长则可能是多个分块）。
• 无分块流式传输：blockStreamingDefault: "off"（仅最终回复）。

​

预览流式传输模式

​

渠道映射

• channels.slack.streaming.nativeTransport 会在 channels.slack.streaming.mode="partial" 时切换 Slack 原生流式 API 调用（chat.startStream/chat.appendStream/chat.stopStream）（默认：true）。
• Slack 原生流式传输和 Slack 助手线程状态需要一个回复线程目标。顶层私信不会显示这种线程式预览，但仍可以使用 Slack 草稿预览帖子和编辑。

​

旧版键迁移

​

运行时行为

​

Telegram

• 在私信和群组/话题中使用 sendMessage + editMessageText 预览更新；最终文本会原地编辑活动预览。Telegram 临时 30 秒“typing”草稿（sendMessageDraft）不会用于答案流式传输。
• 为了推送通知 UX，较短的初始预览仍会防抖，但会在有界延迟后物化，确保活动运行不会在视觉上一直沉默。
• 较长的最终回复会将预览消息复用于第一个分块，并且只发送剩余分块。
• block 模式会在 streaming.preview.chunk.maxChars 处将预览轮换到新消息（默认 800，受 Telegram 的 4096 编辑限制约束）；其他模式会让一个预览增长到最多 4096 个字符。
• progress 模式会在可编辑状态草稿中保留工具进度；当答案流式传输处于活动状态但尚无工具行可用时，会物化状态标签；完成时清除草稿，并通过正常递送发送最终答案。
• 如果最终编辑在确认完成文本之前失败，OpenClaw 会使用正常最终递送，并清理陈旧预览。
• 当 Telegram 分块流式传输被显式启用时，会跳过预览流式传输，以避免双重流式发送。
• /reasoning stream 可以将推理写入临时预览，该预览会在最终递送后删除。
• Telegram 选定引用回复是一个例外：当 replyToMode 不是 "off" 且存在选定引用文本时，OpenClaw 会跳过该轮次的答案预览流（最终答案必须走原生引用回复路径），因此工具进度预览行无法渲染。没有选定引用文本的当前消息回复仍会保留预览流式传输。详情见 Telegram 渠道文档。

​

Discord

• 使用发送 + 编辑预览消息。
• block 模式使用草稿分块（draftChunk）。
• 当 Discord 分块流式传输被显式启用时，跳过预览流式传输。
• 最终媒体、错误和显式回复载荷会取消待处理预览，而不会刷新新的草稿，然后使用正常投递。

​

Slack

• partial 可在可用时使用 Slack 原生流式传输（chat.startStream/append/stop）。
• block 使用追加式草稿预览。
• progress 使用状态预览文本，然后发送最终答案。
• 没有回复线程的顶层私信使用草稿预览帖子和编辑，而不是 Slack 原生流式传输。
• 原生和草稿预览流式传输会抑制该轮次的块回复，因此 Slack 回复只通过一条投递路径进行流式传输。
• 最终媒体/错误载荷和进度最终消息不会创建一次性草稿消息；只有可编辑预览的文本/块最终消息会刷新待处理草稿文本。

​

Mattermost

• 将思考、工具活动和部分回复文本流式传输到单个草稿预览帖子中，并在最终答案可安全发送时就地最终确定。
• 如果预览帖子已被删除或在最终确定时不可用，则回退为发送新的最终帖子。
• 最终媒体/错误载荷会在正常投递前取消待处理预览更新，而不是刷新临时预览帖子。

​

Matrix

• 当最终文本可以复用预览事件时，草稿预览会就地最终确定。
• 仅媒体、错误和回复目标不匹配的最终消息会在正常投递前取消待处理预览更新；已可见的过期预览会被撤回。

​

工具进度预览更新

• Discord、Slack、Telegram 和 Matrix 在预览流式传输处于活动状态时，默认将工具进度和 Codex 前言更新流式传输到实时预览编辑中。Microsoft Teams 在个人聊天中使用其原生进度流。
• Telegram 自 v2026.4.22 起已发布启用工具进度预览更新；保持启用会保留该已发布行为。
• Mattermost 已经将工具活动合并到其单个草稿预览帖子中（见上文）。
• 工具进度编辑遵循活动的预览流式传输模式；当预览流式传输为 off，或分块流式传输已接管消息时，会跳过这些编辑。在 Telegram 上，streaming.mode: "off" 为仅最终消息：通用进度闲聊也会被抑制，而不是作为独立状态消息投递；审批提示、媒体载荷和错误仍会正常路由。
• 若要保留预览流式传输但隐藏工具进度行，请将该渠道的 streaming.preview.toolProgress 设为 false（默认 true）。若要保持工具进度行可见，同时隐藏命令/exec 文本，请将 streaming.preview.commandText 设为 "status"，或将 streaming.progress.commandText 设为 "status"；默认值为 "raw"，以保留已发布行为。此策略由使用 OpenClaw 紧凑进度渲染器的草稿/进度渠道共享，包括 Discord、Matrix、Microsoft Teams、Mattermost、Slack 草稿预览和 Telegram。若要完全禁用预览编辑，请将 streaming.mode 设为 off。

​

进度草稿渲染

​

评论进度通道

• streaming.progress.commentary - 渲染模型的工具前评论（一段简短的“我会先检查…然后…”叙述），并在进度草稿中与工具行交错显示。

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

{
  "channels": {
    "telegram": {
      "streaming": {
        "mode": "partial",
        "preview": {
          "toolProgress": true,
          "commandText": "status"
        }
      }
    }
  }
}

{
  "channels": {
    "telegram": {
      "streaming": {
        "mode": "progress",
        "progress": {
          "toolProgress": true,
          "commandText": "status"
        }
      }
    }
  }
}

​

相关

• 消息生命周期重构 - 目标共享预览、编辑、流式传输和最终确定设计
• 进度草稿 - 在长轮次期间更新的可见进行中工作消息
• 消息 - 消息生命周期和投递
• Retry - 投递失败时的重试行为
• Channels - 按渠道的流式传输支持