Streaming en chunking

• Blokstreaming (kanalen): verstuur voltooide blokken terwijl de assistant schrijft. Dit zijn normale kanaalberichten (geen token-delta’s).
• Preview-streaming (Telegram/Discord/Slack): werk een tijdelijk previewbericht bij tijdens het genereren.

​

Blokstreaming (kanaalberichten)

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: modelstreamgebeurtenissen (kunnen schaars zijn voor niet-streamende modellen).
• chunker: EmbeddedBlockChunker die min/max-grenzen + breukvoorkeur toepast.
• channel send: daadwerkelijke uitgaande berichten (blokantwoorden).

• agents.defaults.blockStreamingDefault: "on"/"off" (standaard uit).
• Kanaaloverrides: *.blockStreaming (en varianten per account) om "on"/"off" per kanaal af te dwingen.
• agents.defaults.blockStreamingBreak: "text_end" of "message_end".
• agents.defaults.blockStreamingChunk: { minChars, maxChars, breakPreference? }.
• agents.defaults.blockStreamingCoalesce: { minChars?, maxChars?, idleMs? } (voeg gestreamde blokken samen vóór verzending).
• Harde kanaallimiet: *.textChunkLimit (bijv. channels.whatsapp.textChunkLimit).
• Kanaalchunkmodus: *.chunkMode (length standaard, newline splitst op lege regels (alinea-grenzen) vóór chunking op lengte).
• Zachte Discord-limiet: channels.discord.maxLinesPerMessage (standaard 17) splitst hoge antwoorden om UI-afkapping te voorkomen.

• text_end: stream blokken zodra de chunker ze uitgeeft; flush bij elke text_end.
• message_end: wacht tot het assistantbericht klaar is en flush dan de gebufferde uitvoer.

​

Medialevering met blokstreaming

​

Chunking-algoritme (lage/hoge grenzen)

• Lage grens: geef niets uit totdat buffer >= minChars (tenzij geforceerd).
• Hoge grens: geef de voorkeur aan splitsingen vóór maxChars; indien geforceerd, splits op maxChars.
• Breukvoorkeur: paragraph → newline → sentence → whitespace → harde breuk.
• Code fences: splits nooit binnen fences; wanneer geforceerd op maxChars, sluit + heropen de fence om Markdown geldig te houden.

​

Samenvoegen (gestreamde blokken samenvoegen)

• Samenvoegen wacht op inactieve pauzes (idleMs) voordat er wordt geflusht.
• Buffers worden begrensd door maxChars en worden geflusht als ze die overschrijden.
• minChars voorkomt dat kleine fragmenten worden verzonden totdat er genoeg tekst is verzameld (de definitieve flush verzendt altijd resterende tekst).
• De joiner wordt afgeleid van blockStreamingChunk.breakPreference (paragraph → \n\n, newline → \n, sentence → spatie).
• Kanaaloverrides zijn beschikbaar via *.blockStreamingCoalesce (inclusief configuraties per account).
• De standaard coalesce-minChars wordt verhoogd naar 1500 voor Signal/Slack/Discord tenzij overschreven.

​

Menselijk tempo tussen blokken

• Configuratie: agents.defaults.humanDelay (per agent te overschrijven via agents.list[].humanDelay).
• Modi: off (standaard), natural (800-2500 ms), custom (minMs/maxMs).
• Geldt alleen voor blokantwoorden, niet voor definitieve antwoorden of toolsamenvattingen.

​

”Chunks streamen of alles”

• Chunks streamen: blockStreamingDefault: "on" + blockStreamingBreak: "text_end" (uitgeven terwijl je gaat). Niet-Telegram-kanalen hebben ook *.blockStreaming: true nodig.
• Alles aan het einde streamen: blockStreamingBreak: "message_end" (één keer flushen, mogelijk meerdere chunks als het erg lang is).
• Geen blokstreaming: blockStreamingDefault: "off" (alleen definitief antwoord).

​

Preview-streamingmodi

