Tin nhắn nhóm WhatsApp

​

Hành vi

• Chế độ kích hoạt: mention (mặc định) hoặc always. mention yêu cầu một lời gọi (WhatsApp @-mentions thật qua mentionedJids, mẫu regex an toàn, hoặc E.164 của bot xuất hiện ở bất kỳ đâu trong văn bản). always đánh thức agent với mọi tin nhắn nhưng chỉ nên trả lời khi có thể bổ sung giá trị có ý nghĩa; nếu không, nó trả về đúng token im lặng NO_REPLY / no_reply. Có thể đặt mặc định trong cấu hình (channels.whatsapp.groups) và ghi đè theo từng nhóm qua /activation. Khi channels.whatsapp.groups được đặt, nó cũng hoạt động như danh sách cho phép nhóm (thêm "*" để cho phép tất cả).
• Chính sách nhóm: channels.whatsapp.groupPolicy kiểm soát việc tin nhắn nhóm có được chấp nhận hay không (open|disabled|allowlist). allowlist dùng channels.whatsapp.groupAllowFrom (dự phòng: channels.whatsapp.allowFrom rõ ràng). Mặc định là allowlist (bị chặn cho đến khi bạn thêm người gửi).
• Phiên theo từng nhóm: khóa phiên có dạng agent:<agentId>:whatsapp:group:<jid> nên các lệnh như /verbose on, /trace on, hoặc /think high (được gửi dưới dạng tin nhắn độc lập) chỉ áp dụng cho nhóm đó; trạng thái DM cá nhân không bị ảnh hưởng. Heartbeat được bỏ qua cho các luồng nhóm.
• Chèn ngữ cảnh: tin nhắn nhóm chỉ đang chờ (mặc định 50) mà không kích hoạt một lượt chạy sẽ được thêm tiền tố dưới [Chat messages since your last reply - for context], với dòng kích hoạt nằm dưới [Current message - respond to this]. Những tin nhắn đã có trong phiên sẽ không được chèn lại.
• Hiển thị người gửi: mọi lô tin nhắn nhóm hiện kết thúc bằng [from: Sender Name (+E164)] để OpenClaw biết ai đang nói.
• Tạm thời/xem một lần: chúng tôi mở gói các loại này trước khi trích xuất văn bản/lượt nhắc, nên các lời gọi bên trong vẫn kích hoạt.
• Prompt hệ thống của nhóm: ở lượt đầu tiên của một phiên nhóm (và bất cứ khi nào /activation thay đổi chế độ), chúng tôi chèn một đoạn ngắn vào prompt hệ thống như You are replying inside the WhatsApp group "<subject>". Group members: Alice (+44...), Bob (+43...), ... Activation: trigger-only ... Address the specific sender noted in the message context. Nếu không có metadata, chúng tôi vẫn cho agent biết đây là cuộc trò chuyện nhóm.

​

Ví dụ cấu hình (WhatsApp)

{
  channels: {
    whatsapp: {
      groups: {
        "*": { requireMention: true },
      },
    },
  },
  agents: {
    list: [
      {
        id: "main",
        groupChat: {
          historyLimit: 50,
          mentionPatterns: ["@?openclaw", "\\+?15555550123"],
        },
      },
    ],
  },
}

• Các regex không phân biệt chữ hoa chữ thường và dùng cùng các lan can safe-regex như những bề mặt regex cấu hình khác; mẫu không hợp lệ và lặp lồng nhau không an toàn sẽ bị bỏ qua.
• WhatsApp vẫn gửi lượt nhắc chuẩn qua mentionedJids khi ai đó nhấn vào liên hệ, nên dự phòng bằng số hiếm khi cần đến nhưng là một lưới an toàn hữu ích.

​

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

• /activation mention
• /activation always

​

Cách sử dụng

1. Thêm tài khoản WhatsApp của bạn (tài khoản đang chạy OpenClaw) vào nhóm.
2. Nói @openclaw … (hoặc kèm số). Chỉ người gửi trong danh sách cho phép mới có thể kích hoạt, trừ khi bạn đặt groupPolicy: "open".
3. Prompt của agent sẽ bao gồm ngữ cảnh nhóm gần đây cùng marker cuối [from: …] để nó có thể gọi đúng người.
4. Các chỉ thị cấp phiên (/verbose on, /trace on, /think high, /new hoặc /reset, /compact) chỉ áp dụng cho phiên của nhóm đó; gửi chúng dưới dạng tin nhắn độc lập để chúng được ghi nhận. Phiên DM cá nhân của bạn vẫn độc lập.

​

Kiểm thử / xác minh

• Kiểm thử smoke thủ công:
  • Gửi một lời gọi @openclaw trong nhóm và xác nhận có phản hồi tham chiếu đến tên người gửi.
  • Gửi lời gọi thứ hai và xác minh khối lịch sử được đưa vào rồi được xóa ở lượt tiếp theo.
• Kiểm tra nhật ký Gateway (chạy với --verbose) để xem các mục inbound web message hiển thị from: <groupJid> và hậu tố [from: …].

​

Những điểm cần lưu ý

• Heartbeat được cố ý bỏ qua cho nhóm để tránh phát thông báo gây nhiễu.
• Cơ chế chặn echo dùng chuỗi lô kết hợp; nếu bạn gửi cùng một văn bản hai lần mà không có lượt nhắc, chỉ tin nhắn đầu tiên nhận được phản hồi.
• Mục lưu trữ phiên sẽ xuất hiện dưới dạng agent:<agentId>:whatsapp:group:<jid> trong kho phiên (~/.openclaw/agents/<agentId>/sessions/sessions.json theo mặc định); thiếu mục chỉ có nghĩa là nhóm chưa kích hoạt lượt chạy nào.
• Chỉ báo đang nhập trong nhóm tuân theo agents.defaults.typingMode. Khi phản hồi hiển thị được chọn vào chế độ chỉ dùng message-tool, trạng thái đang nhập bắt đầu ngay theo mặc định để thành viên nhóm có thể thấy agent đang làm việc ngay cả khi không có phản hồi cuối tự động nào được đăng. Cấu hình chế độ nhập rõ ràng vẫn được ưu tiên.

​

Liên quan

• Nhóm
• Định tuyến kênh
• Nhóm phát sóng