OpenClaw WhatsApp 接入指南

OpenClaw WhatsApp 接入指南

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

为什么 WhatsApp 需要更谨慎

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

Step 1：启用 WhatsApp 通道

openclaw config set channels.whatsapp.enabled true

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

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 里的运行时检查

相关链接

• 更稳定的通道：/docs/channel-telegram
• 高级通道控制与网关设置：/docs/advanced-config
• 排错：/docs/troubleshooting
• OpenClaw FAQ：/faq