Phát trực tuyến và chia khối

• Streaming theo khối (kênh): phát ra các khối hoàn chỉnh khi assistant viết. Đây là các tin nhắn kênh bình thường (không phải delta token).
• Streaming bản xem trước (Telegram/Discord/Slack): cập nhật một tin nhắn xem trước tạm thời trong khi tạo nội dung.

​

Streaming theo khối (tin nhắn kênh)

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: sự kiện stream của mô hình (có thể thưa thớt với các mô hình không streaming).
• chunker: EmbeddedBlockChunker áp dụng giới hạn tối thiểu/tối đa + ưu tiên điểm ngắt.
• channel send: các tin nhắn gửi ra thực tế (phản hồi theo khối).

• agents.defaults.blockStreamingDefault: "on"/"off" (mặc định tắt).
• Ghi đè theo kênh: *.blockStreaming (và các biến thể theo tài khoản) để buộc "on"/"off" cho từng kênh.
• agents.defaults.blockStreamingBreak: "text_end" hoặc "message_end".
• agents.defaults.blockStreamingChunk: { minChars, maxChars, breakPreference? }.
• agents.defaults.blockStreamingCoalesce: { minChars?, maxChars?, idleMs? } (gộp các khối được stream trước khi gửi).
• Giới hạn cứng của kênh: *.textChunkLimit (ví dụ: channels.whatsapp.textChunkLimit).
• Chế độ chia đoạn của kênh: *.chunkMode (length mặc định, newline tách theo dòng trống (ranh giới đoạn văn) trước khi chia theo độ dài).
• Giới hạn mềm của Discord: channels.discord.maxLinesPerMessage (mặc định 17) tách các phản hồi cao để tránh bị cắt trong UI.

• text_end: stream các khối ngay khi chunker phát ra; xả sau mỗi text_end.
• message_end: đợi đến khi tin nhắn assistant hoàn tất, rồi xả đầu ra đã đệm.

​

Phân phối phương tiện với streaming theo khối

​

Thuật toán chia đoạn (giới hạn thấp/cao)

• Giới hạn thấp: không phát ra cho đến khi bộ đệm >= minChars (trừ khi bị buộc).
• Giới hạn cao: ưu tiên tách trước maxChars; nếu bị buộc, tách tại maxChars.
• Ưu tiên điểm ngắt: paragraph → newline → sentence → whitespace → ngắt cứng.
• Khối mã: không bao giờ tách bên trong khối mã; khi bị buộc tại maxChars, đóng + mở lại khối mã để giữ Markdown hợp lệ.

​

Gộp (hợp nhất các khối được stream)

• Gộp chờ các khoảng nghỉ không hoạt động (idleMs) trước khi xả.
• Bộ đệm bị giới hạn bởi maxChars và sẽ xả nếu vượt quá giới hạn đó.
• minChars ngăn các mảnh quá nhỏ được gửi cho đến khi tích lũy đủ văn bản (lần xả cuối luôn gửi phần văn bản còn lại).
• Dấu nối được suy ra từ blockStreamingChunk.breakPreference (paragraph → \n\n, newline → \n, sentence → dấu cách).
• Có thể ghi đè theo kênh qua *.blockStreamingCoalesce (bao gồm cấu hình theo tài khoản).
• minChars gộp mặc định được tăng lên 1500 cho Signal/Slack/Discord trừ khi được ghi đè.

​

Nhịp tự nhiên giữa các khối

• Cấu hình: agents.defaults.humanDelay (ghi đè theo từng agent qua agents.list[].humanDelay).
• Chế độ: off (mặc định), natural (800-2500ms), custom (minMs/maxMs).
• Chỉ áp dụng cho phản hồi theo khối, không áp dụng cho phản hồi cuối cùng hoặc tóm tắt công cụ.

​

”Stream các đoạn hay toàn bộ”

• Truyền phát từng đoạn: blockStreamingDefault: "on" + blockStreamingBreak: "text_end" (phát ra khi có nội dung). Các kênh không phải Telegram cũng cần *.blockStreaming: true.
• Truyền phát mọi thứ ở cuối: blockStreamingBreak: "message_end" (xả một lần, có thể thành nhiều đoạn nếu rất dài).
• Không truyền phát block: blockStreamingDefault: "off" (chỉ trả lời cuối cùng).

​

Chế độ truyền phát bản xem trước