• off: preview-streaming uitschakelen.
• partial: één preview die wordt vervangen door de nieuwste tekst.
• block: preview-updates in gechunkte/toegevoegde stappen.
• progress: voortgangs-/statuspreview tijdens generatie, definitief antwoord bij voltooiing.

​

Kanaaltoewijzing

• channels.slack.streaming.nativeTransport schakelt native Slack-streaming-API-aanroepen in of uit wanneer channels.slack.streaming.mode="partial" (standaard: true).
• Native Slack-streaming en Slack-assistant-threadstatus vereisen een antwoordthreaddoel. DM’s op het hoogste niveau tonen die thread-achtige preview niet, maar kunnen nog steeds Slack-conceptpreviewposts en bewerkingen gebruiken.

• Telegram: legacy streamMode en scalaire/booleaanse streaming-waarden worden gedetecteerd en gemigreerd door doctor-/configcompatibiliteitspaden naar streaming.mode.
• Discord: streamMode + booleaanse streaming blijven runtime-aliassen voor de streaming-enum; voer openclaw doctor --fix uit om persistente configuratie te herschrijven.
• Slack: streamMode blijft een runtime-alias voor streaming.mode; booleaanse streaming blijft een runtime-alias voor streaming.mode plus streaming.nativeTransport; legacy nativeStreaming blijft een runtime-alias voor streaming.nativeTransport. Voer openclaw doctor --fix uit om persistente configuratie te herschrijven.

​

Runtimegedrag

• Gebruikt sendMessage + editMessageText preview-updates in DM’s en groepen/topics.
• Korte initiële previews worden nog steeds gedebounced voor pushnotificatie-UX, maar Telegram materialiseert ze nu na een begrensde vertraging zodat actieve runs niet visueel stil blijven.
• Definitieve tekst bewerkt de actieve preview ter plekke; lange definitieve antwoorden hergebruiken dat bericht voor de eerste chunk en verzenden alleen de resterende chunks.
• block-modus roteert de preview naar een nieuw bericht bij streaming.preview.chunk.maxChars (standaard 800, begrensd op Telegrams bewerkingslimiet van 4096); andere modi laten één preview groeien tot 4096 tekens.
• progress-modus houdt toolvoortgang in een bewerkbaar statusconcept, materialiseert het statuslabel wanneer antwoordstreaming actief is maar er nog geen toolregel beschikbaar is, wist dat concept bij voltooiing en verzendt het definitieve antwoord via normale levering.
• Als de definitieve bewerking mislukt voordat de voltooide tekst is bevestigd, gebruikt OpenClaw normale definitieve levering en ruimt de verouderde preview op.
• Preview-streaming wordt overgeslagen wanneer Telegram-blokstreaming expliciet is ingeschakeld (om dubbel streamen te voorkomen).
• /reasoning stream kan redenering naar een tijdelijke preview schrijven die na definitieve levering wordt verwijderd.

• Gebruikt verzenden + bewerken van previewberichten.
• block-modus gebruikt conceptchunking (draftChunk).
• Preview-streaming wordt overgeslagen wanneer Discord-blokstreaming expliciet is ingeschakeld.
• Definitieve media-, fout- en expliciete-antwoordpayloads annuleren wachtende previews zonder een nieuw concept te flushen en gebruiken daarna normale levering.

• partial kan native Slack-streaming gebruiken (chat.startStream/append/stop) wanneer beschikbaar.
• block gebruikt conceptpreviews in append-stijl.
• progress gebruikt statuspreviewtekst en daarna het definitieve antwoord.
• DM’s op het hoogste niveau zonder antwoordthread gebruiken conceptpreviewposts en bewerkingen in plaats van native Slack-streaming.
• Native en conceptpreview-streaming onderdrukken blokantwoorden voor die beurt, zodat een Slack-antwoord slechts via één leveringspad wordt gestreamd.
• Definitieve media-/foutpayloads en voortgangsfinals maken geen tijdelijke conceptberichten aan; alleen tekst-/blokfinals die de preview kunnen bewerken flushen wachtende concepttekst.

