跳转到内容
最近更新

OpenClaw WhatsApp 接入指南

WhatsApp 的聊天体验通常很好,但它比 Telegram 更依赖二维码会话和风控策略。如果你想让 OpenClaw 进入更像私人聊天的通道,这份 OpenClaw WhatsApp 接入指南更适合你,但建议全程使用小号。

为什么 WhatsApp 需要更谨慎

  • 登录依赖二维码,会话更容易过期
  • 频繁重连更容易触发风险控制
  • 用小号接入通常比直接用主号更稳妥

Step 1:启用 WhatsApp 通道

Command
openclaw config set channels.whatsapp.enabled true

Step 2:重启 gateway 并获取二维码

Command
openclaw gateway restart# 看不到就前台跑:openclaw gateway

Step 3:手机扫码(Linked Devices)

WhatsApp -> Settings -> Linked Devices -> Link a device -> 扫码

Step 4:测试真实消息链路

  • 给自己或测试聊天发一条消息
  • 确认 OpenClaw 能回复
  • 再重启一次,确认会话仍然能保持

常见 WhatsApp 问题

  • QR 过期 -> restart 再扫
  • 断连 -> 用 systemd、pm2 或 Docker restart 保活
  • 风控风险 -> 用小号、别频繁重连、别群发
  • 重连后不回复 -> 对照 /docs/troubleshooting 里的运行时检查

相关链接