• off: tắt truyền phát bản xem trước.
• partial: một bản xem trước duy nhất được thay thế bằng văn bản mới nhất.
• block: bản xem trước cập nhật theo các bước chia đoạn/nối thêm.
• progress: bản xem trước tiến độ/trạng thái trong khi tạo, câu trả lời cuối cùng khi hoàn tất.

​

Ánh xạ kênh

• channels.slack.streaming.nativeTransport bật/tắt các lệnh gọi API truyền phát gốc của Slack khi channels.slack.streaming.mode="partial" (mặc định: true).
• Truyền phát gốc của Slack và trạng thái chuỗi trợ lý Slack yêu cầu mục tiêu chuỗi trả lời. DM cấp cao nhất không hiển thị bản xem trước kiểu chuỗi đó, nhưng vẫn có thể dùng bài đăng bản xem trước nháp và chỉnh sửa của Slack.

• Telegram: các giá trị cũ streamMode và streaming dạng vô hướng/boolean được phát hiện và di chuyển bởi các đường dẫn tương thích doctor/config sang streaming.mode.
• Discord: streamMode + streaming boolean vẫn là alias runtime cho enum streaming; chạy openclaw doctor --fix để ghi lại cấu hình đã lưu.
• Slack: streamMode vẫn là alias runtime cho streaming.mode; streaming boolean vẫn là alias runtime cho streaming.mode cộng với streaming.nativeTransport; nativeStreaming cũ vẫn là alias runtime cho streaming.nativeTransport. Chạy openclaw doctor --fix để ghi lại cấu hình đã lưu.

​

Hành vi runtime

• Dùng sendMessage + các bản cập nhật xem trước editMessageText trên DM và nhóm/chủ đề.
• Các bản xem trước ban đầu ngắn vẫn được debounce cho UX thông báo đẩy, nhưng Telegram hiện hiện thực hóa chúng sau một độ trễ có giới hạn để các lượt chạy đang hoạt động không bị im lặng về mặt hiển thị.
• Văn bản cuối cùng chỉnh sửa bản xem trước đang hoạt động tại chỗ; các kết quả cuối dài tái sử dụng tin nhắn đó cho đoạn đầu tiên và chỉ gửi các đoạn còn lại.
• Chế độ block xoay bản xem trước thành một tin nhắn mới tại streaming.preview.chunk.maxChars (mặc định 800, bị giới hạn bởi giới hạn chỉnh sửa 4096 của Telegram); các chế độ khác mở rộng một bản xem trước lên tối đa 4096 ký tự.
• Chế độ progress giữ tiến độ công cụ trong một bản nháp trạng thái có thể chỉnh sửa, hiện thực hóa nhãn trạng thái khi truyền phát câu trả lời đang hoạt động nhưng chưa có dòng công cụ, xóa bản nháp đó khi hoàn tất, và gửi câu trả lời cuối cùng qua cơ chế phân phối thông thường.
• Nếu chỉnh sửa cuối cùng thất bại trước khi văn bản hoàn tất được xác nhận, OpenClaw dùng phân phối cuối thông thường và dọn bản xem trước cũ.
• Truyền phát bản xem trước bị bỏ qua khi truyền phát block Telegram được bật rõ ràng (để tránh truyền phát hai lần).
• /reasoning stream có thể ghi phần suy luận vào một bản xem trước tạm thời sẽ bị xóa sau khi phân phối cuối cùng.

• Dùng gửi + chỉnh sửa tin nhắn xem trước.
• Chế độ block dùng chia đoạn nháp (draftChunk).
• Truyền phát bản xem trước bị bỏ qua khi truyền phát block Discord được bật rõ ràng.
• Phương tiện cuối, lỗi, và payload trả lời rõ ràng hủy các bản xem trước đang chờ mà không xả bản nháp mới, rồi dùng phân phối thông thường.

• partial có thể dùng truyền phát gốc của Slack (chat.startStream/append/stop) khi khả dụng.
• block dùng bản xem trước nháp kiểu nối thêm.
• progress dùng văn bản xem trước trạng thái, rồi câu trả lời cuối cùng.
• DM cấp cao nhất không có chuỗi trả lời dùng bài đăng bản xem trước nháp và chỉnh sửa thay vì truyền phát gốc của Slack.
• Truyền phát bản xem trước gốc và nháp chặn trả lời block cho lượt đó, nên một trả lời Slack chỉ được truyền phát bởi một đường dẫn phân phối.
• Payload phương tiện/lỗi cuối và kết quả cuối tiến độ không tạo tin nhắn nháp dùng một lần; chỉ các kết quả cuối dạng văn bản/block có thể chỉnh sửa bản xem trước mới xả văn bản nháp đang chờ.

