Skip to content

WhatsApp 接入

通过扫码登录,用你的 WhatsApp 账号与 OpenClaw 交互。

接入方式

OpenClaw 使用 Baileys 协议连接 WhatsApp(非官方 API,无需 Business 账号)。

步骤一:启动登录

bash
openclaw channels login

选择 WhatsApp,终端会显示一个二维码。

步骤二:扫码

  1. 打开手机 WhatsApp
  2. 进入 设置 → 已关联的设备 → 关联设备
  3. 扫描终端中的二维码

步骤三:使用

登录成功后,你可以:

  • 给自己发消息("我的消息")来与 Agent 对话
  • 让别人给你发消息,Agent 会自动回复(需配对)

注意事项

WARNING

  • WhatsApp 使用非官方协议,存在被封号风险(概率较低)
  • 建议使用备用号码,不要用主号
  • 不要频繁发送大量消息,避免触发风控
  • 会话数据存储在 ~/.openclaw/channels/whatsapp/ 目录

多设备支持

WhatsApp 支持最多 4 个关联设备,OpenClaw 占用一个名额。

断线重连

如果连接断开:

bash
# 检查状态
openclaw channels list

# 重新登录
openclaw channels login

如果频繁断线,可能需要重新扫码。

OpenClaw 中文教程 - 社区项目