OpenClaw + WhatsApp完整配置教程：手机聊天直接指挥AI干活
教程说明：本文详细介绍如何将 OpenClaw AI 助理与 WhatsApp 完整集成。WhatsApp 是全球下载量最大的通讯应用，超过 20 亿用户每天使用。将 OpenClaw 接入 WhatsApp 后，你可以随时随地通过手机消息让 AI 完成邮件管理、任务安排、信息查询、文件处理等各类工作，无需专门打开 App，就像给一个随时在线的私人助理发消息一样自然。
为什么 WhatsApp 是接入 OpenClaw 的最佳选择
在 OpenClaw 支持的所有通讯渠道中，WhatsApp 是社区安装量最高的集成方式，超过5000个活跃实例使用它。原因非常简单：你不需要改变任何使用习惯，AI 助理直接活在你每天都会打开几十次的应用里。相比 Telegram 或 Discord，WhatsApp 的优势在于它在全球大多数国家都是默认的通讯应用，你的联系人基本都在用。
OpenClaw 通过 WhatsApp 的"关联设备"功能（类似 WhatsApp Web）接入你的账户，无需申请商业账户或 API 权限，普通个人账号即可使用。AI 助理会在你的 WhatsApp 中以联系人或群组成员的形式出现，你发消息给它，它立即响应并执行任务。
开始前的准备工作
在开始配置 WhatsApp 集成之前，请确认已完成以下准备：
已安装并运行 OpenClaw
WhatsApp 是 OpenClaw 的通讯渠道，需先完成 OpenClaw 本体的安装。运行 npm i -g openclaw 完成安装。
一个可用的 WhatsApp 账号（推荐专用号码）
强烈建议使用专用手机号作为 AI 助理账号，避免与个人聊天混用。可以购买一张备用SIM卡，或使用虚拟号码服务注册。
Node.js v22 或更高版本
WhatsApp 集成库 whatsapp-web.js 要求 Node.js v22+。运行 node --version 确认版本。
AI API Key（Claude 或 OpenAI）
需要 Anthropic Claude API Key 或 OpenAI API Key，这是 OpenClaw 的 AI 驱动核心。
稳定的网络连接（必须能访问境外服务）
WhatsApp 和 AI API 均需要访问境外服务器。强烈建议配合高质量 VPN 使用，确保连接稳定性。
关键提示：WhatsApp Web 的网络要求
OpenClaw 接入 WhatsApp 使用的是 whatsapp-web.js 库，该库模拟 WhatsApp Web 的连接方式。由于 WhatsApp 的服务器均在境外，在中国大陆使用时必须通过 VPN 才能保持稳定连接。若 VPN 断线，WhatsApp 集成也会中断，AI 助理将暂时无法响应。因此选择一个稳定的 VPN 服务至关重要。
第一步：安装并初始化 OpenClaw
如果尚未安装 OpenClaw，先完成本体安装。打开终端（macOS/Linux）或 PowerShell（Windows），执行以下命令：
# 安装 OpenClaw
npm i -g openclaw
# 验证安装
openclaw --version
# 初始化配置（首次使用）
openclaw onboard
openclaw onboard 会引导你完成基础配置，包括给 AI 助理起名、输入 API Key 等。完成这一步后，再进行 WhatsApp 集成配置。
第二步：安装 WhatsApp 集成技能
OpenClaw 采用技能（Skill）插件架构，WhatsApp 集成作为一个官方技能，通过以下命令安装：
# 安装 WhatsApp 技能
openclaw skill install whatsapp
# 查看已安装的技能列表
openclaw skill list
关于技能安装
OpenClaw 的技能系统类似 App Store，官方维护了数十个常用集成技能。WhatsApp 技能安装包含 whatsapp-web.js 库及其所有依赖，整个过程约需1-3分钟（取决于网络速度）。安装时需确保网络畅通，推荐提前开启 VPN。
第三步：扫码绑定 WhatsApp 账号
这是最关键的一步——将 WhatsApp 账号与 OpenClaw 关联。运行以下命令启动配对流程：
# 启动 WhatsApp 配对
openclaw whatsapp pair
# 或者通过 Gateway 启动
openclaw gateway
终端会显示一个二维码。按照以下步骤完成手机端扫码：
-
1
打开 WhatsApp 手机应用
使用你为 AI 助理专门准备的手机号对应的 WhatsApp 账号
-
2
进入设置 → 关联设备
在 WhatsApp 主界面点击右上角菜单 → 关联设备（Linked Devices）
-
3
点击"关联设备"按钮
系统会调用摄像头，进入扫码状态
-
4
扫描终端中显示的二维码
将摄像头对准终端屏幕上的二维码，成功后终端会显示"WhatsApp connected!"
-
5
发送测试消息验证连接
从你的主 WhatsApp 号码给 AI 助理号码发送消息（如"你好"），AI 应在几秒内回复
第四步：配置触发词和消息权限
为了防止群聊消息误触发 AI，OpenClaw 支持设置触发词。只有以触发词开头的消息才会被 AI 处理。默认触发词是 claw，你可以在配置文件中修改：
# 查看配置文件位置
openclaw config path
# 编辑配置文件（macOS/Linux）
nano ~/.openclaw/config.json
# 在配置文件中修改触发词
{
"whatsapp": {
"trigger": "小助", // 改成你喜欢的触发词
"allowGroups": false, // 是否允许群聊触发
"authorizedNumbers": ["+8613800000000"] // 只允许指定号码
}
}
安全建议
- • 设置
authorizedNumbers白名单 - • 仅允许你自己的号码触发 AI
- • 禁用群聊触发，防止误操作
- • 定期检查 AI 的执行日志
触发词设计建议
- • 使用不常见的词，如"小七"、"助手"
- • 避免使用常见词防止误触发
- • 也可以设置不需要触发词（私聊模式）
- • 群聊中触发词必不可少
第五步：设置 24 小时持续运行
要让 OpenClaw + WhatsApp 集成持续运行，需要将其配置为后台服务。不同操作系统的配置方式如下：
macOS — 使用 launchd
# 创建 launchd 配置文件
cat > ~/Library/LaunchAgents/com.openclaw.plist << EOF
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" ...
<plist version="1.0">
<dict>
<key>Label</key>
<string>com.openclaw</string>
<key>ProgramArguments</key>
<array><string>/usr/local/bin/openclaw</string><string>start</string></array>
<key>RunAtLoad</key><true/>
<key>KeepAlive</key><true/>
</dict></plist>
EOF
launchctl load ~/Library/LaunchAgents/com.openclaw.plist
Linux — 使用 systemd
# 创建 systemd 服务文件
sudo nano /etc/systemd/system/openclaw.service
[Unit]
Description=OpenClaw AI Assistant
After=network.target
[Service]
ExecStart=/usr/local/bin/openclaw start
Restart=always
RestartSec=5
User=openclaw
[Install]
WantedBy=multi-user.target
# 启用并启动服务
sudo systemctl enable openclaw
sudo systemctl start openclaw
Windows — 使用 PM2 进程管理器
# 安装 PM2
npm install -g pm2
npm install -g pm2-windows-startup
# 用 PM2 启动 OpenClaw
pm2 start "openclaw start" --name openclaw
pm2 save
pm2-startup install
WhatsApp 控制 AI 的实际使用场景
配置完成后，你的 AI 助理会在 WhatsApp 中随时待命。以下是一些典型的使用场景示例，这些都是真实用户的反馈：
邮件处理
"小助 帮我总结今天未读的重要邮件"
AI 会扫描 Gmail 收件箱，筛选出重要邮件并生成摘要，发送到 WhatsApp
日程管理
"小助 明天下午3点我有个会议，帮我设置提醒"
AI 自动在 Google Calendar 创建事件，并在会前30分钟通过 WhatsApp 提醒你
信息搜索
"小助 帮我搜索一下今天比特币最新价格"
AI 浏览实时数据网站，抓取最新价格信息并整理后回复
文件处理
"小助 把桌面上的季报PDF转换成要点总结"
AI 读取指定文件，提取关键信息并以结构化格式通过 WhatsApp 回复
常见问题排查
❌ 问题：二维码出现后无法扫描 / 一直刷新
原因：WhatsApp 服务器连接不稳定。解决：确认 VPN 已开启并连接稳定，二维码有效期约 20 秒，刷新后重新扫描。
⚠️ 问题：扫码成功但发消息 AI 不回复
检查步骤：1) 确认触发词设置正确；2) 检查 authorizedNumbers 白名单是否包含你的号码；3) 运行 openclaw logs 查看是否有错误信息；4) 重启 OpenClaw 服务。
💡 问题：运行一段时间后 WhatsApp 断线
原因：WhatsApp 定期要求重新验证关联设备。解决：OpenClaw 会自动尝试重连，但如果 VPN 中断会导致重连失败。建议选择带自动重连功能的 VPN 服务，如 VPN07，并开启"断线重连"选项。
✅ 问题：如何在多台设备上使用同一个 AI 助理
WhatsApp 不支持同一账号在多个 OpenClaw 实例中同时使用，但你可以通过不同的 WhatsApp 号码接入同一个 OpenClaw Gateway，实现多号码统一管理。
进阶：WhatsApp 群聊协作与自动化
OpenClaw + WhatsApp 不仅可以用于个人助理，还可以在群聊中实现团队协作。你可以在一个 WhatsApp 群中加入 AI 助理，让整个团队都能通过群聊调用 AI：
群聊协作配置
# 在配置文件中启用群聊
{
"whatsapp": {
"allowGroups": true,
"groupTrigger": "@AI", // 群聊中用 @AI 触发
"authorizedGroups": ["我的团队群"],
"groupAdminsOnly": false // 是否仅管理员可触发
}
}
配置后，群聊成员可以发送 @AI 帮我整理一下今天的会议要点，AI 会在群里回复，所有成员都能看到结果。
OpenClaw + WhatsApp 还支持设置定时任务（cron jobs），让 AI 定期主动发送信息。例如，每天早上 8:00 自动发送当天的天气和日程摘要，让你的手机在你起床时就已经准备好了今日简报：
# 在 OpenClaw 技能中创建每日简报任务
openclaw task create \
--name "daily-briefing" \
--schedule "0 8 * * *" \
--action "通过WhatsApp发送今日天气、未读邮件摘要和日历事件"