github star gitee star atomgit star PyPI Downloads AI 编程 AI 交流群

大家好，我是正在实战各种AI项目的程序员晚枫。

今天我们来连接WhatsApp，全球用户量最大的即时通讯工具（超过20亿用户）。如果你的客户或朋友在国外，这几乎是必选项。

🚀 开篇：先搞清楚方案

OpenClaw支持两种WhatsApp接入方式：

方式优点缺点
WhatsApp Web免费，个人号可用需要保持手机在线
WhatsApp Business API稳定，企业级需Meta审核，有费用

本教程使用WhatsApp Web方式，适合个人和小团队。

⚠️ 重要风险提示

使用非官方方式连接WhatsApp有风险：

  • 可能违反WhatsApp服务条款
  • 有封号风险
  • 可能不稳定

建议：

  • 使用备用号码测试
  • 不要用于商业用途
  • 控制消息频率
  • 考虑企业微信方案（更稳定）

第一步：安装依赖

WhatsApp通道需要额外依赖：

1
2
3
4
5
# 安装puppeteer（用于浏览器自动化）
npm install -g puppeteer

# 或使用OpenClaw插件
openclaw plugins install whatsapp

第二步：配置OpenClaw

编辑 ~/.openclaw/openclaw.json：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
{
  "channels": {
    "whatsapp": {
      "enabled": true,
      "sessionName": "default",
      "headless": false,
      "allowFrom": [],
      "groups": {
        "enabled": true,
        "requireMention": true
      }
    }
  }
}

配置说明：
| 参数 | 说明 |
|------|------|
| sessionName | 会话标识，多账号时区分 |
| headless | false=显示浏览器窗口（首次配对用） |
| allowFrom | 白名单手机号 |

第三步：启动配对 🔗

执行命令：

1
openclaw channels connect whatsapp

会看到：

1
2
3
4
[whatsapp] Initializing...
[whatsapp] Launching browser...
[whatsapp] Please scan the QR code with your phone
[whatsapp] Waiting for authentication...

同时弹出浏览器窗口，显示QR码。

第四步：手机扫码

  1. 打开手机WhatsApp
  2. 设置 → 已关联设备 → 关联新设备
  3. 扫描电脑屏幕上的QR码
  4. 等待连接成功

看到以下提示表示成功：

1
2
3
[whatsapp] Authenticated successfully
[whatsapp] Session saved
[whatsapp] Connected ✓

测试对话

私聊测试

给自己或朋友发送消息：

1
你好，我是AI助手

群组测试

在群组中@你的号码：

1
@+86138xxxxxxxx 分析一下这份数据

生产环境配置

限制白名单

1
2
3
4
5
6
7
8
9
10
11
12
{
  "channels": {
    "whatsapp": {
      "allowFrom": ["+86138xxxxxxxx", "+86139xxxxxxxx"],
      "groups": {
        "enabled": true,
        "allowedGroups": ["群ID1", "群ID2"],
        "requireMention": true
      }
    }
  }
}

无头模式（服务器部署）

1
2
3
4
5
6
7
8
9
10
11
{
  "channels": {
    "whatsapp": {
      "headless": true,
      "browserArgs": [
        "--no-sandbox",
        "--disable-setuid-sandbox"
      ]
    }
  }
}

常见问题 🛠️

Q1: QR码扫不上

解决：

  • 确保手机和电脑在同一网络
  • 刷新QR码：openclaw channels repair whatsapp
  • 检查浏览器是否被防火墙阻挡

Q2: 连接后很快断开

原因：手机断网或WhatsApp被关闭

解决：保持手机WhatsApp在前台运行

Q3: 提示Session无效

解决：

1
2
3
# 清除旧session
rm -rf ~/.openclaw/state/whatsapp/
openclaw channels connect whatsapp

与Telegram对比

特性TelegramWhatsApp
国内访问⚠️ 需代理⚠️ 较困难
稳定性⭐⭐⭐⭐⭐⭐⭐⭐
用户量8亿20亿+
配置难度简单中等
封号风险低中

建议：海外用户优先用WhatsApp，国内用户优先用Telegram。

下节预告

下一讲连接Discord，开发者社区最流行的平台。

👉 继续阅读：第9讲-Discord通道连接与Slash命令

💬 加入学习交流群

WhatsApp连接问题？加群交流：

👉 点击加入交流群

推荐：AI Python编程实战营

🎁 限时福利：送《利用Python进行数据分析》实体书

👉 点击了解详情

---## 📚 完整学习路线这是OpenClaw入门课程的第X讲。查看完整课程大纲：👉 **OpenClaw入门课程大纲**课程包含30讲，从安装部署到实战项目，带你全面掌握OpenClaw。

课程导航

上一篇： 第7讲-Telegram通道连接实战

下一篇： 第9讲-Discord通道连接与Slash命令

PS：WhatsApp虽然配置稍复杂，但覆盖面最广。如果你有海外业务，这个通道值得投入时间。

💬 联系我

平台账号/链接
微信扫码加好友
微博@程序员晚枫
知乎@程序员晚枫
抖音@程序员晚枫
小红书@程序员晚枫
B 站Python 自动化办公社区

主营业务：AI 编程培训、企业内训、技术咨询

🎓 AI 编程实战课程

想系统学习 AI 编程？程序员晚枫的 AI 编程实战课 帮你从零上手！