OpenClaw入门：第8讲：WhatsApp通道连接，全球20亿用户的AI入口

2026-03-01

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

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

WhatsApp连接方式

OpenClaw支持两种WhatsApp接入方式：

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

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

准备工作

必要条件

一个WhatsApp账号（手机号）
该号码已注册WhatsApp
能接收短信验证码

注意事项

⚠️ 风险提示：使用非官方方式连接WhatsApp可能违反服务条款，有封号风险。建议：

使用备用号码测试
不要频繁发送消息
避免商业营销用途

配置步骤

第一步：安装依赖

WhatsApp通道需要额外依赖：

# 安装puppeteer（用于浏览器自动化）
npm install -g puppeteer

# 或在OpenClaw目录安装
openclaw plugins install whatsapp

第二步：配置OpenClaw

编辑 ~/.openclaw/openclaw.json：

{
  "channels": {
    "whatsapp": {
      "enabled": true,
      "sessionName": "default",
      "headless": false,
      "allowFrom": [],
      "groups": {
        "enabled": true,
        "requireMention": true
      }
    }
  }
}

配置说明：

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

第三步：启动配对

执行命令：

1	openclaw channels connect whatsapp

会看到以下流程：

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

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

第四步：手机扫码

打开手机WhatsApp
设置 → 已关联设备 → 关联新设备
扫描电脑上的QR码
等待连接成功

看到以下提示表示成功：

1
2
3

[whatsapp] Authenticated successfully
[whatsapp] Session saved
[whatsapp] Connected ✓

测试对话

私聊测试

给自己或朋友发送消息：

你好，我是AI助手

群组测试

在群组中@你的号码：

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

多设备管理

查看已连接设备

在手机上：设置 → 已关联设备

断开连接

# 从OpenClaw断开
openclaw channels disconnect whatsapp

# 或从手机端移除设备

重新配对

如果Session过期或失效：

# 删除旧session
rm ~/.openclaw/state/whatsapp/default.session

# 重新配对
openclaw channels connect whatsapp

生产环境配置

获取允许的手机号

{
  "channels": {
    "whatsapp": {
      "allowFrom": ["+86138xxxxxxxx", "+86139xxxxxxxx"],
      "groups": {
        "enabled": true,
        "allowedGroups": ["群ID1", "群ID2"],
        "requireMention": true
      }
    }
  }
}

无头模式（服务器部署）

{
  "channels": {
    "whatsapp": {
      "headless": true,
      "browserArgs": [
        "--no-sandbox",
        "--disable-setuid-sandbox"
      ]
    }
  }
}

常见问题

Q1: QR码扫不上

解决：

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

Q2: 连接后很快断开

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

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

Q3: 收不到消息

排查：

# 查看详细日志
tail -f ~/.openclaw/state/logs/whatsapp.log

# 检查session状态
openclaw channels status whatsapp

Q4: 提示Session无效

解决：

# 清除session重新配对
openclaw channels disconnect whatsapp
rm -rf ~/.openclaw/state/whatsapp/
openclaw channels connect whatsapp

与Telegram对比

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

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

下节预告

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

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

💬 加入学习交流群

WhatsApp连接问题？加群交流：

👉 点击加入交流群

推荐：AI Python编程实战营

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

👉 点击了解详情

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

课程导航

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

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

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

jsonContent: meta: false pages: false posts: title: true date: true path: true text: false raw: false content: false slug: false updated: false comments: false link: false permalink: false excerpt: false categories: false tags: true