串流與分塊
OpenClaw 有兩個獨立的串流層：
- 區塊串流（頻道）： 當助理寫入時發送完成的 區塊。這些是正常的頻道訊息（而非 token 增量）。
- 預覽串流（Telegram/Discord/Slack）： 在生成時更新臨時的 預覽訊息。
目前對頻道訊息 沒有真正的 token 增量串流。預覽串流是基於訊息的（發送 + 編輯/附加）。
區塊串流（頻道訊息）
Section titled “區塊串流（頻道訊息）”區塊串流會在助理輸出可用時，以較大的分塊發送。
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：實際的輸出訊息（區塊回覆）。
控制項：
agents.defaults.blockStreamingDefault："on"/"off"（預設關閉）。- 頻道覆寫：
*.blockStreaming（以及每個帳號的變體）以針對每個頻道強制"on"/"off"。 agents.defaults.blockStreamingBreak："text_end"或"message_end"。agents.defaults.blockStreamingChunk：{ minChars, maxChars, breakPreference? }。agents.defaults.blockStreamingCoalesce：{ minChars?, maxChars?, idleMs? }（在發送前合併串流的區塊）。- 頻道硬上限：
*.textChunkLimit（例如，channels.whatsapp.textChunkLimit）。 - 頻道分塊模式：
*.chunkMode（length預設，newline在長度分塊前於空白行（段落邊界）分割）。 - Discord 軟上限：
channels.discord.maxLinesPerMessage（預設 17）分割高回覆以避免 UI 裁切。
邊界語意：
text_end：當分塊器發出時立即串流區塊；在每個text_end上清除。message_end：等到助理訊息完成後，再重新整理緩衝輸出。
如果緩衝文字超過 maxChars，message_end 仍會使用分塊器，因此它可以在最後發出多個區塊。
分塊演算法（低/高邊界）
Section titled “分塊演算法（低/高邊界）”區塊分塊由 EmbeddedBlockChunker 實作：
- 低邊界： 除非被強制，否則在緩衝 >=
minChars之前不發出。 - 高邊界： 偏好在
maxChars之前分割；如果被強制，則在maxChars分割。 - 斷行偏好：
paragraph→newline→sentence→whitespace→ 強制斷行。 - 程式碼圍欄： 絕不在圍欄內分割；當在
maxChars被強制分割時，關閉並重新開啟圍欄以保持 Markdown 有效。
maxChars 被限制在頻道 textChunkLimit，因此您無法超過每個頻道的上限。
合併（合併串流區塊）
Section titled “合併（合併串流區塊）”當啟用區塊串流時，OpenClaw 可以在發出連續區塊片段之前先 將其合併。這減少了「單行垃圾訊息」，同時仍能提供 漸進式輸出。
- 合併會在重新整理前等待 閒置間隙（
idleMs）。 - 緩衝區上限為
maxChars，如果超過該值將會重新整理。 minChars會防止發送微小的片段，直到累積足夠的文字 （最終重新整理總是會發送剩餘文字）。- 連接器衍生自
blockStreamingChunk.breakPreference（paragraph→\n\n，newline→\n，sentence→ 空格）。 - 可以透過
*.blockStreamingCoalesce覆蓋頻道設定（包括每個帳戶的設定）。 - 除非另有覆蓋，否則 Signal/Slack/Discord 的預設合併
minChars會提升至 1500。
區塊之間擬人化的節奏
Section titled “區塊之間擬人化的節奏”當啟用區塊串流時，您可以在區塊回覆之間（第一個區塊之後） 加入 隨機暫停。這會讓多氣泡回覆感覺更自然。
- 配置：
agents.defaults.humanDelay（可透過agents.list[].humanDelay針對每個代理程式覆寫）。 - 模式：
off（預設）、natural（800–2500ms）、custom（minMs/maxMs）。 - 僅適用於 區塊回覆，不適用於最終回覆或工具摘要。
“串流區塊或所有內容”
Section titled ““串流區塊或所有內容””這對應至：
- 串流區塊：
blockStreamingDefault: "on"+blockStreamingBreak: "text_end"（即時發送）。非 Telegram 頻道也需要*.blockStreaming: true。 - 結束時串流所有內容：
blockStreamingBreak: "message_end"（排清一次，如果非常長則可能分為多個區塊）。 - 無區塊串流：
blockStreamingDefault: "off"（僅最終回覆）。
頻道備註： 除非將 *.blockStreaming 明確設定為 true，否則區塊串流為關閉。頻道可以串流即時預覽
(channels.<channel>.streaming) 而不進行區塊回覆。
配置位置提醒：blockStreaming* 預設值位於
agents.defaults 之下，而非根配置中。
預覽串流模式
Section titled “預覽串流模式”標準金鑰：channels.<channel>.streaming
模式：
off：停用預覽串流。partial：單一預覽，會被最新文字取代。block：以分塊/附加步驟更新預覽。progress：生成期間顯示進度/狀態預覽，完成時顯示最終答案。
| 頻道 | off | partial | block | progress |
|---|---|---|---|---|
| Telegram | ✅ | ✅ | ✅ | 對應至 partial |
| Discord | ✅ | ✅ | ✅ | 對應至 partial |
| Slack | ✅ | ✅ | ✅ | ✅ |
Slack 專用：
- 當
streaming=partial時（預設：true），channels.slack.nativeStreaming會切換 Slack 原生串流 API 呼叫。
舊版金鑰遷移：
- Telegram：
streamMode+ 布林值streaming會自動遷移至streaming列舉。 - Discord：
streamMode+ booleanstreaming自動遷移至streamingenum。 - Slack：
streamMode自動遷移至streamingenum；booleanstreaming自動遷移至nativeStreaming。
Telegram：
- 在私訊和群組/主題中，使用
sendMessage+editMessageText預覽更新。 - 當明確啟用 Telegram 區塊串流時，會跳過預覽串流（以避免重複串流）。
/reasoning stream可以將推理寫入預覽。
Discord：
- 使用傳送 + 編輯預覽訊息。
block模式使用草稿分塊（draftChunk）。- 當明確啟用 Discord 區塊串流時，會跳過預覽串流。
Slack：
partial可以在可用時使用 Slack 原生串流（chat.startStream/append/stop）。block使用附加樣式（append-style）的草稿預覽。progress使用狀態預覽文字，然後是最終答案。