• Streamt denken, toolactiviteit en gedeeltelijke antwoordtekst naar één conceptpreviewpost die ter plekke wordt afgerond wanneer het definitieve antwoord veilig kan worden verzonden.
• Valt terug op het verzenden van een nieuwe definitieve post als de previewpost is verwijderd of anderszins niet beschikbaar is op het moment van afronding.
• Definitieve media-/foutpayloads annuleren wachtende preview-updates vóór normale levering in plaats van een tijdelijke previewpost te flushen.

• Conceptpreviews worden ter plekke afgerond wanneer de definitieve tekst de previewgebeurtenis kan hergebruiken.
• Finals met alleen media, fouten en mismatch in antwoorddoel annuleren wachtende preview-updates vóór normale levering; een al zichtbare verouderde preview wordt geredigeerd.

​

Toolvoortgang-previewupdates

• Discord, Slack, Telegram en Matrix streamen standaard toolvoortgang en Codex-preamble-updates naar de live-previewbewerking wanneer preview-streaming actief is. Microsoft Teams gebruikt zijn native voortgangsstream in persoonlijke chats.
• Telegram wordt sinds v2026.4.22 geleverd met ingeschakelde preview-updates voor toolvoortgang; als ze ingeschakeld blijven, blijft dat uitgebrachte gedrag behouden.
• Mattermost vouwt toolactiviteit al samen in zijn enkele conceptpreviewbericht (zie hierboven).
• Toolvoortgangsbewerkingen volgen de actieve preview-streamingmodus; ze worden overgeslagen wanneer preview-streaming off is of wanneer blokstreaming het bericht heeft overgenomen. Op Telegram is streaming.mode: "off" alleen-eindantwoord: generiek voortgangsgeklets wordt ook onderdrukt in plaats van als zelfstandige statusberichten te worden geleverd, terwijl goedkeuringsprompts, mediapayloads en fouten normaal blijven routeren.
• Als je preview-streaming wilt behouden maar toolvoortgangsregels wilt verbergen, stel je streaming.preview.toolProgress voor dat kanaal in op false. Als je toolvoortgangsregels zichtbaar wilt houden terwijl je opdracht-/exec-tekst verbergt, stel je streaming.preview.commandText in op "status" of streaming.progress.commandText op "status"; de standaardwaarde is "raw" om uitgebracht gedrag te behouden. Dit beleid wordt gedeeld door concept-/voortgangskanalen die OpenClaw’s compacte voortgangsrenderer gebruiken, waaronder Discord, Matrix, Microsoft Teams, Mattermost, Slack-conceptpreviews en Telegram. Als je previewbewerkingen volledig wilt uitschakelen, stel je streaming.mode in op off.
• Geselecteerde quote-antwoorden in Telegram zijn een uitzondering: wanneer replyToMode niet "off" is en geselecteerde quote-tekst aanwezig is, slaat OpenClaw de antwoordpreviewstream voor die beurt over, zodat previewregels voor toolvoortgang niet kunnen renderen. Antwoorden op het huidige bericht zonder geselecteerde quote-tekst behouden preview-streaming wel. Zie Telegram-kanaaldocumentatie voor details.

​

Commentaarvoortgangslane

• streaming.progress.commentary — render de commentary van het model vóór tools (💬) — korte “Ik controleer… daarna…”-vertelling — verweven met toolregels in het voortgangsconcept.

{
  "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"
        }
      }
    }
  }
}

​

Gerelateerd

• Berichtlevenscyclusrefactor - doelontwerp voor gedeelde preview, bewerking, stream en finalisatie
• Voortgangsconcepten - zichtbare onderhanden-werkberichten die tijdens lange beurten worden bijgewerkt
• Berichten - berichtlevenscyclus en levering
• Opnieuw proberen - gedrag voor opnieuw proberen bij leveringsfout
• Kanalen - streamingondersteuning per kanaal