Bắt đầu nhanh
Bật bản nháp tiến trình cho từng kênh bằngstreaming.mode: "progress":
Người dùng thấy gì
Một bản nháp tiến trình có hai phần:| Phần | Mục đích |
|---|---|
| Nhãn | Một dòng bắt đầu/trạng thái ngắn như Working hoặc Shelling. |
| Dòng tiến trình | Các cập nhật chạy ngắn gọn dùng cùng biểu tượng công cụ và bộ định dạng chi tiết như đầu ra chi tiết. |
🛠️ Bash: run tests, 🔎 Web Search: for "discord edit message", hoặc ✍️ Write: to /tmp/file.
Theo mặc định, chúng dùng cùng chế độ giải thích ngắn gọn như /verbose; đặt agents.defaults.toolProgressDetail: "raw" khi gỡ lỗi và bạn cũng muốn nối thêm lệnh/chi tiết thô.
Câu trả lời cuối cùng sẽ thay thế bản nháp khi có thể; nếu không, OpenClaw gửi câu trả lời cuối cùng như bình thường và dọn dẹp hoặc ngừng cập nhật bản nháp theo cơ chế truyền tải của kênh.
Chọn chế độ
channels.<channel>.streaming.mode kiểm soát hành vi đang xử lý hiển thị:
| Chế độ | Phù hợp nhất cho | Nội dung xuất hiện trong chat |
|---|---|---|
off | Kênh yên tĩnh | Chỉ câu trả lời cuối cùng. |
partial | Theo dõi văn bản câu trả lời xuất hiện | Một bản nháp được chỉnh sửa với văn bản câu trả lời mới nhất. |
block | Các đoạn xem trước câu trả lời lớn hơn | Một bản xem trước được cập nhật hoặc nối thêm theo các đoạn lớn hơn. |
progress | Lượt dùng nhiều công cụ hoặc chạy lâu | Một bản nháp trạng thái, rồi đến câu trả lời cuối cùng. |
progress khi người dùng quan tâm nhiều hơn đến “điều gì đang xảy ra” thay vì xem văn bản câu trả lời được truyền từng token.
Chọn partial khi chính câu trả lời là tín hiệu tiến trình.
Chọn block khi bạn muốn các cập nhật xem trước bản nháp theo các đoạn văn bản lớn hơn. Trên Discord và Telegram, streaming.mode: "block" vẫn là truyền bản xem trước, không phải phân phối khối thông thường. Dùng streaming.block.enabled hoặc blockStreaming cũ khi bạn muốn phản hồi khối thông thường.
Cấu hình nhãn
Nhãn tiến trình nằm dướichannels.<channel>.streaming.progress.
Nhãn mặc định là auto, chọn từ nhóm nhãn một từ tích hợp sẵn của OpenClaw:
Kiểm soát dòng tiến trình
Dòng tiến trình được bật mặc định trong chế độ tiến trình. Chúng đến từ các sự kiện chạy thật: bắt đầu công cụ, cập nhật mục, kế hoạch tác vụ, phê duyệt, đầu ra lệnh, tóm tắt bản vá và hoạt động agent tương tự. Công cụ cũng có thể phát tiến trình có kiểu trong khi một lần gọi công cụ vẫn đang chạy. Đây là cách một lượt tìm nạp hoặc tìm kiếm chậm có thể cập nhật bản nháp hiển thị trước khi công cụ trả về kết quả cuối cùng. Cập nhật tiến trình là một kết quả công cụ một phần với nội dung model rỗng và siêu dữ liệu kênh công khai rõ ràng:progress.text trong giao diện tiến trình của kênh. Kết quả công cụ thông thường vẫn đến sau dưới dạng content và details, và là phần duy nhất được trả về cho model.
Khi thêm tiến trình vào một công cụ, hãy dùng thông báo ngắn, chung chung và trì hoãn nó cho đến khi thao tác đã chờ đủ lâu để trở nên hữu ích:
/verbose:
"explain" là mặc định và giữ bản nháp ổn định với các nhãn súc tích như 🛠️ check JS syntax for /tmp/app.js. "raw" nối thêm lệnh/chi tiết bên dưới khi có, hữu ích khi gỡ lỗi nhưng gây nhiều nhiễu hơn trong chat.
Ví dụ, cùng một lệnh hiển thị khác nhau tùy chế độ chi tiết:
| Chế độ | Dòng tiến trình |
|---|---|
explain | 🛠️ check JS syntax for /tmp/app.js |
raw | 🛠️ check JS syntax for /tmp/app.js, node --check /tmp/app.js |
toolProgress: false, OpenClaw vẫn chặn các tin nhắn tiến trình công cụ độc lập cũ hơn cho lượt đó. Kênh vẫn yên tĩnh về mặt hiển thị cho đến câu trả lời cuối cùng, ngoại trừ nhãn nếu có cấu hình.
Hành vi kênh
Mỗi kênh dùng cơ chế truyền tải sạch nhất mà nó hỗ trợ:| Kênh | Cơ chế truyền tiến trình | Ghi chú |
|---|---|---|
| Discord | Gửi một tin nhắn, rồi chỉnh sửa nó. | Văn bản cuối cùng được chỉnh sửa tại chỗ khi vừa trong một tin nhắn xem trước an toàn. |
| Matrix | Gửi một sự kiện, rồi chỉnh sửa nó. | Cấu hình truyền ở cấp tài khoản kiểm soát bản nháp cấp tài khoản. |
| Microsoft Teams | Luồng Teams gốc trong chat cá nhân. | streaming.mode: "block" ánh xạ sang phân phối khối của Teams. |
| Slack | Luồng gốc hoặc bài đăng bản nháp có thể chỉnh sửa. | Tính sẵn có của thread ảnh hưởng đến việc có thể dùng luồng gốc hay không. |
| Telegram | Gửi một tin nhắn, rồi chỉnh sửa nó. | Các bản nháp hiển thị cũ hơn có thể được thay thế để dấu thời gian cuối cùng vẫn hữu ích. |
| Mattermost | Bài đăng bản nháp có thể chỉnh sửa. | Hoạt động công cụ được gộp vào cùng bài đăng kiểu bản nháp. |
Hoàn tất
Khi câu trả lời cuối cùng sẵn sàng, OpenClaw cố giữ chat sạch sẽ:- Nếu bản nháp có thể an toàn trở thành câu trả lời cuối cùng, OpenClaw chỉnh sửa nó tại chỗ.
- Nếu kênh dùng truyền tiến trình gốc, OpenClaw hoàn tất luồng đó khi cơ chế truyền tải gốc chấp nhận văn bản cuối cùng.
- Nếu câu trả lời cuối cùng có media, lời nhắc phê duyệt, mục tiêu trả lời rõ ràng, quá nhiều đoạn, hoặc chỉnh sửa/gửi thất bại, OpenClaw gửi câu trả lời cuối cùng qua đường phân phối kênh thông thường.
Khắc phục sự cố
Tôi chỉ thấy câu trả lời cuối cùng. Kiểm tra rằngchannels.<channel>.streaming.mode được đặt thành progress cho tài khoản hoặc kênh đã xử lý tin nhắn. Một số đường dẫn nhóm hoặc trả lời trích dẫn có thể tắt xem trước bản nháp cho một lượt khi kênh không thể chỉnh sửa đúng tin nhắn một cách an toàn.
Tôi thấy nhãn nhưng không thấy dòng công cụ.
Kiểm tra streaming.progress.toolProgress. Nếu nó là false, OpenClaw giữ hành vi một bản nháp duy nhất nhưng ẩn các dòng tiến trình công cụ và tác vụ.
Tôi thấy một tin nhắn cuối cùng mới thay vì một bản nháp đã chỉnh sửa.
Đó là dự phòng an toàn. Điều này có thể xảy ra với phản hồi media, câu trả lời dài, mục tiêu trả lời rõ ràng, bản nháp Telegram cũ, thiếu mục tiêu thread Slack, tin nhắn xem trước đã bị xóa, hoặc hoàn tất luồng gốc thất bại.
Tôi vẫn thấy các tin nhắn tiến trình độc lập.
Chế độ tiến trình chặn các tin nhắn tiến trình công cụ độc lập mặc định khi một bản nháp đang hoạt động. Nếu tin nhắn độc lập vẫn xuất hiện, hãy xác minh rằng lượt đó thực sự đang dùng chế độ tiến trình chứ không phải streaming.mode: "off" hoặc một đường dẫn kênh không thể tạo bản nháp cho tin nhắn đó.
Teams hoạt động khác với Discord hoặc Telegram.
Microsoft Teams sử dụng một luồng gốc trong các cuộc trò chuyện cá nhân thay vì cơ chế truyền tải xem trước gửi-và-chỉnh sửa chung. Teams cũng coi streaming.mode: "block" là phương thức gửi khối của Teams vì nó không có cùng chế độ khối xem trước bản nháp được Discord và Telegram sử dụng.