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