通过 WhatsApp Web(Baileys)的生产就绪集成,Gateway 管理关联会话。

安装

# 按需安装(引导时提示)
openclaw plugins install clawhub:@openclaw/whatsapp
 
# 或通过引导
openclaw onboard
openclaw channels add --channel whatsapp

快速设置

{
  channels: {
    whatsapp: {
      dmPolicy: "pairing",
      allowFrom: ["+15551234567"],
      groupPolicy: "allowlist",
      groupAllowFrom: ["+15551234567"],
    },
  },
}
# QR 配对
openclaw channels login --channel whatsapp
# 用助手手机扫描 QR 码

双手机方案(推荐)

使用专用 WhatsApp 号码(不要用个人号码):

  • 个人手机:你的 WhatsApp
  • 助手手机:专用号码,扫码关联到 OpenClaw

关键配置

{
  channels: {
    whatsapp: {
      dmPolicy: "pairing",           // pairing | open | allowlist
      allowFrom: ["+15551234567"],   // 允许的发送者
      groupPolicy: "allowlist",      // disabled | allowlist | open
      groups: {
        "*": { requireMention: true },
      },
    },
  },
}

状态检查

openclaw channels status --channel whatsapp
openclaw channels status --probe

相关

  • concepts/channels-overview — Channel 总览
  • concepts/start-personal-assistant — 个人助手设置