openclaw/translation/vietnamese/docs/concepts/group-messages.vi.md

summary	read_when
Hành vi và cấu hình cho việc xử lý tin nhắn nhóm trên WhatsApp (Mẫu nhắc tên được chia sẻ trên mọi nền tảng)	Bạn muốn cấu hình cách Agent hoạt động trong nhóm hoặc quy tắc nhắc tên (@mention)

Tin nhắn nhóm (WhatsApp Web)

Mục tiêu: Cho phép Agent tham gia vào các nhóm WhatsApp, chỉ phản hồi khi được gọi tên (@-mention) và giữ cho các cuộc hội thoại trong nhóm hoàn toàn tách biệt với các cuộc trò chuyện cá nhân của bạn.

Lưu ý: Danh sách các mẫu nhắc tên (mentionPatterns) hiện được chia sẻ dùng chung cho cả Telegram, Discord, Slack và iMessage.

Các tính năng đã triển khai

• Chế độ kích hoạt: Bao gồm mention (mặc định) hoặc always.

  • mention: Yêu cầu phải nhắc tên Agent (thông qua @-mention thật của WhatsApp, hoặc các mẫu regex, hoặc số điện thoại của Agent).
  • always: Agent sẽ theo dõi tất cả tin nhắn nhưng chỉ phản hồi khi thấy có thông tin giá trị cần đóng góp; nếu không nó sẽ im lặng (trả về mã NO_REPLY).
  • Bạn có thể chuyển đổi giữa các chế độ này bằng lệnh /activation.

• Chính sách nhóm (Group policy): Kiểm soát việc có chấp nhận tin nhắn từ nhóm hay không (open - mở cho tất cả, disabled - tắt hoàn toàn, hoặc allowlist - chỉ cho phép các nhóm nằm trong danh sách trắng).

• Phiên làm việc riêng cho từng nhóm: Các phiên làm việc nhóm hoàn toàn độc lập với các phiên DM cá nhân. Các lệnh như /verbose on hay /think high gửi trong nhóm sẽ chỉ có tác dụng trong nhóm đó, không ảnh hưởng đến bộ não của Agent ở nơi khác. Các lượt chạy tự động (heartbeats) sẽ không được thực hiện trong các nhóm chat để tránh làm phiền.

• Nạp ngữ cảnh: Các tin nhắn chờ trong nhóm chưa được phản hồi sẽ được gộp lại và chèn vào ngữ cảnh dưới nhãn [Chat messages since your last reply - for context] (Tin nhắn từ lần trả lời cuối - để lấy ngữ cảnh). Điều này giúp Agent nắm bắt được toàn bộ câu chuyện trong nhóm trước khi đưa ra câu trả lời chính thức cho tin nhắn hiện tại.

• Định danh người gửi: Mỗi đoạn hội thoại trong nhóm đều được đính kèm nhãn [from: Tên người gửi (+Số điện thoại)] ở cuối để Agent biết chính xác ai đang nói chuyện với mình.

Ví dụ cấu hình (Mẫu nhắc tên)

Thêm khối groupChat vào file moltbot.json để Agent có thể nhận diện tên mình ngay cả khi ứng dụng chat lọc bỏ ký hiệu @:

{
  "agents": {
    "list": [
      {
        "id": "main",
        "groupChat": {
          "historyLimit": 50,
          "mentionPatterns": [
            "@?moltbot",
            "\\+?15555550123"
          ]
        }
      }
    ]
  }
}

Lệnh kích hoạt (Dành cho chủ sở hữu)

Sử dụng lệnh sau trong nhóm chat:

• /activation mention: Chỉ phản hồi khi được nhắc tên.
• /activation always: Luôn luôn lắng nghe và phản hồi khi cần.

Chỉ người chủ (được khai báo trong danh sách allowFrom) mới có quyền thay đổi các cài đặt này.

---

Tài liệu liên quan: Cấu hình Nhóm (Groups), Trạng thái hệ thống.