​

스트리밍 + 청킹

• 블록 스트리밍 (채널): 어시스턴트가 작성하는 동안 완료된 블록을 방출합니다. 이는 토큰 델타가 아닌 일반 채널 메시지입니다.
• 토큰 유사 스트리밍 (Telegram 전용): 생성 중에 부분 텍스트로 초안 버블을 업데이트하며, 최종 메시지는 끝에 전송됩니다.

​

블록 스트리밍 (채널 메시지)

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" (기본값 꺼짐).
• 채널 재정의: 채널별로 "on"/"off" 을 강제하기 위한 *.blockStreaming (계정별 변형 포함).
• 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: 어시스턴트 메시지가 끝날 때까지 기다린 다음 버퍼링된 출력을 플러시합니다.

​

청킹 알고리즘 (저/고 경계)

• 하한: 버퍼가 minChars 이상이 될 때까지 방출하지 않습니다 (강제되지 않는 한).
• 상한: maxChars 이전에서 분할을 선호하며, 강제 시 maxChars 에서 분할합니다.
• 분할 선호도: paragraph → newline → sentence → whitespace → 하드 분할.
• 코드 펜스: 펜스 내부에서는 절대 분할하지 않으며, maxChars 에서 강제될 경우 Markdown 유효성을 유지하기 위해 펜스를 닫았다가 다시 엽니다.

​

병합 (스트리밍된 블록 병합)

• 병합은 플러시 전에 유휴 간격 (idleMs) 을 기다립니다.
• 버퍼는 maxChars 로 제한되며, 이를 초과하면 플러시됩니다.
• minChars 는 충분한 텍스트가 누적될 때까지 작은 조각의 전송을 방지합니다 (최종 플러시는 항상 남은 텍스트를 전송합니다).
• 조인 문자열은 blockStreamingChunk.breakPreference 에서 파생됩니다 (paragraph → \n\n, newline → \n, sentence → 공백).
• 채널 재정의는 *.blockStreamingCoalesce (계정별 설정 포함) 을 통해 사용할 수 있습니다.
• 기본 병합 minChars 은 재정의되지 않는 한 Signal/Slack/Discord 에 대해 1500 으로 상향됩니다.

​

블록 간 사람 같은 페이싱

• 설정: agents.defaults.humanDelay (에이전트별로 agents.list[].humanDelay 를 통해 재정의).
• 모드: off (기본값), natural (800–2500ms), custom (minMs/maxMs).
• 블록 응답에만 적용되며, 최종 응답이나 도구 요약에는 적용되지 않습니다.

​

‘청크를 스트림할지 전체를 보낼지’

• 청크 스트림: blockStreamingDefault: "on" + blockStreamingBreak: "text_end" (진행하면서 방출). Telegram 이 아닌 채널도 *.blockStreaming: true 이 필요합니다.
• 끝에서 모두 스트림: blockStreamingBreak: "message_end" (한 번 플러시하며, 매우 길 경우 여러 청크일 수 있음).
• 블록 스트리밍 없음: blockStreamingDefault: "off" (최종 응답만).

​

Telegram 초안 스트리밍 (토큰 유사)

• Bot API sendMessage(첫 업데이트) + editMessageText(이후 업데이트)를 사용합니다.
• channels.telegram.streamMode: "partial" | "block" | "off".
  • partial: 최신 스트림 텍스트로 초안을 업데이트합니다.
  • block: 청킹된 블록으로 초안을 업데이트합니다 (동일한 청커 규칙).
  • off: 초안 스트리밍 없음.
• 초안 청크 설정 (streamMode: "block" 전용): channels.telegram.draftChunk (기본값: minChars: 200, maxChars: 800).
• 미리보기 스트리밍은 블록 스트리밍과 별개입니다.
• 초안 스트리밍이 활성화되면, OpenClaw 는 이중 스트리밍을 피하기 위해 해당 응답에 대해 블록 스트리밍을 비활성화합니다.
• 텍스트 전용 final은 미리보기 메시지를 해당 위치에서 직접 수정하여 적용됩니다.
• 텍스트가 아니거나 복잡한 final은 일반적인 최종 메시지 전송 방식으로 대체됩니다.
• /reasoning stream 는 추론을 초안 버블에 기록합니다 (Telegram 전용).

Telegram (private + topics)
  └─ sendMessageDraft (draft bubble)
       ├─ streamMode=partial → update latest text
       └─ streamMode=block   → chunker updates draft
  └─ final reply → normal message

• preview message: 생성 중에 업데이트되는 임시 Telegram 메시지.
• final edit: 동일한 미리보기 메시지에서 수행되는 직접 수정(텍스트 전용).