OpenClaw WhatsApp 设置：完整集成指南 2026

简介

WhatsApp 是全球最受欢迎的消息平台之一，OpenClaw 让您可以直接从 WhatsApp 轻松使用个人人工智能助理。无论您是想管理电子邮件、查看日历还是获得快速解答，OpenClaw 都能在您的 WhatsApp 对话中无缝运行。

本指南涵盖了将 OpenClaw 连接到 WhatsApp 所需的一切，包括设置步骤、提示、限制和故障排除。

对于其他聊天应用程序集成，请参阅我们的指南：

• 电报设置
• Discord 设置
• Slack 设置
• iMessage 设置

OpenClaw WhatsApp 集成的工作原理

OpenClaw 使用 WhatsApp 网桥 连接到 WhatsApp。这意味着：

• OpenClaw 充当 WhatsApp Web 客户端
• 您扫描二维码（如 WhatsApp Web）
• 发送到 OpenClaw 的消息由您的 AI 助手处理
• 通过 WhatsApp 返回回复
• 可与您现有的 WhatsApp 帐户配合使用

重要提示： OpenClaw 使用您的个人 WhatsApp 帐户。它不会创建像 Telegram 或 Discord 这样的单独的机器人帐户。

先决条件

设置 WhatsApp 集成之前：

1. 已安装 OpenClaw — 请参阅安装指南
2. OpenClaw 配置 — 运行 openclaw onboard 以设置您的 AI 模型
3. WhatsApp 帐户 — 您手机上的活动 WhatsApp 帐户
4. WhatsApp Web 访问 — 能够使用 WhatsApp Web（不受限制）

设置步骤

第 1 步：启动 OpenClaw 集成设置

运行集成命令：

openclaw integrations

或者专门针对 WhatsApp：

openclaw integrations whatsapp

第2步：扫描二维码

您将在终端中看到一个二维码。这类似于扫描 WhatsApp Web：

1. 在手机上打开 WhatsApp
2. 点击菜单（三个点）→ 链接的设备
3. 点击“链接设备”
4. 扫描终端中显示的二维码

二维码在您的终端中将如下所示：

████████████████████████████████
████████████████████████████████
████ ▄▄▄▄▄ █▀█ █▄█▀█ █▄▄▄▄▄ ████
████ █   █ █▀▀▀█ ▄▀█ █   █ ████
████ █▄▄▄█ █▀ █▀▀▀█ █▄▄▄█ ████
...

步骤 3：验证连接

扫描后，您应该看到：

✓ WhatsApp connected successfully!
  Your AI assistant is now available on WhatsApp.

第 4 步：开始聊天

在手机上打开 WhatsApp，开始与自己对话，或创建专门的聊天。发送如下消息：

Hello, can you help me check my email?

OpenClaw 将处理您的消息并通过 WhatsApp 进行回复。

配置选项

自定义命令

您可以在 OpenClaw 中配置自定义命令：

openclaw config set whatsapp.prefix "/"

这允许您使用 /email 或 /calendar 等命令。

响应格式

配置 OpenClaw 如何格式化响应：

openclaw config set whatsapp.format "markdown"

选项：

• markdown — 丰富的格式（粗体、斜体、链接）
• plain — 仅纯文本
• html — HTML 格式（有限支持）

通知设置

控制 OpenClaw 何时响应：

openclaw config set whatsapp.autoReply true
openclaw config set whatsapp.quietHours "22:00-08:00"

使用提示

1. 专用聊天

为 OpenClaw 创建专用 WhatsApp 聊天：

• 固定聊天以便于访问
• 如果您不想持续收到警报，请将通知静音
• 如果多人使用，则使用群聊

2. 快速命令

为常见任务设置快速命令：

• /email — 检查电子邮件
• /calendar — 查看日历
• /tasks — 列出任务
• /weather — 获取天气
• /briefing — 每日简报

3.语音留言

OpenClaw 可以处理语音消息：

• 发送语音消息以进行免提交互
• OpenClaw 转录并回复
• 非常适合较长的查询或打字不方便时

4.媒体共享OpenClaw 可以处理：

• 图像 — 分析和描述图像
• 文档 — 阅读 PDF、Word 文档等。
• 链接 — 从 URL 中提取内容

发送图像并要求 OpenClaw 对其进行描述，或共享文档并要求摘要。

5. 群聊

OpenClaw 也适用于群聊：

• 提及 OpenClaw 或使用前缀
• 对于团队协调很有用
• 可以在小组环境中回应特定查询

限制

WhatsApp 网络限制

• 一个活动会话 — WhatsApp Web 允许一个活动会话。如果您已在浏览器中使用 WhatsApp Web，则可能需要先断开连接。
• 手机必须在线 — 您的手机需要连接到互联网才能使用 WhatsApp Web。
• 没有官方 API — OpenClaw 使用 WhatsApp Web，而不是官方 API，因此它受到 WhatsApp 的限制。

