​

WhatsApp (Kênh Web)

​

Cài đặt (khi cần)

• Quá trình onboarding (openclaw onboard) và openclaw channels add --channel whatsapp sẽ yêu cầu cài đặt plugin WhatsApp lần đầu tiên khi chọn.
• openclaw channels login --channel whatsapp cũng cung cấp quy trình cài đặt khi plugin chưa có.
• Kênh Dev + git checkout: mặc định là đường dẫn plugin cục bộ.
• Ổn định/Beta: mặc định là gói npm @openclaw/whatsapp.

openclaw plugins install @openclaw/whatsapp

​

Thiết lập nhanh

{
  channels: {
    whatsapp: {
      dmPolicy: "pairing",
      allowFrom: ["+15551234567"],
      groupPolicy: "allowlist",
      groupAllowFrom: ["+15551234567"],
    },
  },
}

openclaw channels login --channel whatsapp

openclaw channels login --channel whatsapp --account work

openclaw gateway

openclaw pairing list whatsapp
openclaw pairing approve whatsapp <CODE>

​

Mẫu triển khai

{
  channels: {
    whatsapp: {
      dmPolicy: "allowlist",
      allowFrom: ["+15551234567"],
    },
  },
}

​

Mô hình thời gian chạy

• Gateway sở hữu socket WhatsApp và vòng lặp kết nối lại.
• Gửi đi yêu cầu một listener WhatsApp hoạt động cho tài khoản mục tiêu.
• Trạng thái và chat phát sóng bị bỏ qua (@status, @broadcast).
• Chat trực tiếp sử dụng quy tắc phiên DM (session.dmScope; mặc định main gộp DMs vào phiên chính của agent).
• Phiên nhóm được cô lập (agent:<agentId>:whatsapp:group:<jid>).

​

Kiểm soát truy cập và kích hoạt

​

Hành vi số cá nhân và tự trò chuyện

• bỏ qua biên nhận đã đọc cho lượt tự trò chuyện
• bỏ qua hành vi tự động kích hoạt nhắc-JID mà nếu không sẽ tự ping
• nếu messages.responsePrefix không được đặt, trả lời tự trò chuyện mặc định là [{identity.name}] hoặc [openclaw]

​

Chuẩn hóa tin nhắn và ngữ cảnh

[Trả lời <người gửi> id:<stanzaId>]
<nội dung trích dẫn hoặc chỗ giữ chỗ phương tiện>
[/Trả lời]

{
  channels: {
    whatsapp: {
      sendReadReceipts: false,
    },
  },
}

{
  channels: {
    whatsapp: {
      accounts: {
        work: {
          sendReadReceipts: false,
        },
      },
    },
  },
}

​

Giao hàng, chia nhỏ và phương tiện

​

Phản ứng xác nhận

{
  channels: {
    whatsapp: {
      ackReaction: {
        emoji: "👀",
        direct: true,
        group: "mentions", // always | mentions | never
      },
    },
  },
}

• gửi ngay sau khi inbound được chấp nhận (trước khi trả lời)
• lỗi được ghi lại nhưng không chặn việc gửi trả lời bình thường
• chế độ nhóm mentions phản ứng khi lượt được kích hoạt bởi nhắc; kích hoạt nhóm always hoạt động như bỏ qua cho kiểm tra này
• WhatsApp sử dụng channels.whatsapp.ackReaction (không sử dụng messages.ackReaction cũ ở đây)

​

Nhiều tài khoản và thông tin xác thực

​

Công cụ, hành động và ghi cấu hình

• Hỗ trợ công cụ Agent bao gồm hành động phản ứng WhatsApp (react).
• Cổng hành động:
  • channels.whatsapp.actions.reactions
  • channels.whatsapp.actions.polls
• Ghi cấu hình do kênh khởi tạo được bật theo mặc định (vô hiệu hóa qua channels.whatsapp.configWrites=false).

​

Khắc phục sự cố

openclaw channels login --channel whatsapp
openclaw channels status

openclaw doctor
openclaw logs --follow

​

Tham chiếu cấu hình

• Tham chiếu cấu hình - WhatsApp

• truy cập: dmPolicy, allowFrom, groupPolicy, groupAllowFrom, groups
• giao hàng: textChunkLimit, chunkMode, mediaMaxMb, sendReadReceipts, ackReaction
• nhiều tài khoản: accounts.<id>.enabled, accounts.<id>.authDir, ghi đè cấp tài khoản
• vận hành: configWrites, debounceMs, web.enabled, web.heartbeatSeconds, web.reconnect.*
• hành vi phiên: session.dmScope, historyLimit, dmHistoryLimit, dms.<id>.historyLimit

​

Liên quan

• Ghép đôi
• Định tuyến kênh
• Định tuyến nhiều agent
• Khắc phục sự cố