Skip to content

WhatsApp 接入

WhatsApp 频道通过 Baileys 库实现,无需 WhatsApp Business API,但需要手机扫码授权。

配置

json
{
  "channels": {
    "whatsapp": {
      "enabled": true,
      "sessionPath": "~/.openclaw/whatsapp-session"
    }
  }
}

首次配对

启动后,终端会显示二维码:

bash
openclaw start
# 或查看日志中的二维码
openclaw logs --filter whatsapp

用手机 WhatsApp 扫描二维码:

  • Android:右上角菜单 → 已连接的设备 → 连接设备
  • iPhone:设置 → 已连接的设备 → 连接设备

注意

二维码有效期约 60 秒,过期需重新运行 openclaw channels reconnect whatsapp

会话持久化

扫码成功后,会话凭证保存在 sessionPath 目录,重启后自动恢复连接,无需重新扫码。

使用限制

  • WhatsApp 频道属于非官方实现,存在被封号风险
  • 建议使用小号或专用号码,不要用主要业务号码
  • 频繁发送消息可能触发 WhatsApp 风控

常见问题

会话断开

bash
# 重新连接
openclaw channels reconnect whatsapp

# 如果反复断开,清除会话重新授权
rm -rf ~/.openclaw/whatsapp-session
openclaw channels reconnect whatsapp

基于 OpenClaw 官方文档整理,仅供学习研究