速率限制

如果您太快发送太多消息，WhatsApp 可能会限制速率。 OpenClaw 包含速率限制来防止这种情况，但请注意限制。

隐私考虑因素

• 个人帐户 — OpenClaw 使用您的个人 WhatsApp 帐户
• 消息历史记录 — 所有消息均由 OpenClaw 在本地处理
• 无云存储 — 消息保留在您的计算机上（除非您配置云备份）

故障排除

二维码未出现

如果没有出现二维码：

1. 检查终端支持 — 某些终端不能很好地显示二维码
2. 尝试不同的终端 — 使用 iTerm2 (macOS) 或 Windows 终端
3. 检查日志：

   openclaw logs

二维码过期

QR 码会在几分钟后过期。如果过期：

1. 生成新的二维码：

   openclaw integrations whatsapp

2. 立即扫描 — 生成后无需等待太久

连接中断

如果连接断开：

1. 检查手机连接 — 确保您的手机处于在线状态

2. 重新启动OpenClaw：

   openclaw restart

3. 如果需要，重新扫描二维码

未收到消息

如果 OpenClaw 没有收到消息：

1. 验证连接：

   openclaw status

2. 检查 WhatsApp Web — 确保它仍然在您手机的 WhatsApp 设置中链接

3. 重新启动 OpenClaw：

   openclaw restart

OpenClaw 没有响应

如果 OpenClaw 收到消息但没有响应：

1. 检查AI模型配置：

   openclaw config get ai.model

2. 验证 API 密钥 — 确保您的 AI 提供商 API 密钥有效

3. 检查日志：

   openclaw logs

4. 测试AI模型：

   openclaw test

安全最佳实践

账户安全

• 使用强密码 — 保护您的 WhatsApp 帐户
• 启用双因素身份验证 — 添加额外的安全性
• 监控活动会话 — 定期检查链接的设备

数据隐私

• 本地处理 — 所有消息都在本地处理
• 无云存储 — 除非您明确配置它
• 安全存储 — OpenClaw 数据存储在 ~/.openclaw 中

访问控制

• 限制访问 — 仅允许受信任的设备
• 监控使用情况 — 定期检查 OpenClaw 日志
• 撤销访问 — 如果需要，请断开连接：

  openclaw integrations whatsapp --disconnect

高级配置

多个 WhatsApp 帐户

OpenClaw 支持多个 WhatsApp 帐户：

openclaw integrations whatsapp --account personal
openclaw integrations whatsapp --account work

每个帐户都维护单独的上下文和内存。

自定义响应模板

创建自定义响应模板：

openclaw config set whatsapp.templates.greeting "Hello! How can I help you today?"

与其他服务集成

将 WhatsApp 与其他 OpenClaw 功能相结合：

• 电子邮件通知 — 通过 WhatsApp 获取电子邮件摘要
• 日历提醒 — 接收日历提醒
• 任务更新 — 获取任务完成通知

用例### 私人助理

使用 OpenClaw 作为您的私人助理：

• “检查我的电子邮件”
• “今天我的日历上有什么？”
• “添加明天给约翰打电话的提醒”
• “天气怎么样？”

电子邮件管理

通过 WhatsApp 管理您的收件箱：

• “显示未读电子邮件”
• “回复莎拉的电子邮件”
• “存档一周以上的所有电子邮件”

任务管理

通过 WhatsApp 处理任务：

• “将‘购买杂货’添加到我的待办事项列表中”
• “今天有哪些任务到期？”
• “将‘完成报告’标记为完成”

信息检索

快速获得答案：

• “关于人工智能的最新消息是什么？”
• “查找我附近的餐馆”
• 《解释量子计算》

与其他平台的比较

WhatsApp 与 Telegram

• WhatsApp — 使用您的个人帐户，更熟悉的界面
• Telegram — 独立的机器人帐户，更多功能（内联命令等）

请参阅我们的Telegram 指南 进行比较。

WhatsApp 与 Discord

• WhatsApp — 个人消息、一对一或小组
• Discord — 基于服务器的多用户，更适合团队

有关详细信息，请参阅我们的 Discord 指南。

后续步骤

现在 WhatsApp 已连接：

1. 探索其他集成 — Telegram、Discord、Slack
2. 设置技能 — 技能库
3. 配置电子邮件 — Gmail 集成
4. 阅读常见问题解答 — 常见问题

结论

WhatsApp 集成使 OpenClaw 可通过您日常使用的消息应用程序进行访问。设置很简单——只需扫描二维码即可开始聊天。虽然与具有官方机器人 API 的平台相比存在一些限制，但 WhatsApp 集成提供了一种熟悉且便捷的方式与 AI 助手进行交互。

如需更多帮助，请查看我们的集成页面 或常见问题解答。在 WhatsApp 上与您的 AI 助手愉快聊天！