Streaming und Chunking

OpenClaw hat zwei separate Streaming-Ebenen:

• Block-Streaming (Kanäle): gibt abgeschlossene Blöcke aus, während der Assistent schreibt. Das sind normale Kanalnachrichten (keine Token-Deltas).
• Vorschau-Streaming (Telegram/Discord/Slack): aktualisiert während der Generierung eine temporäre Vorschaunachricht.

Heute gibt es kein echtes Token-Delta-Streaming für Kanalnachrichten. Vorschau-Streaming ist nachrichtenbasiert (Senden + Bearbeitungen/Anhänge).

Block-Streaming (Kanalnachrichten)

Block-Streaming sendet Assistentenausgaben in groben Abschnitten, sobald sie verfügbar werden.

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)

Legende:

• text_delta/events: Modell-Stream-Ereignisse (können bei nicht streamenden Modellen spärlich sein).
• chunker: EmbeddedBlockChunker, der Min-/Max-Grenzen + Umbruchpräferenz anwendet.
• channel send: tatsächlich ausgehende Nachrichten (Blockantworten).

Steuerungen:

• agents.defaults.blockStreamingDefault: "on"/"off" (standardmäßig aus).
• Kanalüberschreibungen: *.blockStreaming (und Varianten pro Konto), um pro Kanal "on"/"off" zu erzwingen.
• agents.defaults.blockStreamingBreak: "text_end" oder "message_end".
• agents.defaults.blockStreamingChunk: { minChars, maxChars, breakPreference? }.
• agents.defaults.blockStreamingCoalesce: { minChars?, maxChars?, idleMs? } (gestreamte Blöcke vor dem Senden zusammenführen).
• Harte Kanalobergrenze: *.textChunkLimit (z. B. channels.whatsapp.textChunkLimit).
• Kanal-Chunk-Modus: *.chunkMode (length als Standard, newline teilt vor dem Längen-Chunking an Leerzeilen (Absatzgrenzen)).
• Weiche Discord-Obergrenze: channels.discord.maxLinesPerMessage (Standard 17) teilt hohe Antworten, um Abschneiden in der UI zu vermeiden.

Grenzsemantik:

• text_end: Blöcke streamen, sobald der Chunker sie ausgibt; bei jedem text_end flushen.
• message_end: warten, bis die Assistentennachricht fertig ist, dann gepufferte Ausgabe flushen.

message_end verwendet weiterhin den Chunker, wenn der gepufferte Text maxChars überschreitet, sodass am Ende mehrere Chunks ausgegeben werden können.

Medienzustellung mit Block-Streaming

Gestreamte Medien müssen strukturierte Payload-Felder wie mediaUrl oder mediaUrls verwenden; gestreamter Text wird nicht als Anhangsbefehl geparst. Wenn Block-Streaming Medien früh sendet, merkt OpenClaw sich diese Zustellung für den Turn. Wenn der finale Assistenten-Payload dieselbe Medien-URL wiederholt, entfernt die finale Zustellung das doppelte Medium, statt den Anhang erneut zu senden.

Exakt doppelte finale Payloads werden unterdrückt. Wenn der finale Payload eigenständigen Text um Medien herum ergänzt, die bereits gestreamt wurden, sendet OpenClaw weiterhin den neuen Text, während das Medium nur einmal zugestellt wird. Das verhindert doppelte Sprachnachrichten oder Dateien auf Kanälen wie Telegram.

Chunking-Algorithmus (untere/obere Grenzen)

Block-Chunking wird von EmbeddedBlockChunker implementiert:

• Untere Grenze: nicht ausgeben, bis der Puffer >= minChars ist (außer erzwungen).
• Obere Grenze: Splits vor maxChars bevorzugen; wenn erzwungen, bei maxChars splitten.
• Umbruchpräferenz: paragraph → newline → sentence → whitespace → harter Umbruch.
• Code-Fences: nie innerhalb von Fences splitten; wenn bei maxChars erzwungen, Fence schließen + wieder öffnen, damit Markdown gültig bleibt.

maxChars wird auf das textChunkLimit des Kanals begrenzt, Sie können also kanalbezogene Obergrenzen nicht überschreiten.

Zusammenführen (gestreamte Blöcke zusammenführen)

Wenn Block-Streaming aktiviert ist, kann OpenClaw aufeinanderfolgende Block-Chunks zusammenführen, bevor sie gesendet werden. Das reduziert „Einzeilen-Spam“ und bietet trotzdem progressive Ausgabe.

