WhatsApp 接入：扫个码就能让你的 Hermes 上线聊天

WhatsApp 接入：掃個碼就能讓你的 Hermes 上線聊天

嘿，朋友們！今天咱們來聊聊怎麼把 Hermes 接到 WhatsApp 上。別緊張，整個過程比你想象的簡單多了——不用註冊 Meta 開發者帳號，不用申請企業認證，甚至不需要一台公網伺服器。你只需要一部裝了 WhatsApp 的手機，掃個碼，完事兒。

這玩意兒是怎麼工作的？

Hermes 用的是基於 Baileys 的橋接方案，原理是模擬一個 WhatsApp Web 會話。簡單說，就是讓你的 Hermes 像 WhatsApp 網頁版一樣登入，然後就能收發訊息了。

注意：這不是官方的 WhatsApp Business API，所以有小概率被限制帳號的風險。建議用專用號碼跑機器人，別拿自己日常用的號去折騰。

兩種玩法，任你選

模式	怎麼玩	適合誰
獨立機器人號碼（推薦）	專門搞一個號碼給機器人，別人直接給這個號發訊息	多人使用、體驗乾淨、風險低
個人自聊模式	用你自己的 WhatsApp，給自己發訊息就是跟機器人說話	快速測試、單人使用

準備工作

Node.js v18+ 和 npm（橋接器是 Node.js 進程）
一部裝了 WhatsApp 的手機（用來掃碼）

好消息是：現在的橋接器不需要 Chromium 或 Puppeteer 那套重型依賴了，輕量得很。

第一步：跑設定精靈

hermes whatsapp

精靈會一步步帶你走：

選擇模式（bot 或 self-chat）
自動安裝依賴
在終端顯示二維碼
等你掃碼

掃碼步驟：

手機打開 WhatsApp
進入 設定 → 已連結裝置
點 連結裝置
對著終端二維碼掃一下

配對成功後，會話會自動儲存，下次不用重新掃碼。

小提示：如果二維碼顯示亂碼，檢查終端寬度是否至少 60 列，並確認支援 Unicode。換個終端模擬器也行。

第二步：搞一個第二號碼（機器人模式）

機器人模式需要一個沒註冊過 WhatsApp 的號碼。三個選擇：

方案	費用	說明
Google Voice	免費	僅限美國，去 voice.google.com 申請
預付費 SIM 卡	5-15 美元一次性	啟動驗證後可以放抽屜裡，但號碼要保持活躍（每 90 天打個電話）
VoIP 服務	免費到 5 美元/月	TextNow、TextFree 等，有些號碼可能被 WhatsApp 封鎖，多試幾個

拿到號碼後，在手機上註冊 WhatsApp，然後跑 hermes whatsapp 掃碼配對。

第三步：設定 Hermes

編輯 ~/.hermes/.env 檔案：

# 必填
WHATSAPP_ENABLED=true
WHATSAPP_MODE=bot                          # "bot" 或 "self-chat"

# 存取控制——三選一：
WHATSAPP_ALLOWED_USERS=15551234567         # 逗號分隔的號碼（帶國碼，不要加 +）
# WHATSAPP_ALLOWED_USERS=*                 # 或者用 * 允許所有人
# WHATSAPP_ALLOW_ALL_USERS=true            # 或者設這個旗標（效果同 *）

可選的行為設定，在 ~/.hermes/config.yaml 裡：

unauthorized_dm_behavior: pair

whatsapp:
  unauthorized_dm_behavior: ignore

pair 是全域預設，陌生人私訊會收到配對碼
ignore 讓 WhatsApp 對未授權私訊保持沉默，私人號碼推薦這個

然後啟動閘道：

hermes gateway              # 前景執行
hermes gateway install      # 安裝為使用者服務
sudo hermes gateway install --system   # Linux：開機自啟系統服務

會話持久化

會話資料儲存在 ~/.hermes/platforms/whatsapp/session，所以重啟不用重新掃碼。但要注意：這個目錄包含加密金鑰和裝置憑證，千萬別分享或提交到程式碼倉庫，誰拿到誰就能完全控制你的 WhatsApp 帳號。

重新配對

如果會話失效（手機重置、WhatsApp 更新、手動解綁），閘道日誌會報連線錯誤。解決辦法很簡單：

hermes whatsapp

重新掃碼配對就行。