跳转到主要内容
通过扫描二维码将 WhatsApp 连接到您的 Claw 实例 —— 就像使用 WhatsApp 网页版一样。

​
前提条件

WhatsApp 使用您的真实手机号码。通过机器人发送的消息将显示为来自您的 WhatsApp 账号。如果您希望区分开来，请使用专用号码。
不支持 VoIP 号码。 WhatsApp 需要真实的基于 SIM 卡的手机号码。虚拟号码（Google Voice、Skype 等）无法用于二维码配对。

​
设置指南

1

保存 WhatsApp 配置

  1. 前往您的 Claw 控制面板
  2. 点击实例上的设置图标
  3. 打开 IM Integrations 选项卡
  4. 展开 WhatsApp 部分
  5. 配置 Access Policy（推荐使用白名单）
  6. 先点击 Save —— 在扫描二维码之前，您必须先保存配置
2

扫描二维码

  1. 点击 Scan QR Code 按钮
  2. 将出现一个二维码（有效期约 60 秒）
  3. 在手机上打开 WhatsApp → 设置 → 已连接的设备 → 连接设备
  4. 扫描屏幕上显示的二维码
  5. 等待连接建立
3

配置访问策略

WhatsApp 使用白名单策略 —— 只有您指定的电话号码才能与 AI 机器人互动。在 LemonData 控制面板中添加允许的电话号码（国际格式，例如 +1234567890）。
与其他平台不同，WhatsApp 不支持配对机制。您必须显式添加允许的联系人。
4

开始聊天

从允许的联系人向已连接的 WhatsApp 号码发送消息 —— AI 将会回复！

​
群组设置

支持 WhatsApp 群组。在 IM Integrations 选项卡中配置群组行为：
设置选项描述
Group PolicyOpen (默认) / Allowlist / Disabled控制谁可以在群组中触发机器人
Require @mention开启 / 关闭机器人仅在被 @ 提到时回复
Group IDs群组 JID 列表限制在特定群组（为空 = 所有群组）
Group Allowed Users电话号码列表仅这些用户可以触发机器人（白名单模式）
在群组白名单中，电话号码请使用 E.164 格式（例如 +1234567890）。

​
故障排除

再次点击 Scan QR Code 以生成新代码。二维码在约 60 秒后过期。
WhatsApp 可能会在闲置一段时间后断开已连接的设备。重新扫描二维码以重新连接。
  • 检查发送者的号码是否在您的白名单中（如果使用了白名单策略）
  • 验证您的实例是否正在运行
  • 检查您的 LemonData 余额