• Zusammenführen wartet vor dem Flushen auf Leerlaufpausen (idleMs).
• Puffer werden durch maxChars begrenzt und werden geflusht, wenn sie diese Grenze überschreiten.
• minChars verhindert, dass winzige Fragmente gesendet werden, bis genug Text angesammelt ist (der finale Flush sendet immer den verbleibenden Text).
• Der Joiner wird aus blockStreamingChunk.breakPreference abgeleitet (paragraph → \n\n, newline → \n, sentence → Leerzeichen).
• Kanalüberschreibungen sind über *.blockStreamingCoalesce verfügbar (einschließlich Konfigurationen pro Konto).
• Der Standardwert für minChars beim Zusammenführen wird für Signal/Slack/Discord auf 1500 angehoben, sofern nicht überschrieben.

Menschlich wirkende Pausen zwischen Blöcken

Wenn Block-Streaming aktiviert ist, können Sie zwischen Blockantworten (nach dem ersten Block) eine zufällige Pause hinzufügen. Dadurch wirken Antworten mit mehreren Sprechblasen natürlicher.

• Konfiguration: agents.defaults.humanDelay (pro Agent über agents.list[].humanDelay überschreiben).
• Modi: off (Standard), natural (800-2500 ms), custom (minMs/maxMs).
• Gilt nur für Blockantworten, nicht für finale Antworten oder Tool-Zusammenfassungen.

„Chunks streamen oder alles“

Dies entspricht:

• Chunks streamen: blockStreamingDefault: "on" + blockStreamingBreak: "text_end" (währenddessen ausgeben). Nicht-Telegram-Kanäle benötigen außerdem *.blockStreaming: true.
• Alles am Ende streamen: blockStreamingBreak: "message_end" (einmal flushen, bei sehr langer Ausgabe möglicherweise mehrere Chunks).
• Kein Block-Streaming: blockStreamingDefault: "off" (nur finale Antwort).

Kanalhinweis: Block-Streaming ist aus, sofern *.blockStreaming nicht explizit auf true gesetzt ist. Kanäle können eine Live-Vorschau streamen (channels.<channel>.streaming), ohne Blockantworten zu verwenden.

Konfigurationshinweis: Die blockStreaming*-Standardwerte befinden sich unter agents.defaults, nicht in der Root-Konfiguration.

Vorschau-Streaming-Modi

Kanonischer Schlüssel: channels.<channel>.streaming

Modi:

• off: Vorschau-Streaming deaktivieren.
• partial: einzelne Vorschau, die durch den neuesten Text ersetzt wird.
• block: Vorschau wird in gechunkten/angehängten Schritten aktualisiert.
• progress: Fortschritts-/Statusvorschau während der Generierung, finale Antwort bei Abschluss.

streaming.mode: "block" ist ein Vorschau-Streaming-Modus für bearbeitungsfähige Kanäle wie Discord und Telegram. Er aktiviert dort keine Blockzustellung im Kanal. Verwenden Sie streaming.block.enabled oder den alten Kanalschlüssel blockStreaming, wenn Sie normale Blockantworten wünschen. Microsoft Teams ist die Ausnahme: Es hat keinen Blocktransport für Entwurfsvorschauen, daher wird streaming.mode: "block" bei Teams auf Blockzustellung statt auf natives Partial-/Progress-Streaming abgebildet.

Kanalzuordnung

Nur Slack:

• channels.slack.streaming.nativeTransport schaltet native Slack-Streaming-API-Aufrufe um, wenn channels.slack.streaming.mode="partial" (Standard: true).
• Natives Slack-Streaming und Slack-Assistenten-Threadstatus erfordern ein Antwort-Thread-Ziel. Top-Level-DMs zeigen diese threadartige Vorschau nicht an, können aber weiterhin Slack-Entwurfsvorschau-Posts und Bearbeitungen verwenden.

Migration alter Schlüssel:

• Telegram: alte streamMode- und skalare/boolesche streaming-Werte werden von Doctor-/Konfigurationskompatibilitätspfaden erkannt und zu streaming.mode migriert.
• Discord: streamMode + boolesches streaming bleiben Laufzeit-Aliasse für das streaming-Enum; führen Sie openclaw doctor --fix aus, um persistierte Konfiguration umzuschreiben.
• Slack: streamMode bleibt ein Laufzeit-Alias für streaming.mode; boolesches streaming bleibt ein Laufzeit-Alias für streaming.mode plus streaming.nativeTransport; das alte nativeStreaming bleibt ein Laufzeit-Alias für streaming.nativeTransport. Führen Sie openclaw doctor --fix aus, um persistierte Konfiguration umzuschreiben.

Laufzeitverhalten

Telegram:

