Sự kiện môi trường trong phòng

Sự kiện phòng nền cho phép OpenClaw xử lý cuộc trò chuyện nhóm hoặc kênh không nhắc tên như ngữ cảnh thầm lặng. Tác nhân có thể cập nhật bộ nhớ và trạng thái phiên, nhưng phòng vẫn im lặng trừ khi tác nhân gọi rõ ràng công cụ message.

Đối với các cuộc trò chuyện nhóm luôn bật, đây là chế độ được khuyến nghị: kết hợp messages.groupChat.unmentionedInbound: "room_event" với messages.groupChat.visibleReplies: "message_tool". Dùng chế độ này khi tác nhân cần lắng nghe, quyết định khi nào phản hồi là hữu ích, và tránh mẫu prompt cũ là trả lời NO_REPLY.

Hiện được hỗ trợ: kênh máy chủ Discord, kênh Slack và kênh riêng tư Slack, DM nhiều người của Slack, và nhóm hoặc siêu nhóm Telegram. Các kênh nhóm khác giữ hành vi nhóm hiện có trừ khi trang kênh của chúng cho biết có hỗ trợ sự kiện phòng nền.

Thiết lập được khuyến nghị

Đặt hành vi trò chuyện nhóm toàn cục:

{  messages: {    groupChat: {      unmentionedInbound: "room_event",      visibleReplies: "message_tool",      historyLimit: 50,    },  },}

Sau đó cấu hình chính phòng đó là luôn bật bằng cách tắt cổng yêu cầu nhắc tên cho phòng đó. Kênh vẫn phải được cho phép bởi groupPolicy thông thường, danh sách cho phép phòng, và danh sách cho phép người gửi.

Sau khi lưu cấu hình, Gateway tải nóng các thiết lập messages. Chỉ khởi động lại khi tính năng theo dõi tệp hoặc tải lại cấu hình bị tắt.

Những gì thay đổi

Với messages.groupChat.unmentionedInbound: "room_event":

• tin nhắn nhóm hoặc kênh được phép nhưng không nhắc tên trở thành sự kiện phòng thầm lặng
• tin nhắn có nhắc tên vẫn là yêu cầu của người dùng
• lệnh văn bản và lệnh gốc vẫn là yêu cầu của người dùng
• yêu cầu hủy hoặc dừng vẫn là yêu cầu của người dùng
• tin nhắn trực tiếp vẫn là yêu cầu của người dùng

Sự kiện phòng dùng cơ chế gửi hiển thị nghiêm ngặt. Văn bản cuối cùng của trợ lý là riêng tư. Tác nhân phải gọi message(action=send) để đăng trong phòng.

Ví dụ Discord

{  messages: {    groupChat: {      unmentionedInbound: "room_event",      visibleReplies: "message_tool",      historyLimit: 50,    },  },  channels: {    discord: {      groupPolicy: "allowlist",      guilds: {        "<DISCORD_SERVER_ID>": {          requireMention: false,          users: ["<YOUR_DISCORD_USER_ID>"],        },      },    },  },}

Dùng cấu hình Discord theo từng kênh khi chỉ một kênh cần chạy nền:

{  channels: {    discord: {      guilds: {        "<DISCORD_SERVER_ID>": {          channels: {            "<DISCORD_CHANNEL_ID_OR_NAME>": {              allow: true,              requireMention: false,            },          },        },      },    },  },}

Ví dụ Slack

Danh sách cho phép kênh Slack ưu tiên ID. Dùng ID kênh như C12345678, không dùng #channel-name.

{  messages: {    groupChat: {      unmentionedInbound: "room_event",      visibleReplies: "message_tool",      historyLimit: 50,    },  },  channels: {    slack: {      groupPolicy: "allowlist",      channels: {        "<SLACK_CHANNEL_ID>": {          allow: true,          requireMention: false,        },      },    },  },}

Ví dụ Telegram

Đối với nhóm Telegram, bot phải có khả năng thấy tin nhắn nhóm thông thường. Nếu requireMention: false, hãy tắt chế độ riêng tư BotFather hoặc dùng một thiết lập Telegram khác có gửi toàn bộ lưu lượng nhóm tới bot.

{  messages: {    groupChat: {      unmentionedInbound: "room_event",      visibleReplies: "message_tool",      historyLimit: 50,    },  },  channels: {    telegram: {      groups: {        "<TELEGRAM_GROUP_CHAT_ID>": {          groupPolicy: "open",          requireMention: false,        },      },    },  },}

