第 14 章：WhatsApp 通道 💬

适合人群：想用 WhatsApp 跟 Agent 聊天的你 本章目标：安装 WhatsApp 通道，扫码配对，收发消息

---

14.1 安装 WhatsApp 通道

Telegram 有官方的 Bot API，WhatsApp 可没有。要在 WhatsApp 上跑 Bot，我们需要借助 WhatsApp 的多设备协议——就是 WhatsApp 用来让手机+电脑+平板同时在线的那套技术。

自动安装

OpenClaw 内置了 WhatsApp 通道支持。最简单的启用方式是通过 onboard 流程：

openclaw onboard

在选择通道时，勾选 WhatsApp 即可。

手动配置

如果你已经装好了 OpenClaw，也可以在配置文件中手动启用：

// ~/.openclaw/openclaw.json
{
  channels: {
    whatsapp: {
      enabled: true,
    },
  },
}

安装可选增强包

为了让 WhatsApp 体验更好（比如收发图片、处理群组消息），可以装一个增强包：

clawhub install whatsapp-mcp

安装后重启 Agent：

openclaw restart

💡 clawhub 是什么？ clawhub 是 OpenClaw 的"应用商店"，专门用来安装技能扩展包。whatsapp-mcp 包为 WhatsApp 通道增加了更完整的功能支持。

---

14.2 扫码配对

WhatsApp 通道的核心操作就是扫码配对。你需要用一个 WhatsApp 账号作为"载体"来运行 Bot。

配对流程

第一步：启动 WhatsApp 通道

确保 Gateway 已经运行：

openclaw gateway start

然后在终端中运行 WhatsApp 配对命令：

openclaw channel connect whatsapp

OpenClaw 会生成一个 QR 码（二维码） 显示在终端中。

[截图：终端中显示的 WhatsApp QR 码]

第二步：用手机扫码

1. 打开手机上的 WhatsApp
2. 点右上角三个点（⋮）→ 已链接设备
3. 点 「关联设备」
4. 用手机扫终端里的二维码
5. 搞定！

[截图：手机上 WhatsApp「已链接设备」的界面入口]

第三步：确认配对码

WhatsApp 可能会弹出一个 配对码（6 位数字）。如果是首次在设备上使用，OpenClaw 会提示你确认：

[whatsapp] Pairing code: 123-456
If the code matches the one on your phone, approve with:
  openclaw pairing approve whatsapp 123456

对着终端显示的码和手机上的码，判断是否一致。一致的话就批准：

openclaw pairing approve whatsapp 123456

第四步：验证成功

终端会显示：

✔ WhatsApp connected successfully
[whatsapp] Session saved. Bot is ready to receive messages.

现在你的 WhatsApp 号就是一个 AI Bot 了！

⚠️ 注意事项：

• 建议用一个专门的 WhatsApp 号做 Bot，不要用你的主号（不方便日常聊天）
• WhatsApp 不支持一个号同时在多个设备上"以 Bot 身份"存在
• 如果扫不上码，检查终端字体/缩放，QR 码可能太小或太大
• 扫码成功后 Session 会自动保存，下次重启不需要重新扫

---

14.3 DM 和群组

私聊模式

WhatsApp 通道默认使用配对模式（Pairing Mode）——不认识的号码发消息，Bot 不会直接回复，而是需要你先在终端批准。

第一次私聊：

当陌生人发第一条消息时，终端会显示：

[whatsapp] New pairing request from +86-138****1234
  Code: 5821
  Use: openclaw pairing approve whatsapp 5821

批准后，这个号码才能跟 Bot 聊天。

查看已配对用户：

openclaw pairing list whatsapp

用户	状态	配对时间
+86-138****1234	✅ 已配对	2026-06-25 14:30
+86-139****5678	✅ 已配对	2026-06-24 09:15

取消配对：

openclaw pairing revoke whatsapp +8613812341234

开放模式

如果你想"先聊后批"（比如客服场景），可以设为开放模式：

openclaw config set channels.whatsapp.pairing false
openclaw gateway restart

设置后，任何人都可以直接跟 Bot 聊天，不再需要批准步骤。

群组支持

