WhatsApp Bot 部署

概述

OpenClaw 通过 WhatsApp Web 使用 Baileys 库与 WhatsApp 集成。这是 OpenClaw 部署中最受欢迎的渠道。

快速设置

1. 配置 WhatsApp 渠道

{
  "channels": {
    "whatsapp": {
      "enabled": true,
      "allowFrom": ["+15555550123"],
      "groups": {
        "*": {
          "requireMention": true
        }
      }
    }
  }
}

2. 通过二维码配对

openclaw channels login

将显示一个二维码。用手机 WhatsApp 扫描：

1. 打开手机上的 WhatsApp
2. 进入 设置 → 关联设备
3. 点击 关联设备
4. 扫描二维码

3. 启动 Gateway

openclaw gateway

访问控制

私聊

{
  "channels": {
    "whatsapp": {
      "allowFrom": ["+15555550123", "+15555550456"]
    }
  }
}

群组@提及

{
  "messages": {
    "groupChat": {
      "mentionPatterns": ["@openclaw"]
    }
  }
}

功能支持

• ✅ 私聊
• ✅ 带@提及激活的群聊
• ✅ 图片和媒体收发
• ✅ 文档分享
• ✅ 语音笔记转写
• ✅ 二维码配对（无需 API 密钥）

会话持久化

WhatsApp 会话数据存储在 ~/.openclaw/state/。备份此目录可在重启后保持 WhatsApp 连接。

故障排除

二维码过期

重新运行 openclaw channels login 生成新的二维码。

频繁断开连接

• 确保手机有稳定的网络连接
• 保持 WhatsApp 在后台运行
• 检查 openclaw gateway status 查看错误

消息发送失败

• 验证手机号格式（需包含国家代码）
• 检查 allowFrom 配置

下一步

• Telegram 部署 — Telegram 设置
• AI Agent — 配置 Agent 行为
• 安全实践 — 访问控制最佳实践