ID nhóm Telegram thường là số âm như -1001234567890. Đọc chat.id từ openclaw logs --follow, chuyển tiếp một tin nhắn nhóm tới bot trợ giúp ID, hoặc kiểm tra Bot API getUpdates.

Chính sách riêng cho tác nhân

Dùng ghi đè tác nhân khi nhiều tác nhân dùng chung cùng một phòng nhưng chỉ một tác nhân nên xem cuộc trò chuyện không nhắc tên là ngữ cảnh nền:

{  messages: {    groupChat: {      visibleReplies: "message_tool",    },  },  agents: {    list: [      {        id: "main",        groupChat: {          unmentionedInbound: "room_event",          mentionPatterns: ["@openclaw", "openclaw"],        },      },    ],  },}

Giá trị agents.list[].groupChat.unmentionedInbound riêng cho tác nhân ghi đè messages.groupChat.unmentionedInbound cho tác nhân đó.

Chế độ phản hồi hiển thị

messages.groupChat.visibleReplies mặc định là "automatic" cho các yêu cầu người dùng nhóm/kênh thông thường. Giữ mặc định đó khi bạn muốn văn bản cuối cùng của trợ lý được đăng hiển thị mà không cần một lệnh gọi công cụ nhắn tin rõ ràng.

Đối với các phòng luôn bật chạy nền, messages.groupChat.visibleReplies: "message_tool" vẫn được khuyến nghị, đặc biệt với các mô hình thế hệ mới nhất, đáng tin cậy khi dùng công cụ như GPT 5.5. Chế độ này cho phép tác nhân quyết định khi nào nói bằng cách gọi công cụ nhắn tin. Nếu mô hình trả về văn bản cuối cùng mà không gọi công cụ, OpenClaw giữ văn bản cuối cùng đó ở chế độ riêng tư và ghi nhật ký siêu dữ liệu gửi bị chặn.

Sự kiện phòng vẫn nghiêm ngặt ngay cả khi các yêu cầu nhóm khác dùng phản hồi tự động. Sự kiện phòng nền không nhắc tên vẫn yêu cầu message(action=send) để có đầu ra hiển thị.

Lịch sử

messages.groupChat.historyLimit kiểm soát mặc định lịch sử nhóm toàn cục. Kênh có thể ghi đè bằng channels.<channel>.historyLimit, và một số kênh cũng hỗ trợ giới hạn lịch sử theo từng tài khoản.

Đặt historyLimit: 0 để tắt ngữ cảnh lịch sử nhóm.

Các kênh sự kiện phòng được hỗ trợ giữ các tin nhắn phòng nền gần đây làm ngữ cảnh. Telegram giữ một cửa sổ cuốn theo từng nhóm luôn bật, bị giới hạn bởi historyLimit; lượt yêu cầu của người dùng chọn các mục sau phản hồi đã ghi nhận cuối cùng của bot, trong khi lượt sự kiện phòng nhận toàn bộ cửa sổ gần đây để mô hình có thể thấy các bài đăng gần đây của chính nó. Khóa chế độ Telegram đã ngừng dùng includeGroupHistoryContext được xóa bởi openclaw doctor --fix.

Khắc phục sự cố

Nếu phòng hiển thị trạng thái đang nhập hoặc mức dùng token nhưng không có tin nhắn hiển thị:

1. Xác nhận phòng được cho phép bởi danh sách cho phép kênh và danh sách cho phép người gửi.
2. Xác nhận requireMention: false được đặt ở cấp phòng bạn mong đợi.
3. Kiểm tra xem messages.groupChat.unmentionedInbound hoặc ghi đè tác nhân có phải là "room_event" không.
4. Kiểm tra nhật ký để tìm siêu dữ liệu payload cuối cùng bị chặn hoặc didSendViaMessagingTool: false.
5. Đối với các yêu cầu nhóm thông thường, giữ hoặc khôi phục messages.groupChat.visibleReplies: "automatic" nếu bạn muốn phản hồi cuối cùng được đăng tự động. Đối với phòng nền dùng message_tool, hãy dùng mô hình/runtime gọi công cụ một cách đáng tin cậy.

Nếu phòng nền Telegram hoàn toàn không kích hoạt, hãy kiểm tra chế độ riêng tư BotFather và xác minh Gateway đang nhận tin nhắn nhóm thông thường.

Nếu phòng nền Slack không kích hoạt, hãy xác minh khóa kênh là ID kênh Slack và ứng dụng có phạm vi bắt buộc channels:history hoặc groups:history cho loại phòng đó.

Liên quan

• Nhóm
• Discord
• Slack
• Telegram
• Khắc phục sự cố kênh
• Tham chiếu cấu hình kênh