OpenClaw WhatsApp 接入教程：pairing、session 持久化与群聊策略

OpenClaw 集成 生态 生态 预计 20 分钟 发布于 2026/2/14 核验于 2026/3/6

为什么这篇值得先看

OpenClaw 在 WhatsApp 上很强，但真正难的不是“接上”，而是知道自己该用专用号码、个人号码，还是只做 self chat。

先抓住这 3 个关键点

• pairing 和 session 持久化决定的是“能不能稳”，不只是“能不能扫上”。
• 群聊策略、allowlist 和 selfChatMode 决定的是“会不会失控”。
• WhatsApp 是高频入口，接入方案一开始选错，后面所有自动化都会变脆弱。

实操步骤

1. 先按官方文档完成最小 WhatsApp 接入，不要一开始同时开 personal 和 group 策略。
2. 确认 session 能保留下来，再决定是否需要 dedicated number 或 selfChatMode。
3. 如果要进群，先定义 groupPolicy 和 mention 规则，避免助手一进群就“过度活跃”。
4. 最后再把它接回 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 最常见的入口之一，值得有一篇真正讲清策略边界的教程。
• 这篇能帮你避免“先接上，后治理”的反复返工。