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