OpenClaw WhatsApp 渠道接入指南

OpenClaw 通过 WhatsApp Web (Baileys) 连接 WhatsApp。本指南将帮助你完成 WhatsApp 渠道的配置。

安装 WhatsApp 插件

首次配置 WhatsApp 时，系统会自动提示安装插件：

• 运行 openclaw onboard 并选择 WhatsApp
• 或运行 openclaw channels add --channel whatsapp
• 或运行 openclaw channels login --channel whatsapp

手动安装：

openclaw plugins install @openclaw/whatsapp

快速配置

第一步：配置 WhatsApp 访问策略

{
  "channels": {
    "whatsapp": {
      "dmPolicy": "pairing",
      "allowFrom": ["+15551234567"],
      "groupPolicy": "allowlist",
      "groupAllowFrom": ["+15551234567"]
    }
  }
}

第二步：扫码登录

openclaw channels login --channel whatsapp

为特定账号登录：

openclaw channels login --channel whatsapp --account work

第三步：启动 Gateway

openclaw gateway

第四步：批准配对请求（如使用配对模式）

openclaw pairing list whatsapp
openclaw pairing approve whatsapp [CODE]

配对请求有效期为1小时，每个渠道最多3个待处理请求。

部署模式

专用号码（推荐）

这是最干净的操作模式：

• OpenClaw 使用独立的 WhatsApp 身份
• 更清晰的私信白名单和路由边界
• 避免与自己聊天混淆

{
  "channels": {
    "whatsapp": {
      "dmPolicy": "allowlist",
      "allowFrom": ["+15551234567"]
    }
  }
}

个人号码备用模式

如果使用个人号码：

• dmPolicy: "allowlist"
• allowFrom 包含你的个人号码
• selfChatMode: true

运行时模型

• Gateway 拥有 WhatsApp 连接和重连循环
• 发送消息需要目标账号有活跃的 WhatsApp 监听器
• 状态和广播聊天会被忽略（@status, @broadcast）
• 私信使用 DM 会话规则

相关资源

• 配对与安全
• 渠道故障排除
• Gateway 配置

更多详细信息请访问：OpenClaw 官方 WhatsApp 文档