• Truyền phát suy nghĩ, hoạt động công cụ, và văn bản trả lời một phần vào một bài đăng bản xem trước nháp duy nhất, rồi hoàn tất tại chỗ khi câu trả lời cuối cùng an toàn để gửi.
• Rơi về gửi một bài đăng cuối mới nếu bài đăng xem trước đã bị xóa hoặc không còn khả dụng tại thời điểm hoàn tất.
• Payload phương tiện/lỗi cuối hủy các bản cập nhật xem trước đang chờ trước khi phân phối thông thường thay vì xả một bài đăng xem trước tạm thời.

• Bản xem trước nháp hoàn tất tại chỗ khi văn bản cuối cùng có thể tái sử dụng sự kiện xem trước.
• Kết quả cuối chỉ có phương tiện, lỗi, và không khớp mục tiêu trả lời hủy các bản cập nhật xem trước đang chờ trước khi phân phối thông thường; một bản xem trước cũ đã hiển thị sẽ bị biên tập lại.

​

Cập nhật bản xem trước tiến độ công cụ

• Discord, Slack, Telegram và Matrix mặc định truyền phát tiến trình công cụ và các cập nhật phần mở đầu của Codex vào bản chỉnh sửa xem trước trực tiếp khi tính năng truyền phát bản xem trước đang hoạt động. Microsoft Teams dùng luồng tiến trình gốc của nó trong các cuộc trò chuyện cá nhân.
• Telegram đã phát hành với các cập nhật xem trước tiến trình công cụ được bật kể từ v2026.4.22; giữ chúng bật sẽ duy trì hành vi đã phát hành đó.
• Mattermost đã gộp hoạt động công cụ vào một bài đăng xem trước bản nháp duy nhất của nó (xem ở trên).
• Các chỉnh sửa tiến trình công cụ tuân theo chế độ truyền phát bản xem trước đang hoạt động; chúng bị bỏ qua khi truyền phát bản xem trước là off hoặc khi truyền phát khối đã tiếp quản tin nhắn. Trên Telegram, streaming.mode: "off" là chỉ-kết-quả-cuối: phần trò chuyện tiến trình chung cũng bị chặn thay vì được gửi dưới dạng tin nhắn trạng thái độc lập, trong khi lời nhắc phê duyệt, tải trọng phương tiện và lỗi vẫn được định tuyến bình thường.
• Để giữ truyền phát bản xem trước nhưng ẩn các dòng tiến trình công cụ, đặt streaming.preview.toolProgress thành false cho kênh đó. Để giữ các dòng tiến trình công cụ hiển thị trong khi ẩn văn bản lệnh/thực thi, đặt streaming.preview.commandText thành "status" hoặc streaming.progress.commandText thành "status"; mặc định là "raw" để duy trì hành vi đã phát hành. Chính sách này được chia sẻ bởi các kênh nháp/tiến trình dùng trình kết xuất tiến trình gọn của OpenClaw, bao gồm Discord, Matrix, Microsoft Teams, Mattermost, bản xem trước nháp Slack và Telegram. Để tắt hoàn toàn các chỉnh sửa xem trước, đặt streaming.mode thành off.
• Các phản hồi trích dẫn đã chọn của Telegram là một ngoại lệ: khi replyToMode không phải là "off" và có văn bản trích dẫn đã chọn, OpenClaw bỏ qua luồng xem trước câu trả lời cho lượt đó để các dòng xem trước tiến trình công cụ không thể hiển thị. Các phản hồi tin nhắn hiện tại không có văn bản trích dẫn đã chọn vẫn giữ truyền phát bản xem trước. Xem tài liệu kênh Telegram để biết chi tiết.

​

Làn tiến trình bình luận

• streaming.progress.commentary — kết xuất bình luận trước công cụ của mô hình (💬) — phần tường thuật ngắn “Tôi sẽ kiểm tra… rồi…” — xen kẽ với các dòng công cụ trong bản nháp tiến trình.

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

​

Liên quan

• Tái cấu trúc vòng đời tin nhắn - thiết kế chung mục tiêu cho xem trước, chỉnh sửa, truyền phát và hoàn tất
• Bản nháp tiến trình - các tin nhắn công việc đang diễn ra hiển thị và cập nhật trong các lượt dài
• Tin nhắn - vòng đời và phân phối tin nhắn
• Thử lại - hành vi thử lại khi phân phối thất bại
• Kênh - hỗ trợ truyền phát theo từng kênh