Clawdbot WhatsApp 整合

Clawdbot WhatsApp 整合概述

Clawdbot WhatsApp 整合讓您能夠將個人 AI 助理直接連接到全球最受歡迎的訊息平台 WhatsApp。Clawdbot 透過 Baileys 使用 WhatsApp Web，由 Gateway 擁有會話。這使您能夠自動化對話、接收智慧回應，並透過 AI 驅動的自動化管理您的 WhatsApp 訊息。

為什麼要將 Clawdbot 與 WhatsApp 一起使用？

WhatsApp 在全球擁有超過 20 億用戶。透過將 Clawdbot 與 WhatsApp 整合，您可以解鎖強大的 AI 功能：

快速設定（初學者）

1. 如果可能，使用單獨的電話號碼（建議）
2. 在 ~/.clawdbot/clawdbot.json 中配置 WhatsApp
3. 執行 clawdbot channels login 掃描 QR 碼（已連結的裝置）
4. 啟動 gateway

最小配置：

{
  "channels": {
    "whatsapp": {
      "dmPolicy": "allowlist",
      "allowFrom": ["+15551234567"]
    }
  }
}

取得電話號碼

WhatsApp 需要真實的手機號碼進行驗證。VoIP 和虛擬號碼通常會被封鎖。有兩種支援的方式在 WhatsApp 上運行 Clawdbot：

專用號碼（建議）

為 Clawdbot WhatsApp 使用單獨的電話號碼。這提供了最佳的使用者體驗，具有清晰的路由且沒有自我聊天的怪異行為。

理想設定：備用/舊 Android 手機 + eSIM。將其保持在 Wi-Fi 和電源上，並透過 QR 碼連結。

WhatsApp Business 提示：您可以在同一裝置上使用不同號碼的 WhatsApp Business，以保持個人 WhatsApp 分離。

範例配置（專用號碼，單用戶允許清單）：

{
  "channels": {
    "whatsapp": {
      "dmPolicy": "allowlist",
      "allowFrom": ["+15551234567"]
    }
  }
}

個人號碼（備用方案）

快速備用方案：在您自己的號碼上運行 Clawdbot。給自己發訊息（WhatsApp「給自己發訊息」）進行測試。

範例配置（個人號碼，自我聊天）：

{
  "whatsapp": {
    "selfChatMode": true,
    "dmPolicy": "allowlist",
    "allowFrom": ["+15551234567"]
  }
}

號碼來源提示

• 來自您所在國家/地區行動營運商的本地 eSIM（最可靠）
• 預付費 SIM 卡 — 便宜，只需接收一條驗證簡訊
• 避免：TextNow、Google Voice、大多數「免費簡訊」服務 — WhatsApp 會積極封鎖這些服務

提示：號碼只需接收一條驗證簡訊。之後，WhatsApp Web 會話透過 creds.json 持續存在。

設定 Clawdbot WhatsApp

先決條件

在將 Clawdbot 連接到 WhatsApp 之前，請確保您擁有：

• 在您的裝置上安裝 Clawdbot
• 具有有效電話號碼的 WhatsApp 帳號
• Node.js 22 或更高版本

步驟 1：配置 WhatsApp 頻道

將 WhatsApp 配置新增到您的 ~/.clawdbot/clawdbot.json：

{
  "channels": {
    "whatsapp": {
      "dmPolicy": "allowlist",
      "allowFrom": ["+15551234567"]
    }
  }
}

步驟 2：使用 QR 碼登入

執行 Clawdbot WhatsApp 登入命令：

clawdbot channels login

在您的手機上開啟 WhatsApp，前往設定 > 已連結的裝置 > 連結裝置，並掃描 Clawdbot 顯示的 QR 碼。

多帳號登入：

clawdbot channels login --account <id>

步驟 3：啟動 Gateway

clawdbot gateway --port 18789

步驟 4：驗證連接

確認您的 Clawdbot WhatsApp 整合正常運作：

clawdbot channels status whatsapp

Clawdbot WhatsApp 功能

智慧訊息處理

Clawdbot WhatsApp 處理傳入訊息並生成上下文相關的回應。AI 理解對話歷史並提供相關答案。模型能看到足夠的上下文來理解引用回覆。

DM 政策選項

群組訊息支援

Clawdbot WhatsApp 支援群組對話。直接聊天使用代理的主會話；群組保持隔離。

媒體支援

Clawdbot WhatsApp 可以處理並回應：

• 文字訊息
• 圖片（使用視覺 AI）
• 語音訊息（PTT 音訊轉錄）
• 文件
• 位置訊息

已讀回執

配置後，Clawdbot WhatsApp 可以發送已讀回執。

確認反應

在接收時自動反應以確認收到訊息。

Clawdbot WhatsApp 配置

完整配置範例

{
  "channels": {
    "whatsapp": {
      "dmPolicy": "allowlist",
      "allowFrom": ["+15551234567", "+10987654321"],
      "configWrites": true,
      "selfChatMode": false
    }
  }
}

配置寫入

預設情況下，WhatsApp 允許寫入由 /config set|unset 觸發的配置更新。停用方式：

{
  "channels": {
    "whatsapp": {
      "configWrites": false
    }
  }
}

Clawdbot WhatsApp 憑證儲存

Clawdbot 安全地儲存 WhatsApp 憑證：

~/.clawdbot/credentials/whatsapp/<accountId>/creds.json

• 備份副本位於 creds.json.bak（損壞時恢復）
• 舊版相容性：較舊的安裝將 Baileys 檔案直接儲存在 ~/.clawdbot/credentials/ 中

您的 WhatsApp 會話資料保留在本地機器上，確保隱私。

Clawdbot WhatsApp 疑難排解

連接中斷

如果 Clawdbot WhatsApp 斷開連接：

1. 檢查網路連接
2. 重新驗證：clawdbot channels login
3. 查看日誌：cat /tmp/clawdbot/whatsapp.log

訊息無法發送

如果 Clawdbot WhatsApp 無法發送訊息：

1. 驗證帳號狀態：clawdbot channels status whatsapp
2. 檢查允許清單配置
3. 確保 Clawdbot gateway 正在運行
4. 出站發送需要活動監聽器

QR 碼過期

如果 Clawdbot WhatsApp QR 碼過期：

clawdbot channels logout
clawdbot channels login

登出

登出會刪除 WhatsApp 驗證狀態（但保留共享的 oauth.json）：

clawdbot channels logout
# 或針對特定帳號
clawdbot channels logout --account <id>

Clawdbot WhatsApp 最佳實踐

1. 使用專用號碼：單獨的電話號碼提供最佳體驗
2. 設定明確界限：配置允許清單以控制 Clawdbot WhatsApp 存取
3. 監控使用情況：定期查看 Clawdbot WhatsApp 日誌
4. 定期更新：保持 Clawdbot 更新以獲得最新的 WhatsApp 相容性
5. 備份憑證：定期備份您的 Clawdbot WhatsApp 憑證

為什麼不使用 Twilio？

WhatsApp Business 號碼不適合個人助理：

• Meta 強制執行 24 小時回覆視窗
• 大量使用會觸發積極封鎖
• 商業帳號不適用於個人助理訊息

下一步

• Clawdbot Telegram 整合 - 將 Clawdbot 連接到 Telegram
• Clawdbot Discord 整合 - 在 Discord 上設定 Clawdbot
• Clawdbot 設定指南 - 完整安裝指南