WhatsApp 接入

将 OpenClaw 接入 WhatsApp，让你可以通过手机上的 WhatsApp 与 AI 助手对话。

注意： WhatsApp 接入使用 whatsapp-web.js库，需要扫描二维码登录，类似于 WhatsApp Web。

前置要求

一个可用的 WhatsApp 账号
手机能够访问 WhatsApp（用于扫描二维码）

配置步骤

1. 启用 WhatsApp 频道

编辑配置文件 ~/.openclaw/openclaw.json：

{
  "channels": {
    "whatsapp": {
      "enabled": true,
      "allowFrom": ["+86138xxxxxxxx"],
      "groups": {
        "*": {
          "requireMention": true
        }
      }
    }
  }
}

2. 配置说明

选项	说明
`allowFrom`	允许访问的手机号码列表（带国家代码）
`groups.requireMention`	群组中是否需要 @提及才响应

3. 重启 Gateway

openclaw gateway restart

4. 扫描二维码

首次启动时，控制台会显示一个二维码。打开手机 WhatsApp：

点击右上角菜单 → 设置 → 已关联设备
点击"关联新设备"
扫描终端显示的二维码

5. 测试

登录成功后，使用配置的手机号发送消息给你的 WhatsApp 账号，AI 助手应该会响应。

常见问题

二维码不显示

确保终端支持图像显示，或者使用 --qr-terminal 选项使用 ASCII 二维码。

会话过期

WhatsApp Web 会话会定期过期，需要重新扫描二维码。

多设备支持

WhatsApp 官方限制一个账号只能有一个 Web 会话。如果已在浏览器登录 WhatsApp Web，需要先登出。