WhatsApp 接入

WhatsApp 通过扫描 QR 码配对，使用 Baileys 库。不需要 WhatsApp Business API。

步骤

1. 启动配对

openclaw channels login

选择 WhatsApp，终端显示 QR 码。

2. 手机扫码

1. 打开 WhatsApp
2. 设置 → 已连接的设备
3. 连接新设备
4. 扫描终端 QR 码

3. 配置白名单

{
  channels: {
    whatsapp: {
      enabled: true,
      dmPolicy: "allowlist",
      allowFrom: ["+8613800138000"],  // 手机号格式
    }
  }
}

手机号格式：+ + 国家码 + 号码，不加空格。

4. 测试

用另一个 WhatsApp 号码给这个号码发消息。

注意事项

WARNING

• 不要用同一个号码同时连接多个 OpenClaw 实例（会互踢）
• 配对状态保存在 ~/.openclaw/，重装后需重新扫码
• Baileys 是非官方库，理论上 WhatsApp 可能封禁（个人使用风险极低）

功能支持

功能	支持
文本消息	✅
图片/文件	✅
语音消息	✅
Emoji 反应	✅
群组对话	✅