OpenClaw 接入 WhatsApp：二维码关联与访问策略配置
官方渠道页标注 WhatsApp 是「最受欢迎」的渠道之一，底层基于 Baileys 库实现 WhatsApp Web 协议。它和 Telegram 的本质区别：Telegram 接入的是机器人账号，WhatsApp 接入的是你的个人账号的关联设备——体验更像，责任也更大。
第一步：安装插件
WhatsApp 运行时独立于核心包发布，新手引导或渠道添加命令首次选中它时会提示安装，也可以手动装：
openclaw plugins install clawhub:@openclaw/whatsapp装完重启网关。
第二步：扫码关联
openclaw channels login --channel whatsapp登录只支持二维码。手机上打开 WhatsApp 的已关联设备页面扫码即可。远程或无头服务器上要提前想好「怎么看到这个二维码」——SSH 终端、日志文件或临时开个本地页面都行，这一步卡住的人最多。
第三步：收紧访问策略
因为是个人账号关联，白名单比 Telegram 更重要：
{
"channels": {
"whatsapp": {
"dmPolicy": "pairing",
"allowFrom": ["+8613800000000"],
"groupPolicy": "allowlist",
"groupAllowFrom": ["+8613800000000"]
}
}
}号码用带国家码的 E.164 格式。群组侧同样用发送者白名单控制谁能触发智能体。
关联设备会话的特殊性
- 网关拥有的是一个 WhatsApp Web 会话，掉线（手机端踢下线、长时间不活跃）后需要重新扫码；磁盘上保存的会话状态比 Telegram 多。
- 不要把智能体拉进不熟的群——群成员都能触发它，工具权限又是你的，风险模型完全不同（见 信任模型）。
- 私信配对与允许列表机制与 Telegram 一致，可回看 私信配对。
什么时候选 WhatsApp 而不是 Telegram
看你的社交关系网在哪。WhatsApp 的价值在于联系人本来就在那里，助手可以参与和朋友的群聊、回复语音留言；纯粹自己用的场景，Telegram 的机器人体系更轻、更稳。