使用 QR 碼配對在 10 分鐘內將 OpenClaw 連接到 WhatsApp。本指南涵蓋 OpenClaw v2026.2+、Node.js 22+ 要求、Baileys 庫集成以及自託管 AI 助手的安全最佳實踐。

💬

WhatsApp 集成

將 OpenClaw 連接到 WhatsApp，讓您的 AI 助手即時響應消息。

端到端加密 QR 碼配對群聊支持

快速開始

✓ 使用 Baileys 庫進行 QR 碼配對
✓ 在 openclaw.json 中配置 WhatsApp 渠道
✓ 時間：約 10 分鐘

設置步驟

第一步：配置 openclaw.json

{
  "channels": {
    "whatsapp": {
      "enabled": true,
      "qrCode": {
        "color": "#FF4500"
      },
      "security": {
        "allowFrom": ["+1234567890"]  // 可選：限制發送者
      }
    }
  }
}

第二步：啟動 OpenClaw

openclaw start

啟動後，終端會顯示 QR 碼。使用 WhatsApp 掃描即可登錄。

第三步：驗證連接

掃描 QR 碼後，您的 WhatsApp 就已連接！發送消息測試 AI 響應。

功能特點

群組支持

在群組中響應 @提及或特定關鍵詞。

語音消息

處理和轉錄語音消息。

文件處理

分析和處理圖片、文檔等附件。

安全控制

可配置允許發送消息的聯繫人。

常見問題

OpenClaw 支持 WhatsApp Business 嗎？

支持，OpenClaw 同時支持 WhatsApp 個人版和 WhatsApp Business 賬號。兩者的設置流程完全相同。

WhatsApp 配對有效期有多長？

WhatsApp 會話通常有效期為 30 天，需要重新認證。OpenClaw 會在會話即將過期時提醒您。

使用 OpenClaw 時還能用 WhatsApp Web 嗎？

不能同時使用。OpenClaw 通過移動設備工作，您可以繼續在手機上正常使用 WhatsApp。

WhatsApp 對話數據存儲在哪裡？

OpenClaw 處理的所有 WhatsApp 對話都保留在您的本地服務器上。除非您明確配置雲日誌，否則不會將任何消息數據發送到第三方服務器。