OpenClaw WhatsApp接入完整指南：从配置到实战

说实话，当我第一次成功在WhatsApp上和AI对话的时候，感觉还挺神奇的。平时用得最多的聊天工具，突然就能直接调用AI助手了，不用再来回切换应用。

如果你也想在WhatsApp上用OpenClaw，这篇文章会手把手教你怎么配置。WhatsApp的接入相比Telegram稍微复杂一点，但其实理解了原理之后，整个流程也就5-10分钟的事儿。

在开始之前，你可能会好奇：为啥不直接用Telegram或者Web界面？

其实每个平台都有自己的优势。对我来说，选择WhatsApp主要有这几个理由：

• 使用习惯：WhatsApp是我日常用得最多的聊天工具，家人朋友都在上面
• 无缝集成：不用再专门打开一个AI应用，在聊天界面就能问问题
• Linked Devices：WhatsApp的多设备功能很成熟，连接稳定
• 隐私可控：数据在自己服务器上，不经过第三方

当然，Telegram也有它的好处，比如API更开放、机器人生态更丰富。具体选哪个，看你自己的使用场景。

在开始接入之前，先确认几个前置条件：

1. OpenClaw已安装并运行 – 如果还没装，可以先看看之前的安装指南
2. 手机上有WhatsApp账号 – 需要是主账号，用来扫码连接
3. Gateway正在运行 – 确保已启动
4. 稳定的网络 – 扫码连接时需要网络畅通

有个小细节要注意：如果你用的是Bun运行时，在连接WhatsApp或Telegram时可能会遇到一些兼容性问题。官方推荐用Node.js运行Gateway，会更稳定一些。

验证一下你的openclaw运行环境：

OpenClaw提供了三种连接WhatsApp的方法，我按推荐程度给你介绍。

这是最傻瓜式的方法，适合第一次配置的朋友。

如果你还没完成初始配置，直接运行：

在向导过程中，会问你要连接哪些消息渠道。选择WhatsApp，然后：

1. 终端会显示一个二维码
2. 打开手机WhatsApp，进入”设置” → “已连接的设备”
3. 点击”关联设备”，扫描二维码
4. 扫码成功后，终端会提示连接完成

整个过程很快，1-2分钟就能搞定。第一次扫码的时候我还挺紧张的，生怕扫不上，结果一扫就通了。

如果你已经完成了onboard，只是想单独添加WhatsApp渠道，可以用这个命令：

运行后会发生什么：

1. 终端显示QR码（或者在Web界面显示）
2. 用WhatsApp扫码
3. 连接建立，开始接收消息

这个方法的好处是快速直接，不用进入完整的配置流程。

如果你想更精细地控制配置，可以通过Web界面来设置。

访问OpenClaw的控制面板（默认是），然后：

步骤1：进入配置页面

导航到 Settings → Config，点击右上角的 RAW 按钮，进入原始配置编辑器。

步骤2：添加WhatsApp配置

在部分添加WhatsApp配置：

让我解释一下这些配置项的含义：

• dmPolicy: 私聊消息策略，表示只允许白名单用户
• allowFrom: 白名单，填你自己的手机号（国际格式，加国家代码）
• groupPolicy: 群组消息策略，同样设为更安全
• mediaMaxMb: 允许接收的媒体文件最大大小（MB）
• debounceMs: 消息防抖延迟（毫秒），通常设为0

步骤3：保存并扫码

点击右上角的 Update 按钮保存配置，然后回到 Channels 页面，会看到一个二维码。用WhatsApp扫码即可。

刚才提到的那些配置项，咱们深入聊聊。

和是两个很关键的安全配置。

dmPolicy（私聊策略）有三个选项：

• ：只有白名单里的号码能发消息（推荐）
• ：黑名单之外的都能发
• ：所有人都能发（不推荐，除非你知道自己在干什么）

我自己用的是，只把自己和家人的号码加进去。毕竟AI有访问系统的权限，不想让陌生人乱发消息。

allowFrom电话号码格式

号码必须用国际格式，包含国家代码：

别忘了加号和国家代码，否则会识别不出来。

groupPolicy（群组策略）

如果你想在WhatsApp群组里用AI，需要配置群组策略。不过老实讲，我不太建议在群里直接开放AI权限，除非是你完全信任的私密小群。

可以这样配置：

群组ID可以在日志里找到，或者先设为，发一条消息后在日志里看到ID。

OpenClaw会自动把WhatsApp消息路由给AI模型处理。整个流程是这样的：

1. 你在WhatsApp发送消息
2. OpenClaw Gateway接收到消息
3. 检查发送者是否在白名单
4. 如果通过，转发给AI模型
5. AI生成回复
6. 回复发送到WhatsApp

这个过程很快，通常在1-2秒内完成（取决于AI模型的响应速度）。

设置决定了能接收多大的文件。默认50MB基本够用。

目前OpenClaw支持的媒体类型包括：

• 图片（JPG、PNG等）
• 音频文件
• 文档（PDF、TXT等）

如果你的AI配置了视觉能力（比如GPT-4V），发送图片时AI可以识别图片内容。

不管用哪种方法，最后都要扫二维码。这个步骤虽然简单，但有几个细节要注意。

