OpenClaw xử lý tin nhắn đến thông qua một pipeline gồm phân giải phiên, xếp hàng, streaming, thực thi công cụ và hiển thị reasoning. Trang này mô tả đường đi từ tin nhắn đến đến phản hồi.Documentation Index
Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt
Use this file to discover all available pages before exploring further.
Luồng tin nhắn (mức cao)
messages.*cho tiền tố, xếp hàng và hành vi nhóm.agents.defaults.*cho mặc định block streaming và chunking.- Ghi đè theo kênh (
channels.whatsapp.*,channels.telegram.*, v.v.) cho giới hạn và bật/tắt streaming.
Khử trùng lặp tin nhắn đến
Các kênh có thể gửi lại cùng một tin nhắn sau khi kết nối lại. OpenClaw duy trì một bộ nhớ đệm ngắn hạn được định khóa theo kênh/tài khoản/peer/phiên/id tin nhắn để các lần gửi trùng lặp không kích hoạt thêm một lượt chạy agent khác.Debounce tin nhắn đến
Các tin nhắn liên tiếp nhanh từ cùng một người gửi có thể được gom thành một lượt agent duy nhất thông quamessages.inbound. Debounce được giới hạn theo từng kênh + cuộc trò chuyện
và dùng tin nhắn gần nhất cho threading/ID phản hồi.
Cấu hình (mặc định toàn cục + ghi đè theo kênh):
- Debounce áp dụng cho tin nhắn chỉ có văn bản; media/tệp đính kèm được flush ngay lập tức.
- Lệnh điều khiển bỏ qua debounce để chúng vẫn đứng riêng lẻ — ngoại trừ khi một kênh chủ động chọn gom DM cùng người gửi (ví dụ BlueBubbles
coalesceSameSenderDms), trong đó lệnh DM chờ trong cửa sổ debounce để payload gửi tách có thể tham gia cùng một lượt agent.
Phiên và thiết bị
Phiên do Gateway sở hữu, không phải client.- Chat trực tiếp được gộp vào khóa phiên chính của agent.
- Nhóm/kênh có khóa phiên riêng.
- Kho phiên và transcript nằm trên máy chủ Gateway.
Metadata kết quả công cụ
content của kết quả công cụ là kết quả mà model nhìn thấy. details của kết quả công cụ là
metadata runtime cho render UI, chẩn đoán, gửi media và Plugin.
OpenClaw giữ ranh giới đó rõ ràng:
toolResult.detailsbị loại bỏ trước khi provider replay và đầu vào compaction.- Transcript phiên được lưu chỉ giữ
detailscó giới hạn; metadata quá lớn được thay bằng một tóm tắt gọn có đánh dấupersistedDetailsTruncated: true. - Plugin và công cụ nên đặt văn bản mà model phải đọc trong
content, không chỉ trongdetails.
Nội dung tin nhắn đến và ngữ cảnh lịch sử
OpenClaw tách nội dung prompt khỏi nội dung lệnh:Body: văn bản prompt gửi tới agent. Phần này có thể bao gồm envelope của kênh và các wrapper lịch sử tùy chọn.CommandBody: văn bản thô của người dùng để phân tích directive/lệnh.RawBody: alias legacy choCommandBody(giữ để tương thích).
[Chat messages since your last reply - for context][Current message - respond to this]
CommandBody (hoặc
RawBody) thành văn bản tin nhắn gốc và giữ Body là prompt đã kết hợp.
Bộ đệm lịch sử có thể cấu hình qua messages.groupChat.historyLimit (mặc định
toàn cục) và các ghi đè theo kênh như channels.slack.historyLimit hoặc
channels.telegram.accounts.<id>.historyLimit (đặt 0 để tắt).
Xếp hàng và followup
Nếu một lượt chạy đang hoạt động, tin nhắn đến có thể được xếp hàng, điều hướng vào lượt chạy hiện tại, hoặc thu thập cho một lượt followup.- Cấu hình qua
messages.queue(vàmessages.queue.byChannel). - Chế độ mặc định là
steer, với debounce followup 500ms khi việc điều hướng rơi về gửi followup đã xếp hàng. - Chế độ:
steer,followup,collect,steer-backlog,interrupt, và alias legacyqueue.
Quyền sở hữu lượt chạy của kênh
Plugin kênh có thể duy trì thứ tự, debounce đầu vào và áp dụng backpressure transport trước khi tin nhắn đi vào hàng đợi phiên. Chúng không nên áp đặt timeout riêng quanh chính lượt agent. Sau khi tin nhắn được định tuyến đến một phiên, công việc chạy lâu được quản lý bởi vòng đời phiên, công cụ và runtime để mọi kênh báo cáo và phục hồi nhất quán từ các lượt chậm.Streaming, chunking và batching
Block streaming gửi phản hồi từng phần khi model tạo ra các khối văn bản. Chunking tôn trọng giới hạn văn bản của kênh và tránh tách fenced code. Thiết lập chính:agents.defaults.blockStreamingDefault(on|off, mặc định tắt)agents.defaults.blockStreamingBreak(text_end|message_end)agents.defaults.blockStreamingChunk(minChars|maxChars|breakPreference)agents.defaults.blockStreamingCoalesce(batching dựa trên thời gian nhàn rỗi)agents.defaults.humanDelay(khoảng dừng giống con người giữa các phản hồi khối)- Ghi đè theo kênh:
*.blockStreamingvà*.blockStreamingCoalesce(các kênh không phải Telegram yêu cầu đặt rõ*.blockStreaming: true)
Hiển thị reasoning và token
OpenClaw có thể hiển thị hoặc ẩn reasoning của model:/reasoning on|off|streamđiều khiển khả năng hiển thị.- Nội dung reasoning vẫn được tính vào mức sử dụng token khi được model tạo ra.
- Telegram hỗ trợ stream reasoning vào bong bóng bản nháp.
Tiền tố, threading và phản hồi
Định dạng tin nhắn gửi đi được tập trung trongmessages:
messages.responsePrefix,channels.<channel>.responsePrefix, vàchannels.<channel>.accounts.<id>.responsePrefix(chuỗi cascade tiền tố gửi đi), cộng vớichannels.whatsapp.messagePrefix(tiền tố tin nhắn đến của WhatsApp)- Threading phản hồi qua
replyToModevà mặc định theo kênh
Phản hồi im lặng
Token im lặng chính xácNO_REPLY / no_reply nghĩa là “không gửi phản hồi hiển thị cho người dùng”.
Khi một lượt cũng có media công cụ đang chờ, chẳng hạn audio TTS được tạo, OpenClaw
loại bỏ văn bản im lặng nhưng vẫn gửi tệp đính kèm media.
OpenClaw phân giải hành vi đó theo loại cuộc trò chuyện:
- Cuộc trò chuyện trực tiếp mặc định không cho phép im lặng và viết lại một phản hồi im lặng trần thành một fallback ngắn hiển thị được.
- Nhóm/kênh mặc định cho phép im lặng.
- Điều phối nội bộ mặc định cho phép im lặng.
/verbose là on hoặc full.
Mặc định nằm dưới agents.defaults.silentReply và
agents.defaults.silentReplyRewrite; surfaces.<id>.silentReply và
surfaces.<id>.silentReplyRewrite có thể ghi đè chúng theo từng surface.
Khi phiên cha có một hoặc nhiều lượt subagent được spawn đang chờ, các phản hồi
im lặng trần bị bỏ trên mọi surface thay vì được viết lại, để phiên
cha giữ im lặng cho đến khi sự kiện hoàn tất của con gửi phản hồi thật.