Потоковая передача и разбиение на части

• Потоковая передача блоков (каналы): отправляет завершённые блоки по мере того, как ассистент формирует ответ. Это обычные сообщения канала, а не дельты токенов.
• Потоковый предпросмотр (Telegram/Discord/Slack/Matrix/Mattermost/MS Teams): обновляет временное сообщение предпросмотра во время генерации (отправка + редактирование/добавление).

​

Потоковая передача блоков (сообщения канала)

Вывод модели
  └─ text_delta/события
       ├─ (blockStreamingBreak=text_end)
       │    └─ средство разбиения выдаёт блоки по мере роста буфера
       └─ (blockStreamingBreak=message_end)
            └─ средство разбиения сбрасывает буфер при message_end
                   └─ отправка в канал (блочные ответы)

• text_delta/events: события потока модели (могут быть редкими для непотоковых моделей).
• chunker: EmbeddedBlockChunker с применением минимальной/максимальной границы и предпочтительного места разрыва.
• channel send: фактически отправляемые сообщения (блочные ответы).

• text_end: передавать блоки сразу после их выдачи средством разбиения; сбрасывать при каждом text_end.
• message_end: ждать завершения сообщения ассистента, затем сбрасывать накопленный вывод. Если накопленный текст превышает maxChars, по-прежнему используется средство разбиения, поэтому в конце может быть отправлено несколько фрагментов.

​

Доставка медиафайлов при потоковой передаче блоков

​

Алгоритм разбиения (нижняя/верхняя границы)

• Нижняя граница: не отправлять, пока размер буфера не достигнет minChars (кроме принудительной отправки).
• Верхняя граница: предпочитать разрывы до maxChars; при принудительном разрыве разделять на maxChars.
• Цепочка предпочтений для разрыва: paragraph -> newline -> sentence -> пробельный символ -> жёсткий разрыв.
• Блоки кода: никогда не разделять внутри ограждений; при принудительном разрыве на maxChars закрывать и повторно открывать ограждение, чтобы сохранить корректность Markdown.

​

Объединение (слияние потоковых блоков)

• Перед сбросом объединение ожидает периоды бездействия (idleMs).
• Размер буферов ограничен значением maxChars; при его превышении буферы сбрасываются.
• minChars предотвращает отправку мелких фрагментов, пока не накопится достаточно текста (при итоговом сбросе оставшийся текст отправляется всегда).
• Разделитель определяется значением blockStreamingChunk.breakPreference: paragraph -> \n\n, newline -> \n, sentence -> пробел.
• Переопределения для каналов доступны через *.streaming.block.coalesce (включая конфигурации отдельных учётных записей).
• Для Discord, Signal и Slack объединение по умолчанию имеет значение { minChars: 1500, idleMs: 1000 }, если оно не переопределено.

​

Имитация естественных пауз между блоками

​

«Передавать фрагменты или всё целиком»

• Передавать фрагменты: blockStreamingDefault: "on" + blockStreamingBreak: "text_end" (отправлять по мере готовности). Для каналов, кроме Telegram, также требуется *.streaming.block.enabled: true.
• Передать всё в конце: blockStreamingBreak: "message_end" (однократный сброс, возможно с несколькими фрагментами, если текст очень длинный).
• Без потоковой передачи блоков: blockStreamingDefault: "off" (только итоговый ответ).

​

Режимы потокового предпросмотра

​

Сопоставление каналов

• channels.slack.streaming.nativeTransport включает или отключает вызовы встроенного API потоковой передачи Slack (chat.startStream/chat.appendStream/chat.stopStream), когда channels.slack.streaming.mode="partial" (по умолчанию: true).
• Для встроенной потоковой передачи Slack и состояния ветки ассистента Slack требуется целевая ветка ответа. Личные сообщения верхнего уровня не показывают такой предпросмотр в виде ветки, но всё равно могут использовать публикации и редактирование черновика предпросмотра Slack.

​

Миграция устаревших ключей

​

Поведение во время выполнения

​

Telegram

• Использует обновления предпросмотра sendMessage + editMessageText в личных сообщениях и группах/темах; итоговый текст редактирует активный предпросмотр на месте. В Telegram эфемерные 30-секундные черновики «набора текста» (sendMessageDraft) не используются для потоковой передачи ответа.
• Короткие начальные предпросмотры по-прежнему обрабатываются с задержкой для удобства push-уведомлений, но появляются по истечении ограниченной задержки, чтобы активные запуски не оставались визуально безмолвными.
• Для длинных итоговых ответов сообщение предпросмотра повторно используется для первого фрагмента, а отправляются только оставшиеся фрагменты.
• Режим block переносит предпросмотр в новое сообщение при streaming.preview.chunk.maxChars (по умолчанию 800, с ограничением по лимиту редактирования Telegram в 4096); в других режимах один предпросмотр увеличивается до 4096 символов.
• Режим progress сохраняет ход выполнения инструментов в редактируемом черновике состояния, отображает метку состояния, когда потоковая передача ответа активна, но строка инструмента ещё недоступна, очищает черновик по завершении и отправляет итоговый ответ через обычный механизм доставки.
• Если итоговое редактирование завершается с ошибкой до подтверждения завершённого текста, OpenClaw использует обычную доставку итогового ответа и удаляет устаревший предпросмотр.
• Потоковая передача предпросмотра пропускается, когда потоковая передача блоков Telegram явно включена, чтобы избежать двойной потоковой передачи.
• /reasoning stream может выводить рассуждения во временный предпросмотр, который удаляется после доставки итогового ответа.
• Ответы с выбранной цитатой в Telegram являются исключением: когда replyToMode не равно "off" и присутствует текст выбранной цитаты, OpenClaw пропускает потоковую передачу предпросмотра ответа для этого хода (итоговый ответ должен пройти через нативный механизм ответа с цитатой), поэтому строки предпросмотра хода выполнения инструментов не отображаются. Для ответов на текущее сообщение без текста выбранной цитаты потоковая передача предпросмотра сохраняется. Подробности см. в документации канала Telegram.

