OpenClaw WhatsApp 全配置指南：手机直控 AI 助理，Android 和 iPhone 通用
教程说明：本文是 OpenClaw 接入 WhatsApp 渠道的完整配置指南，适用于 Android 和 iPhone 用户。WhatsApp 是目前全球用户数量最多的即时通讯应用，将 OpenClaw 与 WhatsApp 打通后，你可以用全球 20 亿人都在使用的软件直接与 AI 助理对话，支持文字、语音消息、图片、文件等全类型交互。本教程涵盖 Baileys 方案和官方 WhatsApp Business API 两种接入方式的选择与配置全流程。
为什么 WhatsApp 是连接 OpenClaw 的最佳渠道之一？
OpenClaw 支持多种通讯渠道，每种都有其适用场景。WhatsApp 相比 Telegram 有几个独特优势：首先，WhatsApp 在全球的覆盖面远超 Telegram，几乎每个有智能手机的人都装着 WhatsApp；其次，WhatsApp 支持语音消息转文字功能，你可以对着手机说话，AI 助理会自动识别语音并响应，解放双手；此外，WhatsApp 的端对端加密保护所有消息内容，隐私安全性极高。
对于海外华人、跨国工作者或需要与国际团队协作的用户，WhatsApp 尤其有价值——它是目前唯一一个在中国大陆以外几乎无处不在的即时通讯工具，将 OpenClaw 接入 WhatsApp，意味着无论身处何地，AI 助理都触手可及。
两种接入方式：如何选择？
OpenClaw 支持两种 WhatsApp 接入方式，选择前请了解它们的区别：
方式一：Baileys（个人账号）
推荐普通用户- 使用你现有的个人 WhatsApp 账号
- 完全免费，无需申请 API
- 5分钟内完成配置
- WhatsApp 可能检测并封号（风险小）
- 建议使用备用手机号
方式二：WhatsApp Business API
推荐商业用户- 官方支持，不会被封号
- 可发送模板消息
- 支持多设备同时连接
- 需要 Meta Business 账号审核（1-3天）
- 发送消息有费率（每条约 ¥0.1-0.5）
建议：个人用户首选 Baileys 方案
对于个人使用的 OpenClaw，Baileys 方案简单直接，封号风险在日常使用中非常低（和使用 WhatsApp Web 没有本质区别）。本教程重点介绍 Baileys 方案的完整配置步骤，适合 99% 的普通用户。
第一步：准备工作
在开始配置 WhatsApp 渠道之前，请确认以下准备工作已完成：
OpenClaw 已安装并完成基础 onboard 配置
WhatsApp 是 OpenClaw 的通讯渠道之一，需要先完成 OpenClaw 本体的安装。运行 openclaw --version 确认已安装。
准备一个 WhatsApp 账号（建议使用备用号）
虽然可以用主号，但建议使用一个专用备用手机号注册 WhatsApp 账号，专门用于 OpenClaw 连接，避免日常聊天和 AI 对话混在一起。可以用虚拟手机号（如 Google Voice）注册。
稳定的网络连接（能访问 WhatsApp 服务器）
WhatsApp 服务器在境外，国内需要 VPN 才能访问。运行 OpenClaw 的主机（电脑/服务器）需要配置好 VPN07，确保与 WhatsApp 服务器的连接稳定。
第二步：安装 WhatsApp 连接依赖
OpenClaw 使用 Baileys 库连接 WhatsApp，安装 Baileys 依赖可以通过 OpenClaw 的 Skill 系统完成：
# 方法一：通过 OpenClaw 命令安装 WhatsApp 渠道
openclaw channels install whatsapp
# 方法二：手动安装 Baileys 依赖
npm install -g @whiskeysockets/baileys
# 验证安装
openclaw channels list
关于 Baileys 版本
OpenClaw 内部使用的是 Baileys 的最新稳定版（@whiskeysockets/baileys），这是目前最活跃维护的 WhatsApp Web API 库，支持多设备模式（Multi-Device），连接稳定性远优于旧版 Baileys。
第三步：扫码连接 WhatsApp 账号
连接 WhatsApp 账号需要用手机扫描二维码，流程与登录 WhatsApp Web 完全相同：
# 启动 WhatsApp 配置向导
openclaw channels configure whatsapp
# 终端会显示一个 QR 码（用 ASCII 字符绘制）
# 用你的手机 WhatsApp 扫描此 QR 码：
# WhatsApp → 设置 → 关联设备 → 关联设备 → 扫描
在手机上打开 WhatsApp
打开手机上的 WhatsApp 应用（Android 或 iPhone 均可）
进入"关联设备"菜单
Android：点击右上角三点菜单 → 关联设备
iPhone：底部菜单点"设置" → 关联设备
点击"关联设备"并扫描二维码
点击"关联设备"按钮，手机摄像头会打开，将摄像头对准终端中显示的 QR 码（注意：QR 码有时效性，90秒内扫描）
等待连接确认
扫码成功后，终端会显示 "WhatsApp connected successfully"，手机的"已关联设备"列表中会出现新设备。至此，OpenClaw 已成功接入 WhatsApp。
第四步：配置权限、触发词和隐私保护
默认情况下，任何人发给这个 WhatsApp 号码的消息都会被 OpenClaw 处理。为了安全性，需要配置访问控制：
channels:
whatsapp:
enabled: true
# 白名单：只处理来自这些号码的消息
allowed_senders:
- "+8613800138000" # 你的手机号（替换为实际号码）
# 触发词：消息必须包含此前缀才会触发AI响应
# 不设置则所有消息都触发
trigger_prefix: "AI:"
# 语音消息自动转文字（需要 Whisper）
auto_transcribe_voice: true
# 是否允许群组消息
allow_group_messages: false
# 回复延迟（秒，模拟人类打字）
reply_delay: 1
第五步：与 AI 助理发起第一次 WhatsApp 对话
配置完成后，启动 OpenClaw 并测试：
# 启动 OpenClaw（如果尚未运行）
openclaw start
# 查看运行状态
openclaw status
# 查看 WhatsApp 渠道状态
openclaw channels status whatsapp
然后打开手机 WhatsApp，找到你用于 OpenClaw 的那个号码（给那个号码发消息），发送测试消息：
WhatsApp 对话示例（绿色气泡为发出，白色为AI回复）
WhatsApp 独家功能：语音消息直接下达 AI 指令
WhatsApp 的语音消息功能是它相对于 Telegram 最独特的体验。开车时不方便打字？开会中不方便说话？只需按住麦克风发一段语音，OpenClaw 的 Whisper 语音识别模块会自动将你的语音转换成文字，然后执行对应的 AI 指令。
启用语音消息转文字功能，需要在 OpenClaw 中配置 Whisper 集成：
# 安装语音识别 Skill
openclaw skills install whisper-transcription
# 或者使用 OpenAI Whisper API（更准确）
# 在 config.yaml 中添加：
# transcription:
# provider: openai
# api_key: "YOUR_OPENAI_API_KEY"
常见问题解答
Q: 扫码后提示"This phone number is banned"
A: 这个手机号之前可能被 WhatsApp 标记过。换一个新手机号注册 WhatsApp 账号后再试。建议使用与主号不同的新号码，可以使用 Google Voice 等虚拟号码服务获取一个专用号码。
Q: OpenClaw 断线重连时 WhatsApp 需要重新扫码吗？
A: 通常不需要。Baileys 方案会将 WhatsApp 会话信息保存到本地文件（~/.openclaw/whatsapp_auth_info.json），重启 OpenClaw 后会自动恢复连接，无需重新扫码。但如果会话文件损坏或超过30天未使用，可能需要重新扫码。
Q: WhatsApp 消息发不出去，提示 Connection closed
A: 这通常是网络问题。OpenClaw 运行的主机需要能访问 WhatsApp 的服务器（web.whatsapp.com，位于境外）。检查 VPN07 是否正常运行，确认系统代理已开启。运行 curl -I https://web.whatsapp.com 测试连通性。
Q: 能同时连接 WhatsApp 和 Telegram 吗？
A: 完全可以。OpenClaw 支持同时连接多个渠道，你的一个 AI 助理可以同时监听 WhatsApp、Telegram、Discord 等多个平台的消息，在任何一个平台发送指令都会得到响应。
关键：让 WhatsApp 连接始终稳定的秘诀
WhatsApp 的服务器与 OpenAI/Anthropic API 服务器都在境外，国内用户在运行 OpenClaw 时面临双重网络挑战：既要保证 WhatsApp 的长连接稳定，又要保证 AI API 的低延迟响应。这两个问题的解决方案相同——使用高质量的 VPN 服务。
VPN07 是专为有跨境网络需求的用户打造的 VPN 服务，运营十年，具有丰富的长连接优化经验。1000Mbps 千兆带宽确保 OpenClaw 的所有境外请求（WhatsApp 长轮询 + AI API 调用）都能以最高速度运行，网络延迟控制在 50ms 以内，让你的 WhatsApp AI 助理响应速度与直连一样流畅。
VPN07 — WhatsApp + AI API 双重稳定保障
长连接优化 · 千兆带宽 · 运营十年
OpenClaw 接入 WhatsApp 后，需要同时保持与 WhatsApp 服务器的长连接以及对 AI API 的快速访问。VPN07 运营十年，在长连接稳定性上有深厚积累，1000Mbps 千兆带宽确保 WhatsApp 消息实时推送、AI 响应2秒内完成。70+ 国家节点覆盖全球，无论你的 OpenClaw 部署在哪里，都能找到最优节点。¥9/月起，30天退款保证。