为什么连接WhatsApp
WhatsApp 是全球用户量最大的即时通讯应用之一，将 OpenClaw 连接到 WhatsApp 意味着你可以直接在日常使用的聊天界面中与 AI 助手对话。不需要打开额外的应用，不需要记住新的网址，给 AI 发消息就像给朋友发消息一样自然。
OpenClaw 通过 WhatsApp Web 协议实现连接，工作原理类似于在电脑上登录 WhatsApp Web。下面我们来完成整个配置过程。
前置条件
在开始之前，请确保：
- OpenClaw 已经安装并能正常运行（参考安装教程）
- 至少配置了一个 AI 模型提供商（如 Anthropic Claude）
- 你有一个正常使用的 WhatsApp 账号
- 手机上的 WhatsApp 应用是最新版本
通过Onboard向导添加WhatsApp频道
如果你还在初始化阶段，openclaw onboard 向导中会询问你要连接哪些频道，选择 WhatsApp 即可。
如果你已经完成了初始化，想要单独添加 WhatsApp 频道，可以运行：
openclaw channel add whatsapp
这个命令会启动 WhatsApp 频道的配置流程。
扫描二维码完成配对
运行添加频道命令后，终端中会显示一个二维码。你需要用手机上的 WhatsApp 扫描这个二维码来完成配对：
- 打开手机上的 WhatsApp
- 进入 设置 > 已关联的设备（iOS）或 菜单 > 已关联的设备（Android）
- 点击 关联设备
- 将手机摄像头对准终端中显示的二维码
扫描成功后，终端会显示连接成功的提示信息。整个过程通常在几秒内完成。
如果二维码过期了（通常 60 秒后过期），按 Enter 可以刷新生成新的二维码。
验证配置文件
配对完成后，OpenClaw 会自动更新配置文件。你可以查看 ~/.config/openclaw/openclaw.json5 确认 WhatsApp 频道已添加：
{
channels: {
whatsapp: {
enabled: true,
autoReply: true,
// 会话配置
allowedNumbers: [], // 空数组表示允许所有号码
ignoreGroups: true // 默认忽略群组消息
}
}
}
几个重要配置项说明：
autoReply：设为true时，收到消息后自动回复。设为false则需要以特定前缀触发。allowedNumbers：限制哪些号码可以与 AI 对话。留空表示不限制。出于安全考虑，建议填写你自己的号码。ignoreGroups：是否忽略群组中的消息。建议初期设为true，避免在群组中产生不必要的回复。
测试消息收发
确保 OpenClaw Gateway 正在运行：
openclaw up
然后用另一个 WhatsApp 账号（或者让朋友帮忙）给你的 WhatsApp 号码发送一条消息。如果一切配置正确，OpenClaw 会通过 AI 模型生成回复并自动发送回去。
你也可以自己给自己发消息进行测试。在 WhatsApp 中找到"自己"的对话（给自己发消息的功能），发送一条消息看是否收到 AI 回复。
通过 Dashboard 也可以观察消息的收发情况：
openclaw dashboard
Dashboard 中会显示所有频道的消息日志，方便你确认消息是否正常流转。
常见问题排查
二维码扫描后无反应
- 确保手机和电脑在同一网络环境下
- 检查 WhatsApp 是否是最新版本
- 尝试重启 OpenClaw 服务后重新扫描
消息发出但没有回复
首先检查 Gateway 日志：
openclaw logs
常见原因包括：
- AI 模型提供商的 API 密钥无效或余额不足
- 网络无法访问 API 端点（特别是在某些网络环境下）
autoReply被设为了false
连接频繁断开
WhatsApp Web 连接有时会因为网络波动而断开。OpenClaw 内置了自动重连机制，但如果频繁断开，可以检查：
- 手机上的 WhatsApp 是否保持在线
- 手机网络是否稳定
- 是否在其他设备上也登录了 WhatsApp Web（最多支持 4 个已关联设备）
运行诊断命令获取更多信息：
openclaw doctor
群组中不想回复
确保配置文件中 ignoreGroups 设为 true。如果你希望在特定群组中启用 AI 回复，可以配置群组白名单：
{
channels: {
whatsapp: {
ignoreGroups: false,
allowedGroups: ["群组ID1", "群组ID2"]
}
}
}
安全建议
- 通过
allowedNumbers限制可以与 AI 对话的号码，防止陌生人占用你的 API 额度 - 定期检查 Dashboard 中的消息日志，确保没有异常使用
- 不要在 AI 助手的对话中发送敏感个人信息
总结
WhatsApp 是 OpenClaw 最常用的频道之一，配置过程并不复杂。配对完成后基本不需要额外维护，OpenClaw 会自动处理连接保活和消息转发。如果在使用过程中遇到问题，可以查阅 OpenClaw官方文档 或到 OpenClaw GitHub仓库 搜索相关 Issue。更多频道的对接方法请访问 OpenClaw。