​

Discord

• Использует отправку и редактирование сообщений предпросмотра.
• Режим block использует разбиение черновика на фрагменты (draftChunk).
• Потоковая передача предпросмотра пропускается, когда потоковая передача блоков Discord явно включена.
• Режим progress добавляет к итоговому ответу небольшую квитанцию активности -# (число размышлений/вызовов инструментов и прошедшее время) и удаляет черновик состояния после доставки ответа, чтобы в активных каналах над ответом не оставался осиротевший журнал инструментов. При итоговом ответе с ошибкой черновик сохраняется как запись неудачного хода.
• Итоговые данные с медиа, ошибками и явными ответами отменяют ожидающие предпросмотры, не отправляя новый черновик, а затем используют обычную доставку.

​

Slack

• partial может использовать нативную потоковую передачу Slack (chat.startStream/append/stop), когда она доступна.
• block использует предпросмотры черновиков с добавлением текста.
• progress использует текст предпросмотра состояния, а затем итоговый ответ.
• Личные сообщения верхнего уровня без ветки ответов используют публикацию и редактирование черновиков предпросмотра вместо нативной потоковой передачи Slack.
• Нативная потоковая передача и потоковая передача предпросмотра черновика подавляют блочные ответы для этого хода, поэтому ответ Slack передаётся только по одному пути доставки.
• Итоговые данные с медиа/ошибками и итоговые сообщения о ходе выполнения не создают одноразовые сообщения-черновики; ожидающий текст черновика отправляют только итоговые текстовые/блочные сообщения, способные отредактировать предпросмотр.

​

Mattermost

• В режиме partial потоково передаёт размышления и частичный текст ответа в одну публикацию-черновик предпросмотра, которая окончательно оформляется на месте, когда итоговый ответ можно безопасно отправить.
• В режиме progress потоково передаёт размышления и активность инструментов в один предпросмотр состояния, который окончательно оформляется на месте, когда итоговый ответ можно безопасно отправить.
• В режиме block чередует публикации с завершённым текстом и активностью инструментов; параллельные и последовательные обновления инструментов используют текущую публикацию активности инструментов.
• Если публикация предпросмотра была удалена или по иной причине недоступна во время завершения, вместо неё отправляется новая итоговая публикация.
• Итоговые данные с медиа/ошибками отменяют ожидающие обновления предпросмотра перед обычной доставкой вместо отправки временной публикации предпросмотра.

​

Matrix

• Черновики предпросмотра окончательно оформляются на месте, когда итоговый текст может повторно использовать событие предпросмотра.
• Итоговые сообщения только с медиа, с ошибкой или с несовпадающей целью ответа отменяют ожидающие обновления предпросмотра перед обычной доставкой; уже видимый устаревший предпросмотр удаляется.

​

Обновления предпросмотра хода выполнения инструментов

• Discord, Slack, Telegram и Matrix по умолчанию потоково передают ход выполнения инструментов и обновления преамбулы Codex в редактируемый активный предпросмотр, когда потоковая передача предпросмотра включена. Microsoft Teams использует свой нативный поток хода выполнения в личных чатах.
• Telegram поставляется с включёнными обновлениями предпросмотра хода выполнения инструментов начиная с v2026.4.22; сохранение их включёнными обеспечивает совместимость с выпущенным поведением.
• Mattermost объединяет активность инструментов в одну публикацию предпросмотра в режимах partial и progress либо в одну публикацию активности инструментов между текстовыми блоками в режиме block (см. выше).
• Редактирование хода выполнения инструментов следует активному режиму потоковой передачи предпросмотра; оно пропускается, когда потоковая передача предпросмотра имеет значение 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.

​

Отображение черновика хода выполнения

​

Канал комментариев о ходе выполнения

• streaming.progress.commentary — отображать предварительные комментарии модели перед использованием инструментов (короткое описание действий вроде «Проверю… затем…») вперемежку со строками инструментов в черновике хода выполнения. В Discord и Telegram в режиме хода выполнения та же преамбула формирует заголовок состояния, даже если этот необязательный канал выключен; другие каналы сохраняют существующее поведение хода выполнения. См. Черновики хода выполнения.

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

​

Связанные материалы

• Рефакторинг жизненного цикла сообщений — целевая общая архитектура предпросмотра, редактирования, потоковой передачи и завершения
• Черновики хода выполнения — видимые сообщения о выполняемой работе, обновляемые во время длительных ходов
• Сообщения — жизненный цикл и доставка сообщений
• Повторные попытки — поведение повторных попыток при сбое доставки
• Каналы — поддержка потоковой передачи для каждого канала