首页
开始 安装引导快速开始文档总览
文档 渠道接入模型与 APIGateway 运维Tools 与 Skills
更多 精选文章资源导航帮助中心
开始安装
文档导航 聊天渠道
聊天渠道 3 个部分 3 条关键信息

WhatsApp Web

WhatsApp

OpenClaw 当前通过 Baileys 接入 WhatsApp Web,会话由 Gateway 拥有。它是最常见的真实使用入口,但也比 Telegram 更依赖二维码登录、设备在线状态和凭证持久化。

两种使用方式

Dedicated 推荐

专用号码

体验最好、路由最清晰。推荐用单独手机号或 WhatsApp Business,把个人聊天与助手完全分开。

Fallback

个人号码自聊模式

作为临时方案可行,但必须显式开启 selfChatMode,避免误伤正常联系人和配对逻辑。

常见配置与操作

最小 allowlist 配置

{
  channels: {
    whatsapp: {
      dmPolicy: "allowlist",
      allowFrom: ["+15551234567"]
    }
  }
}

登录与重登

openclaw channels login
openclaw channels logout
openclaw channels login --verbose

高频注意事项

登录通过二维码完成,凭证默认写到 ~/.openclaw/credentials/whatsapp/<accountId>/creds.json

未知私信默认不会被处理,而是只收到配对码;批准后才会真正进入智能体。

发送消息依赖活跃的监听器与在线会话;当日志出现 loggedOut 或 409–515 状态时,通常需要重新关联。

Twilio 旧路径已经不再推荐,OpenClaw 当前的主路线是 WhatsApp Web。