跳转到主要内容
通过扫描二维码将 WhatsApp 连接到您的 LemonClaw 实例 —— 就像使用 WhatsApp Web 一样。本指南适用于托管的 Claw 实例和私有部署的 LemonClaw。

​
前提条件

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

​
设置指南

1

打开 LemonClaw WebUI

  1. 如果您使用的是托管版 Claw，请前往您的 Claw Dashboard 并点击 Open WebUI
  2. 如果您是私有部署 LemonClaw，请打开您自己的 WebUI（例如 http://your-ip:18789）并使用您的 token 登录
  3. 在 WebUI 中，导航至 Settings → Channels
  4. 展开 WhatsApp 部分
  5. 配置 Access Policy（推荐使用白名单 allowlist）
  6. 先点击 Save —— 在扫描二维码之前，您必须先保存配置
2

扫描二维码

  1. 点击 Scan QR Code 按钮
  2. 将显示一个二维码（有效期约 60 秒）
  3. 在手机上，打开 WhatsApp → Settings → Linked Devices → Link a Device
  4. 扫描屏幕上显示的二维码
  5. 等待连接建立
3

配置访问策略

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

开始聊天

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

​
群组设置

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

​
故障排除

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