• Verwendet sendMessage + editMessageText-Vorschauaktualisierungen über DMs und Gruppen/Themen hinweg.
• Kurze Initialvorschauen werden für die Push-Benachrichtigungs-UX weiterhin entprellt, aber Telegram materialisiert sie jetzt nach einer begrenzten Verzögerung, damit aktive Läufe nicht visuell stumm bleiben.
• Finaler Text bearbeitet die aktive Vorschau an Ort und Stelle; lange finale Antworten verwenden diese Nachricht für den ersten Chunk wieder und senden nur die verbleibenden Chunks.
• Der Modus block rotiert die Vorschau bei streaming.preview.chunk.maxChars in eine neue Nachricht (Standard 800, begrenzt auf Telegrams Bearbeitungslimit von 4096); andere Modi lassen eine Vorschau auf bis zu 4096 Zeichen wachsen.
• Der Modus progress hält Tool-Fortschritt in einem bearbeitbaren Statusentwurf, materialisiert das Statuslabel, wenn Antwort-Streaming aktiv ist, aber noch keine Tool-Zeile verfügbar ist, löscht diesen Entwurf beim Abschluss und sendet die finale Antwort über die normale Zustellung.
• Wenn die finale Bearbeitung fehlschlägt, bevor der abgeschlossene Text bestätigt ist, verwendet OpenClaw die normale finale Zustellung und bereinigt die veraltete Vorschau.
• Vorschau-Streaming wird übersprungen, wenn Telegram-Block-Streaming explizit aktiviert ist (um doppeltes Streaming zu vermeiden).
• /reasoning stream kann Reasoning in eine transiente Vorschau schreiben, die nach der finalen Zustellung gelöscht wird.

Discord:

• Verwendet Senden + Bearbeiten von Vorschaunachrichten.
• Der Modus block verwendet Entwurfs-Chunking (draftChunk).
• Vorschau-Streaming wird übersprungen, wenn Discord-Block-Streaming explizit aktiviert ist.
• Finale Medien-, Fehler- und explizite Antwort-Payloads brechen ausstehende Vorschauen ab, ohne einen neuen Entwurf zu flushen, und verwenden dann die normale Zustellung.

Slack:

• partial kann natives Slack-Streaming (chat.startStream/append/stop) verwenden, wenn verfügbar.
• block verwendet Entwurfsvorschauen im Append-Stil.
• progress verwendet Statusvorschautext, dann die finale Antwort.
• Top-Level-DMs ohne Antwort-Thread verwenden Entwurfsvorschau-Posts und Bearbeitungen statt nativem Slack-Streaming.
• Natives und Entwurfsvorschau-Streaming unterdrücken Blockantworten für diesen Turn, sodass eine Slack-Antwort nur über einen Zustellungspfad gestreamt wird.
• Finale Medien-/Fehler-Payloads und Progress-Finals erstellen keine Wegwerf-Entwurfsnachrichten; nur Text-/Block-Finals, die die Vorschau bearbeiten können, flushen ausstehenden Entwurfstext.

Mattermost:

• Streamt Denken, Tool-Aktivität und partiellen Antworttext in einen einzelnen Entwurfsvorschau-Post, der an Ort und Stelle finalisiert wird, wenn die finale Antwort sicher gesendet werden kann.
• Fällt auf das Senden eines frischen finalen Posts zurück, wenn der Vorschau-Post gelöscht wurde oder zum Finalisierungszeitpunkt anderweitig nicht verfügbar ist.
• Finale Medien-/Fehler-Payloads brechen ausstehende Vorschauaktualisierungen vor der normalen Zustellung ab, statt einen temporären Vorschau-Post zu flushen.

Matrix:

• Entwurfsvorschauen werden an Ort und Stelle finalisiert, wenn der finale Text das Vorschauereignis wiederverwenden kann.
• Reine Medien-, Fehler- und Antwortziel-Konflikt-Finals brechen ausstehende Vorschauaktualisierungen vor der normalen Zustellung ab; eine bereits sichtbare veraltete Vorschau wird redigiert.

Tool-Fortschrittsvorschau-Aktualisierungen

Vorschau-Streaming kann auch Tool-Fortschritts-Aktualisierungen enthalten - kurze Statuszeilen wie „Web durchsuchen“, „Datei lesen“ oder „Tool aufrufen“ -, die in derselben Vorschaunachricht erscheinen, während Tools ausgeführt werden, vor der finalen Antwort. Im Codex-App-Server-Modus verwenden Codex-Präambel-/Kommentarnachrichten denselben Vorschaupfad, sodass kurze Fortschrittsnotizen wie „Ich prüfe ...“ in den bearbeitbaren Entwurf streamen können, ohne Teil der finalen Antwort zu werden. Dadurch bleiben mehrstufige Tool-Turns visuell aktiv, statt zwischen der ersten Denk-Vorschau und der finalen Antwort stumm zu sein.

