串流與分塊

• 區塊串流（頻道）：在助理撰寫時送出完成的區塊。這些是一般頻道訊息，不是 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 時 flush。
• message_end：等助理訊息完成後，再 flush 已緩衝的輸出。如果緩衝文字超過 maxChars，仍會使用 chunker，因此可在最後送出多個片段。

​

使用區塊串流傳送媒體

​

切塊演算法（低/高界限）

• **低界限：**在 buffer >= minChars 前不要送出（除非強制）。
• **高界限：**偏好在 maxChars 前拆分；若強制，則在 maxChars 拆分。
• 斷點偏好鏈：paragraph -> newline -> sentence -> 空白字元 -> 硬性斷點。
• **程式碼圍欄：**絕不在圍欄內拆分；在 maxChars 強制拆分時，會關閉並重新開啟圍欄，以保持 Markdown 有效。

​

合併（合併串流區塊）

• 合併會等待閒置間隔（idleMs）後才 flush。
• 緩衝區會受 maxChars 限制，超過時會 flush。
• minChars 會防止太小的片段在累積足夠文字前傳送（最終 flush 一律會傳送剩餘文字）。
• 連接字串衍生自 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"（一次 flush；若非常長，可能分成多個片段）。
• 不使用區塊串流：blockStreamingDefault: "off"（僅最終回覆）。

​

預覽串流模式

​

頻道對應

• channels.slack.streaming.nativeTransport 會在 channels.slack.streaming.mode="partial" 時切換 Slack 原生串流 API 呼叫（chat.startStream/chat.appendStream/chat.stopStream）（預設：true）。
• Slack 原生串流和 Slack 助理執行緒狀態需要回覆執行緒目標。頂層 DM 不會顯示該執行緒樣式預覽，但仍可使用 Slack 草稿預覽貼文和編輯。

​

舊版鍵遷移

​

執行階段行為

​

Telegram

• 在 DM 和群組/主題中使用 sendMessage + editMessageText 預覽更新；最終文字會就地編輯作用中的預覽。Telegram 暫時性 30 秒「輸入中」草稿（sendMessageDraft）不會用於答案串流。
• 短的初始預覽仍會為了推播通知 UX 而 debounce，但會在有界延遲後具體化，讓作用中的執行不會在視覺上保持靜默。
• 長最終結果會重用預覽訊息作為第一個片段，並只傳送剩餘片段。
• 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）。若要讓工具進度行保持可見但隱藏命令/執行文字， 請將 streaming.preview.commandText 設為 "status"，或將 streaming.progress.commandText 設為 "status"；預設值為 "raw"， 以保留已發布行為。此政策由使用 OpenClaw 精簡進度算繪器的 草稿/進度通道共用，包括 Discord、Matrix、 Microsoft Teams、Mattermost、Slack 草稿預覽與 Telegram。若要完全停用 預覽編輯，請將 streaming.mode 設為 off。

​

進度草稿算繪

​

Commentary 進度通道

• streaming.progress.commentary - 算繪模型在工具前的 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"
        }
      }
    }
  }
}

​

相關

• 訊息生命週期重構 - 目標共用預覽、編輯、串流與完成設計
• 進度草稿 - 在長回合期間更新的可見進行中訊息
• 訊息 - 訊息生命週期與傳遞
• 重試 - 傳遞失敗時的重試行為
• 通道 - 各通道的串流支援