把 Bot 的号码拉进 WhatsApp 群组后：

• Bot 只响应**@提及**它的消息（默认）
• 也可以在群组中私信 Bot

配置群组策略：

{
  channels: {
    whatsapp: {
      groupPolicy: "open",     // "open": 允许所有群组 | "allowlist": 只允许指定群组 | "disabled": 禁止群组
      groupAllowlist: ["群组ID1", "群组ID2"],  // 当 groupPolicy 为 allowlist 时生效
    },
  },
}

💡 如何获取群组 ID？ 把 Bot 拉进群组后，Bot 会在终端中打印群组信息，包括群组名称和 ID。

[截图：WhatsApp 群组中 @Bot 并收到回复]

---

14.4 媒体消息

WhatsApp Bot 不仅能收发文字，还支持多媒体消息——这是它跟 Telegram Bot 最大的不同体验之一。

图片和照片

发照片给 Bot：

你：[发了一张产品照片]
Bot：我看到了！这是 iPhone 16 Pro 的背面，深空黑色。看起来是原装正品。

Bot 能识别图片内容的前提是：

• 你连接的 AI 模型支持多模态（比如 GPT-4o、Claude 3.5 Sonnet、Gemini 2.5 Pro）
• 你已经安装了 whatsapp-mcp 增强包

文档文件

支持发送 PDF、Word、Excel、文本文件等：

你：[发了一份 PDF 合同]
Bot：我帮你分析了这份合同。主要条款如下：
1. 服务期限：2026年7月1日至2027年6月30日
2. 费用：每月 ¥30,000
3. 自动续约条款：提前30天通知可终止...

语音消息

WhatsApp 支持发送语音消息到 Bot：

你：[发了一条语音消息说「帮我设置一个明天早上8点的闹钟」]
Bot：好的，已经帮你设置好明天早上 8:00 的提醒了。

语音转文字功能依赖于 AI 模型是否支持，或通过额外的语音识别服务。

位置信息

发送位置时，Bot 可以解析坐标：

你：[分享了你当前的位置]
Bot：你在北京朝阳区国贸附近。要我查查附近的餐厅吗？

媒体策略

你可以控制 Bot 是否处理媒体文件：

{
  channels: {
    whatsapp: {
      media: {
        maxSize: 20 * 1024 * 1024,  // 最大 20MB
        image: true,                  // 是否处理图片
        document: true,               // 是否处理文档
        audio: false,                 // 是否处理语音
        location: true,               // 是否处理位置
      },
    },
  },
}

---

常见问题

Q：扫码后 WhatsApp 显示「此设备已连接」，但 Bot 不回复？ 检查 Gateway 状态：openclaw gateway status。有时需要重启 Gateway 才能激活会话。

Q：可以同时在手机和 Bot 上用同一个 WhatsApp 号吗？ 可以！这就是多设备协议的好处。但这个号会收到 Bot 的回复和对话记录，如果你用它日常聊天可能会被打扰。建议用专门的小号。

Q：WhatsApp 封号风险？ 使用多设备协议的第三方客户端（无头浏览器或 puppeteer 方式）确实有一定封号风险。但 OpenClaw 用的是 WhatsApp Web 的官方协议，只要不过度滥用（比如每秒发几百条消息），个人使用基本没问题。

Q：换手机了要重新配对吗？ 是的。重新运行 openclaw channel connect whatsapp 重新扫码即可。旧的 Session 会失效。

---

本章小结

步骤	操作
1️⃣ 启用通道	在 openclaw.json 中添加 whatsapp 配置或通过 onboard
2️⃣ 扫码配对	openclaw channel connect whatsapp 并扫码
3️⃣ 确认配对码	如有提示，openclaw pairing approve whatsapp 代码
4️⃣ 配置策略	可设置配对模式、群组策略、媒体策略
5️⃣ 开始聊	私聊或群组 @提及你的 Bot

WhatsApp 的好处是用户量大，几乎人人都有。如果你想让你的长辈、同事、客户直接用他们已有的聊天工具跟 AI 聊天，WhatsApp 是最无门槛的选择。

下一章，我们来看看游戏玩家和开发者最爱的 Discord！

---