使用 QR 码配对在 10 分钟内将 OpenClaw 连接到 WhatsApp。本指南涵盖 OpenClaw v2026.2+、Node.js 22+ 要求、Baileys 库集成以及自托管 AI 助手的安全最佳实践。

💬

WhatsApp 集成

将 OpenClaw 连接到 WhatsApp，让您的 AI 助手即时响应消息。

端到端加密 QR 码配对群聊支持

快速开始

✓ 使用 Baileys 库进行 QR 码配对
✓ 在 openclaw.json 中配置 WhatsApp 渠道
✓ 时间：约 10 分钟

设置步骤

第一步：配置 openclaw.json

{
  "channels": {
    "whatsapp": {
      "enabled": true,
      "qrCode": {
        "color": "#FF4500"
      },
      "security": {
        "allowFrom": ["+1234567890"]  // 可选：限制发送者
      }
    }
  }
}

第二步：启动 OpenClaw

openclaw start

启动后，终端会显示 QR 码。使用 WhatsApp 扫描即可登录。

第三步：验证连接

扫描 QR 码后，您的 WhatsApp 就已连接！发送消息测试 AI 响应。

功能特点

群组支持

在群组中响应 @提及或特定关键词。

语音消息

处理和转录语音消息。

文件处理

分析和处理图片、文档等附件。

安全控制

可配置允许发送消息的联系人。

常见问题

OpenClaw 支持 WhatsApp Business 吗？

支持，OpenClaw 同时支持 WhatsApp 个人版和 WhatsApp Business 账号。两者的设置流程完全相同。

WhatsApp 配对有效期有多长？

WhatsApp 会话通常有效期为 30 天，需要重新认证。OpenClaw 会在会话即将过期时提醒您。

使用 OpenClaw 时还能用 WhatsApp Web 吗？

不能同时使用。OpenClaw 通过移动设备工作，您可以继续在手机上正常使用 WhatsApp。

WhatsApp 对话数据存储在哪里？

OpenClaw 处理的所有 WhatsApp 对话都保留在您的本地服务器上。除非您明确配置云日志，否则不会将任何消息数据发送到第三方服务器。