OpenClaw学习总结_II_频道系统_1：WhatsApp集成详解

II. 频道系统 - 1. WhatsApp 课程位置阶段II. 频道系统课序第 1 课前置知识I. 核心架构Gateway/Session/Tools后续课程II-2. Telegram 本课核心问题你不懂我就这样教你你会遇到的最现实问题是我怎么把 OpenClaw 接到 WhatsApp 上让它能收消息、能回消息怎么控制谁能跟机器人私聊安全为什么会有扫码、掉线、收不到消息、群聊提及等问题这一课我会按“老师教小白”的方式带你把 WhatsApp 频道接起来并把常见坑点讲清楚。 先建立心智模型WhatsApp 渠道在 OpenClaw 里是什么一句话WhatsApp 渠道 OpenClaw Gateway 里的一段“适配器”把 WhatsApp 的消息转换成 OpenClaw 统一的消息事件再把回复发回 WhatsApp。类比WhatsApp 像“外部手机通讯软件”OpenClaw Gateway 像“总机”WhatsApp 插件像“WhatsApp 专线接线员”✅ 你要达到的结果验收标准完成后你应该能做到能让 OpenClaw在 WhatsApp 上收到你的消息能让 OpenClaw在 WhatsApp 上回复你能限制只有你或白名单能私聊能设置群聊是否需要 才响应出问题时知道从哪里排查 第一步在配置里开启 WhatsApp在~/.openclaw/openclaw.json里增加/修改{ channels: { whatsapp: { enabled: true, // 访问策略重要 dmPolicy: pairing, // pairing | allowlist | open | disabled allowFrom: [86xxxxxxxxxxx], groupPolicy: open, // open | allowlist | disabled不同版本可能略有差异 groupAllowFrom: [*] } } }dmPolicy 怎么选安全最关键pairing默认推荐。陌生人需要配对码才可聊天。allowlist只有 allowFrom 里的号码能聊天。open所有人都能 DM 你风险大不建议。disabled完全禁用 DM。建议除非你非常确定否则用pairing或allowlist。 第二步登录 WhatsApp扫码WhatsApp 通道通常需要通过 Web 方式登录会出现二维码。你要做的事启动 OpenClaw Gateway确保 WhatsApp channel enabled观察日志/控制台提示二维码用手机 WhatsApp 扫码登录类比就像你在电脑登录微信需要手机扫码确认 第三步验证消息链路你发一条 WhatsApp 消息给机器人链路应该是WhatsApp 你的消息 ↓ WhatsApp channel adapter接线员 ↓ Gateway统一路由 ↓ Session找到对话上下文 ↓ Agent Loop理解/工具/生成 ↓ Gateway ↓ WhatsApp channel adapter ↓ WhatsApp 回复如果任意环节断了就会表现为“没反应”。 群聊里怎么让它不乱插话 才回建议群聊默认 require mention。{ agents: { list: [ { id: main, groupChat: { mentionPatterns: [openclaw, openclaw], }, }, ], }, channels: { whatsapp: { groups: { *: { requireMention: true } } } } }这样做的目的防止机器人在群里“误触发”降低 prompt injection 风险控制成本⚠️ WhatsApp 最常见的坑以及怎么排现象常见原因排查/解决扫码后又掉线会话过期/设备登录冲突重新扫码检查是否在其他设备踢下线收不到消息channel 未启用/网关没跑检查channels.whatsapp.enabled看 gateway.log能收不能回发送权限/会话异常看错误日志检查 dmPolicy/allowFrom群聊乱回没开 requireMention配置 group mention gating一直提示配对dmPolicypairing 且未完成配对完成配对或用 allowlist 最小可用配置MVP如果你只想最快跑通{ channels: { whatsapp: { enabled: true, dmPolicy: allowlist, allowFrom: [86xxxxxxxxxxx], } } } 学习心得WhatsApp 这章的“难点”不在配置字段多而在“登录态”扫码登录不是一次性的掉线、过期、设备冲突都会导致消息中断所以我的经验是先用最小配置跑通再逐步加安全策略pairing/群聊任何问题先看日志再看配置✅ 本课总结记住 5 句话WhatsApp 通道就是 Gateway 的适配器负责收发 WhatsApp。最重要的安全开关是 dmPolicy推荐 pairing/allowlist。扫码登录是最大不稳定因素掉线先重登。群聊要开 requireMention避免乱回和注入风险。排障先看 gateway 日志再回头对照配置。 相关资源官方文档https://docs.openclaw.ai/channels/whatsapp配置参考https://docs.openclaw.ai/gateway/configuration-reference下一课II-2. Telegram