兩種連接方式

方式一：個人 WhatsApp（QR Code）

最簡單的方法——將你現有的 WhatsApp 帳號連結到 OpenClaw，類似 WhatsApp Web 的方式。

優點： 設定簡單，可使用你現有的帳號 缺點： 佔用你的個人號碼，只能有一個連線工作階段

方式二：WhatsApp Business API

使用一個專用的商業號碼，搭配正式的 API 存取。

優點： 與個人 WhatsApp 分離，更穩定 缺點： 需要 Meta Business 驗證，設定步驟較多

對於大多數個人使用場景，方式一（QR Code）是最推薦的選擇。

設定：QR Code 方式

第一步：在 OpenClaw 中啟用 WhatsApp

openclaw config set channels.whatsapp.enabled true

第二步：開始配對

openclaw restart

OpenClaw 會在終端機中顯示一個 QR Code。如果是在無畫面的環境下運行（透過 SSH），請查看日誌：

openclaw logs | grep "QR"

第三步：掃描 QR Code

開啟手機上的 WhatsApp
前往 設定 → 已連結的裝置 → 連結裝置
掃描終端機中的 QR Code

第四步：驗證

傳送一則訊息給自己（或任何聯絡人），並提及你的 Bot。查看日誌以確認 OpenClaw 是否收到訊息：

openclaw logs --follow

設定：WhatsApp Business API

前置需求

Meta Business 帳號
WhatsApp Business API 存取權限
一個專門給 Bot 使用的電話號碼

第一步：安裝 WhatsApp 外掛

openclaw plugins install whatsapp-business

第二步：設定憑證

openclaw config set channels.whatsapp.phoneNumberId "YOUR_PHONE_NUMBER_ID"
openclaw config set channels.whatsapp.accessToken "YOUR_ACCESS_TOKEN"
openclaw config set channels.whatsapp.verifyToken "YOUR_VERIFY_TOKEN"

第三步：設定 Webhook

將你的 Meta Webhook URL 指向 OpenClaw 實例的 WhatsApp 端點。你需要一個具有 HTTPS 的公開 URL。

第四步：重啟並測試

openclaw restart

在 WhatsApp 上傳送訊息到你的商業號碼來進行驗證。

常見問題

QR Code 過期

QR Code 在 60 秒後會過期。重啟 OpenClaw 即可產生新的：

openclaw restart

「工作階段已關閉」錯誤

WhatsApp 同一時間只允許一個連結的工作階段。如果你已經在使用 WhatsApp Web，可能需要先中斷該連線。

訊息未送達

確認設定中已啟用 WhatsApp 頻道
確認伺服器的網路連線正常
查看日誌中是否有驗證錯誤

建議：使用獨立的電話號碼

OpenClaw 建議盡可能使用獨立的電話號碼來運行 WhatsApp。這可以避免與你個人 WhatsApp 使用產生衝突。

ClawTank 上的 WhatsApp

WhatsApp 整合功能即將推出到 ClawTank。目前 ClawTank 支援 Telegram 作為主要頻道。

在此期間，Telegram 為 AI 助手提供了類似的（在許多方面甚至更好的）體驗：

專為 Bot 設計的 API
不需要掃描 QR Code
豐富的格式化功能與行內按鈕
群組聊天支援
免費且無限制

先用 Telegram 開始

在 WhatsApp 支援開發中的這段期間，在 ClawTank 上透過 Telegram 部署 OpenClaw——一鍵操作，不到 1 分鐘，不需要 Docker。

WhatsApp 整合上線時，我們會通知所有用戶。