1. 打开WhatsApp应用
2. 点击右上角的”更多选项”（三个点）
3. 选择”已连接的设备”（或”Linked Devices”）
4. 点击”关联设备”（或”Link a Device”）
5. 可能需要验证指纹或输入密码
6. 摄像头打开后，对准电脑上的二维码

• QR码有效期：二维码通常1-2分钟后过期，扫不上就刷新重新生成
• 清晰度：确保二维码显示清晰，终端字体不要太小
• 网络：扫码瞬间需要网络连接，确保手机和电脑都在线

我第一次扫的时候，因为终端字体太小，二维码糊成一团，扫了好几次才成功。后来发现调大终端窗口就好了。

扫码成功后，你会看到：

• 手机端：在”已连接的设备”列表里出现OpenClaw
• 电脑端：终端显示”WhatsApp connected”或类似提示
• Web界面：Channels页面显示WhatsApp为绿色（已连接）

连接完成后，马上测试一下，确保一切正常。

在WhatsApp上给自己发一条消息，比如：

如果配置正确，AI应该会在几秒内回复。我第一次收到回复的时候，看着手机屏幕傻笑了半天——太神奇了。

试试这些操作：

• 文本消息：问AI一个问题
• 图片：发送一张图片，让AI描述内容（需要视觉模型）
• 文档：发送PDF或TXT文件
• 语音：如果支持，可以试试语音转文字

如果出问题了，看看日志能帮助排查：

日志会显示接收到的消息、处理过程、错误信息等。

装软件嘛，难免会遇到问题。我把自己踩过的坑和解决方法列出来。

可能原因：

• 二维码已过期
• 网络连接问题
• WhatsApp版本太旧

解决方法：

1. 刷新二维码重新扫描
2. 检查手机和电脑的网络连接
3. 更新WhatsApp到最新版本

这是个挺常见的错误，官方文档里专门提到过。

完整错误信息：

解决方法：

1. 回到 Settings → Config
2. 点击右上角 Update 按钮（即使没改配置）
3. 返回 Channels 页面检查连接状态
4. 如果还不行，重启Gateway

可能原因：

• 发送者不在白名单
• AI模型配置有问题
• API密钥失效

排查步骤：

1. 检查号码格式是否正确（国际格式）
2. 查看日志，确认消息被接收
3. 测试AI是否能在Web界面正常响应
4. 验证API密钥是否有效

症状：发消息后收到”Permission denied”或无回复

解决：

• 确认你的号码在列表里
• 检查号码格式（包括国家代码）
• 如果是群组消息，检查设置

可能原因：

• 文件超过限制
• 文件格式不支持
• 网络上传失败

解决：

• 调大设置
• 尝试压缩文件
• 检查网络连接

症状：重启电脑或Gateway后，WhatsApp断开连接

解决：

1. 正常情况下应该自动重连
2. 如果没有，重新运行
3. 重新扫码连接
4. 或者检查守护进程是否正常启动

基本功能搞定之后，可以玩一些进阶的配置。

WhatsApp允许同时连接多个设备。如果你有多台电脑都装了OpenClaw，可以分别连接，消息会同步到所有设备。

不过要注意：同一个WhatsApp账号，OpenClaw只能连一次。如果要连多台电脑，需要用不同的WhatsApp账号。

可以在配置里设置来控制消息防抖：

这样如果你连续发送多条消息，AI会等1秒后一起处理，避免频繁调用API。

如果你想忽略某些类型的消息，可以在技能（Skills）配置里设置过滤规则。比如只响应以”AI”开头的消息。

如果消息量很大，可以考虑：

• 减少限制，节省带宽
• 调整，避免频繁请求
• 使用更快的AI模型

WhatsApp接入后，有几个安全方面的事项务必注意：

只把信任的号码加到列表。记住，这些号码可以通过AI执行系统命令（如果开启了相应技能），权限很大。

在WhatsApp的”已连接的设备”里，定期看看有哪些设备在线。如果发现不认识的，立即移除。

对于删除文件、修改配置等操作，建议在技能里加上二次确认机制，避免误操作。

如果在网吧、图书馆等公共场所，不要扫码连接WhatsApp。设备可能被监控，导致账号泄露。

保持OpenClaw更新到最新版本，确保安全补丁及时应用：

好了，到这里你应该已经成功把WhatsApp接入OpenClaw了。回顾一下整个流程：

如果你还在纠结用哪个平台，这里给点建议：

选择WhatsApp如果：

• 日常主要用WhatsApp沟通
• 需要和家人朋友共享AI
• 重视Linked Devices的稳定性

选择Telegram如果：

• 想要更开放的API能力
• 需要使用机器人生态
• 对频道、群组功能有需求

说实话，两个都配上也行。OpenClaw支持多渠道同时运行，可以在WhatsApp和Telegram上同时接入，看具体场景选择合适的平台。

连接成功后，你可以：

• 探索OpenClaw的Skills功能，给AI添加更多能力
• 试试发送图片、文档，测试多模态功能
• 研究一下自定义回复逻辑
• 如果有兴趣，开发自己的技能插件

最后提醒一句：WhatsApp接入虽然方便，但也要注意安全。谨慎管理白名单，不要把AI权限开放给不信任的人。

玩得开心，有问题随时查文档或者去社区问问！

12 分钟阅读 · 发布于: 2026年2月5日 · 修改于: 2026年3月3日