OpenClaw + WhatsApp 连接教程

WhatsApp 是全球使用最广泛的通讯应用之一，本文将教你如何在 OpenClaw 中连接 WhatsApp。

一、前置要求

• 已安装并运行 OpenClaw
• 一个 WhatsApp 账号
• WhatsApp 已注册的手机号

二、连接 WhatsApp

方法1：使用 QR 码登录（推荐）

openclaw channels login --channel whatsapp

命令执行后会显示 QR 码，用 WhatsApp 扫描即可完成连接。

方法2：在控制面板登录

打开 Control UI，进入 Channels 页面，点击 WhatsApp 的登录按钮扫描 QR 码。

三、安全配置

1. 白名单设置

只允许特定号码发送消息：

{
  "channels": {
    "whatsapp": {
      "allowFrom": ["+1234567890"]
    }
  }
}

2. 群组配置

设置群组中需要 @提及才能回复：

{
  "channels": {
    "whatsapp": {
      "groups": {
        "*": { "requireMention": true }
      }
    }
  }
}

四、高级配置

1. 多账户支持

{
  "channels": {
    "whatsapp": {
      "accounts": {
        "work": { "sessionName": "work" },
        "personal": { "sessionName": "personal" }
      }
    }
  }
}

2. 消息过滤

{
  "channels": {
    "whatsapp": {
      "groups": {
        "*": {
          "requireMention": true,
          "denyPatterns": ["spam", "advertisement"]
        }
      }
    }
  }
}

五、断开连接

openclaw channels logout --channel whatsapp

六、常见问题

• QR 码过期？ 重新运行登录命令
• 无法接收消息？ 检查 allowFrom 配置
• 会话断开？ 重新扫描 QR 码

现在你可以开始使用 WhatsApp 与 OpenClaw 交互了！

本文由AI辅助整理发布