BetterLink Logo 比邻
切换语言
中文 English 日本語
切换主题

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

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

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

为什么要在WhatsApp上接入AI？

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

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

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

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

准备工作：确认你的环境

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

必备条件

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

技术提醒

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

验证一下你的运行环境：

# 检查Node.js版本
node --version

# 确认Gateway在运行
ps aux | grep openclaw

三种接入方法

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

方法一：onboard向导（最简单）

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

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

openclaw onboard --install-daemon

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

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

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

方法二：channels login命令

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

openclaw channels login

运行后会发生什么：

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

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

方法三：Web界面配置（最灵活）

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

访问OpenClaw的控制面板（默认是http://localhost:18789），然后：

步骤1：进入配置页面

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

步骤2：添加WhatsApp配置

在channels部分添加WhatsApp配置：

{
  "channels": {
    "whatsapp": {
      "dmPolicy": "allowlist",
      "allowFrom": ["+8613800138000"],
      "groupPolicy": "allowlist",
      "mediaMaxMb": 50,
      "debounceMs": 0
    }
  }
}

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

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

步骤3：保存并扫码

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

详细配置说明

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

权限管理：谁能给你的AI发消息？

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

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

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

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

allowFrom电话号码格式

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

"allowFrom": [
  "+8613800138000",    // 中国号码
  "+14155552671",      // 美国号码
  "+447700900000"      // 英国号码
]

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

groupPolicy（群组策略）

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

可以这样配置：

"groupPolicy": "allowlist",
"allowFrom": ["群组ID"]

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

消息路由：AI怎么处理你的消息

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

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

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

媒体文件处理

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

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

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

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

QR码扫描步骤详解

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

手机端操作

  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文件
  • 语音：如果支持，可以试试语音转文字

查看日志

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

# 查看OpenClaw日志
openclaw gateway --port 18789

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

常见问题排查

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

问题1：QR码扫描后无反应

可能原因：

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

解决方法：

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

问题2：连接失败，报错status=515

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

完整错误信息：

WhatsApp login failed: status=515 Unknown Stream Errored (restart required)

解决方法：

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

问题3：消息发送了，AI不回复

可能原因：

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

排查步骤：

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

问题4：权限被拒绝

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

解决：

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

问题5：媒体文件无法发送

可能原因：

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

解决：

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

问题6：Gateway重启后断连

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

解决：

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

高级技巧

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

多设备管理

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

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

自定义回复策略

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

"debounceMs": 1000

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

此消息过滤

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

性能优化

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

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

安全建议

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

1. 严格控制白名单

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

2. 定期检查连接设备

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

3. 敏感操作需要确认

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

4. 不要在公共设备上连接

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

5. 定期更新OpenClaw

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

npm update -g openclaw
# 或
pnpm update -g openclaw

写在最后

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

WhatsApp接入OpenClaw流程

将OpenClaw连接到WhatsApp实现AI聊天的详细步骤

⏱️ 预计耗时: 15 分钟

  1. 1

    步骤1: 准备工作

    确认Gateway运行中，手机WhatsApp准备好。
    推荐使用Node.js环境。
  2. 2

    步骤2: 启动连接

    运行 openclaw channels login。
    或者使用Web界面进入 Config (设置) -> Channels。
  3. 3

    步骤3: 配置权限

    必须配置 dmPolicy: "allowlist"。
    在 allowFrom 中填入国际格式手机号（如 +86...）。
  4. 4

    步骤4: 扫码绑定

    手机WhatsApp -> 设置 -> Linked Devices。
    对准终端/屏幕上的二维码扫描。
  5. 5

    步骤5: 测试验证

    发送消息给AI（如“你好”）测试响应。
    检查Web界面Channels状态是否变绿。

WhatsApp vs Telegram：怎么选？

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

选择WhatsApp如果：

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

选择Telegram如果：

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

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

下一步做什么？

连接成功后，你可以：

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

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

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

参考来源：

常见问题

扫码后无反应？
二维码过期快（1-2分钟），请刷新重试。
确保手机和电脑网络畅通。
报错 Status 515？
常见错误。进入 Web UI Config 页点击 Update（无需修改）。
或者尝试重启 Gateway。
AI 不回复？
检查手机号格式是否正确（必须带国家代码 +86...）。
确认该号码在 allowFrom 白名单中。
支持群聊吗？
支持，需配置 groupPolicy: "allowlist"。
建议谨慎开启群聊权限。

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

Easton Easton
AI与智能

评论

使用 GitHub 账号登录后即可评论

相关文章

让
2026年2月5日 AI与智能

让AI替你看文档：OpenClaw浏览器自动化实战指南

OpenClaw浏览器自动化控制台界面展示
2026年2月5日 AI与智能

让AI替你看文档：OpenClaw浏览器自动化实战指南

O
2026年2月5日 AI与智能

OpenClaw架构深度解析：三层设计的技术原理与扩展实践

OpenClaw三层架构示意图
2026年2月5日 AI与智能

OpenClaw架构深度解析：三层设计的技术原理与扩展实践
O
2026年2月5日 AI与智能

OpenClaw配置详解：openclaw.json完全指南与最佳实践

OpenClaw配置文件结构与安全策略示意图
2026年2月5日 AI与智能

OpenClaw配置详解：openclaw.json完全指南与最佳实践

推广Vultr - 高性能 NVMe 云服务器，32 个全球节点可选，支持一键部署 Docker