OpenClaw WhatsApp 接入教程：pairing、session 持久化与群聊策略
OpenClaw WhatsApp OpenClaw WhatsApp OpenClaw WhatsApp pairing OpenClaw session 持久化 OpenClaw selfChatMode OpenClaw 群聊策略
适合谁
想把 OpenClaw 接到自己或团队 WhatsApp 环境的用户
理解 WhatsApp 接入的登录方式、session 行为和适合自己的策略，而不是只追求“扫上了二维码”。
交付物
学完后你会留下什么
一个能稳定工作的 WhatsApp 接入方案，以及你对 dedicated number、personal number、selfChatMode 的明确判断。
开始前确认
前置条件
- 已经完成 OpenClaw 基础安装
- 准备好用于测试的 WhatsApp 账号
- 愿意先从最小配置开始，不一次性开所有策略
你会学到
OpenClaw WhatsApp
理解 WhatsApp 接入的登录方式、session 行为和适合自己的策略，而不是只追求“扫上了二维码”。
教程内搜索
支持桌面与移动端。回车可直接搜索。
为什么这篇值得先看
OpenClaw 在 WhatsApp 上很强，但真正难的不是“接上”，而是知道自己该用专用号码、个人号码，还是只做 self chat。
先抓住这 3 个关键点
- pairing 和 session 持久化决定的是“能不能稳”，不只是“能不能扫上”。
- 群聊策略、allowlist 和 selfChatMode 决定的是“会不会失控”。
- WhatsApp 是高频入口，接入方案一开始选错，后面所有自动化都会变脆弱。
实操步骤
- 先按官方文档完成最小 WhatsApp 接入，不要一开始同时开 personal 和 group 策略。
- 确认 session 能保留下来，再决定是否需要 dedicated number 或 selfChatMode。
- 如果要进群，先定义 groupPolicy 和 mention 规则，避免助手一进群就“过度活跃”。
- 最后再把它接回 Dashboard / Control UI 看日志和审批状态，确认日常使用不会放大风险。
配置或命令示例
{
channels: {
whatsapp: {
enabled: true,
selfChatMode: false,
groupPolicy: "allowlist",
allowFrom: ["+1234567890"]
}
}
}常见坑
- 把“能扫码”当成接入完成，忽略 session 持久化和策略治理。
- 既想用 dedicated number，又开 personal-number selfChatMode，最后行为边界变混乱。
- 群聊场景不设 mention 或 allowlist，助手会在错误的上下文里被频繁触发。
完成检查
- 你的 WhatsApp 接入至少能稳定保留 session，不再反复重登。
- 你已经明确自己要走 dedicated、personal 还是 selfChatMode 路线。
- 群聊是否启用、谁能触发、怎样触发，你都有清晰策略。
为什么建议把这篇收藏起来
- WhatsApp 是 OpenClaw 最常见的入口之一，值得有一篇真正讲清策略边界的教程。
- 这篇能帮你避免“先接上，后治理”的反复返工。
官方资料
继续深挖时，先看这些官方页面
本页内容已按官方文档和产品能力重写，下面这些链接适合你做版本核对和参数确认。
常见问题
你大概率还会继续搜这几个问题
把高频疑问写在教程页内，既减少跳出，也让这篇内容更适合收藏回看。
OpenClaw 的 WhatsApp 登录后会一直保持吗？
官方文档明确强调 session 持久化是核心能力，但是否稳定还取决于你的设备、配置和使用方式。
selfChatMode 适合所有人吗？
不是。官方文档建议只有在不用 dedicated WhatsApp number 时再考虑 personal-number 的自聊模式。
继续学习
下一步推荐
优先继续当前主题，再给一篇桥接内容，避免学习链路被打断。