Lang laufende Tools können typisierten Fortschritt ausgeben, bevor sie zurückkehren. Zum Beispiel aktiviert web_fetch beim Start einen Fünf-Sekunden-Timer: Wenn der Fetch noch aussteht, kann die Vorschau Fetching page content... anzeigen; wenn der Fetch vorher abgeschlossen oder abgebrochen wird, wird keine Fortschrittszeile ausgegeben. Das spätere finale Tool- Ergebnis wird weiterhin normal an das Modell geliefert.

Unterstützte Oberflächen:

• Discord, Slack, Telegram und Matrix streamen Tool-Fortschritt und Codex-Präambel-Updates standardmäßig in die Live-Vorschau-Bearbeitung, wenn Vorschau-Streaming aktiv ist. Microsoft Teams verwendet in persönlichen Chats seinen nativen Fortschrittsstream.
• Telegram wird seit v2026.4.22 mit aktivierten Vorschau-Updates für Tool-Fortschritt ausgeliefert; sie aktiviert zu lassen, erhält dieses veröffentlichte Verhalten.
• Mattermost bindet Tool-Aktivität bereits in seinen einzelnen Entwurfs-Vorschau-Beitrag ein (siehe oben).
• Bearbeitungen für Tool-Fortschritt folgen dem aktiven Vorschau-Streaming-Modus; sie werden übersprungen, wenn Vorschau-Streaming off ist oder wenn Block-Streaming die Nachricht übernommen hat. Auf Telegram ist streaming.mode: "off" nur final: generisches Fortschrittsrauschen wird ebenfalls unterdrückt, statt als eigenständige Statusnachrichten zugestellt zu werden, während Genehmigungsaufforderungen, Medien-Payloads und Fehler weiterhin normal geroutet werden.
• Um Vorschau-Streaming beizubehalten, aber Tool-Fortschrittszeilen auszublenden, setzen Sie streaming.preview.toolProgress für diesen Kanal auf false. Um Tool-Fortschrittszeilen sichtbar zu lassen, während Befehls-/Ausführungstext ausgeblendet wird, setzen Sie streaming.preview.commandText auf "status" oder streaming.progress.commandText auf "status"; der Standardwert ist "raw", um veröffentlichtes Verhalten beizubehalten. Diese Richtlinie wird von Entwurfs-/Fortschrittskanälen gemeinsam genutzt, die den kompakten Fortschritts-Renderer von OpenClaw verwenden, darunter Discord, Matrix, Microsoft Teams, Mattermost, Slack-Entwurfsvorschauen und Telegram. Um Vorschau-Bearbeitungen vollständig zu deaktivieren, setzen Sie streaming.mode auf off.
• Ausgewählte Zitatantworten in Telegram sind eine Ausnahme: Wenn replyToMode nicht "off" ist und ausgewählter Zitattext vorhanden ist, überspringt OpenClaw den Antwort-Vorschaustream für diesen Turn, sodass Vorschauzeilen für Tool-Fortschritt nicht gerendert werden können. Antworten auf die aktuelle Nachricht ohne ausgewählten Zitattext behalten Vorschau-Streaming weiterhin bei. Details finden Sie in der Telegram-Kanaldokumentation.

Commentary-Fortschrittsspur

Über Tool-Fortschritt hinaus kann der kompakte Fortschritts-Renderer eine weitere Spur im Entwurf anzeigen:

• streaming.progress.commentary — rendert den commentary des Modells vor dem Tool (💬) — kurze „Ich prüfe … dann …“-Erzählung — verschachtelt mit Tool-Zeilen im Fortschrittsentwurf.

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

Fortschrittszeilen sichtbar lassen, aber rohen Befehls-/Ausführungstext ausblenden:

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

Verwenden Sie dieselbe Struktur unter einem anderen kompakten Fortschrittskanalschlüssel, zum Beispiel channels.discord, channels.matrix, channels.msteams, channels.mattermost oder Slack-Entwurfsvorschauen. Platzieren Sie für den Fortschrittsentwurfsmodus dieselbe Richtlinie unter streaming.progress:

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

Verwandt

• Refaktorierung des Nachrichtenlebenszyklus - Zielentwurf für gemeinsame Vorschau, Bearbeitung, Stream und Finalisierung
• Fortschrittsentwürfe - sichtbare Work-in-Progress-Nachrichten, die während langer Turns aktualisiert werden
• Nachrichten - Nachrichtenlebenszyklus und Zustellung
• Wiederholen - Wiederholungsverhalten bei Zustellungsfehlern
• Kanäle - Streaming-Unterstützung pro Kanal