BlueBubbles——讓 AI 用 iMessage

這篇教學將教你如何把 Hermes Agent 串接蘋果 iMessage，讓 AI 幫你收發簡訊、處理圖片，甚至自動回覆群組聊天。

---

準備工作：你需要什麼？

• 一台常開的 Mac（最好 24 小時不關機），用來執行 BlueBubbles 伺服器
• Apple ID 已登入 Mac 上的「訊息」應用程式
• BlueBubbles Server v1.0.0 或更高版本（免費開源，從 bluebubbles.app 下載）
• Hermes 和 Mac 之間能互相存取（同一區域網路即可）

生活化比喻：BlueBubbles 就像一座「橋樑」，把 iMessage 的訊號轉成 Hermes 能聽懂的語言。Mac 是橋頭堡，必須一直開著。

---

第 1 步：安裝 BlueBubbles Server

從官網下載安裝，跟著精靈走：登入 Apple ID，選擇連線方式（本機網路、Ngrok、Cloudflare 或動態 DNS）。本機網路最簡單，適合在家用。

第 2 步：找到伺服器位址和密碼

開啟 BlueBubbles Server → 設定 → API，記下：

• 伺服器位址（類似 http://192.168.1.10:1234）
• 伺服器密碼

第 3 步：設定 Hermes

開啟終端機，執行：

hermes gateway setup

選擇 BlueBubbles (iMessage)，填入剛才的位址和密碼。

或者直接編輯 ~/.hermes/.env 檔案：

BLUEBUBBLES_SERVER_URL=http://192.168.1.10:1234
BLUEBUBBLES_PASSWORD=你的伺服器密碼

選用：群組聊天裡必須 @ 才回覆

預設情況下，Hermes 會回覆所有私聊和群組聊天訊息。如果你只想讓它回應私聊，或者必須 @ 才理你，可以這樣設定（編輯 ~/.hermes/config.yaml）：

platforms:
  bluebubbles:
    enabled: true
    extra:
      require_mention: true

這樣私聊正常回覆，群組聊天裡只有提到「Hermes」或「@Hermes agent」才回應。想自訂名字？加一行正規表示法：

      mention_patterns:
        - '(?<![\w@])@?amos\b[,:\-]?'

第 4 步：授權使用者（誰能用 AI）

有三種方式，推薦第一種：

1. 自動配對（推薦）：有人給你發 iMessage，Hermes 會自動發一個配對碼。你用指令核准：

hermes pairing approve bluebubbles <配對碼>

檢視待處理或已授權使用者：

hermes pairing list

2. 預先授權指定使用者（在 .env 裡寫）：

BLUEBUBBLES_ALLOWED_USERS=user@icloud.com,+15551234567

3. 完全開放（慎用）：

BLUEBUBBLES_ALLOW_ALL_USERS=true

第 5 步：啟動閘道

hermes gateway run

看到連線成功，就大功告成！

---

它怎麼運作？

iMessage → 訊息App → BlueBubbles伺服器 → Webhook → Hermes
Hermes → BlueBubbles API → 訊息App → iMessage

• 收訊息：BlueBubbles 即時推送，不用輪詢，秒到
• 發訊息：Hermes 透過 API 發出去
• 媒體：圖片、語音、影片、文件雙向都支援，附件自動下載快取

---

常用設定一覽

變數	必填	說明
BLUEBUBBLES_SERVER_URL	是	伺服器位址
BLUEBUBBLES_PASSWORD	是	伺服器密碼
BLUEBUBBLES_ALLOWED_USERS	否	允許的使用者清單
BLUEBUBBLES_ALLOW_ALL_USERS	否	是否允許所有人
BLUEBUBBLES_REQUIRE_MENTION	否	群組聊天是否必須 @

---

進階功能（需要安裝 Private API 外掛）

• 點按回應：給訊息按讚、愛心等
• 輸入狀態：AI 思考時顯示「正在輸入…」
• 已讀回條：自動標記已讀

不裝也能發文字和圖片，只是少了這些花俏功能。

---

常見問題

• 連不上伺服器：檢查 Mac 是否開機、位址對不對、防火牆放行
• 收不到訊息：看 BlueBubbles 設定裡 Webhook 是否註冊成功，用 hermes logs -f 看即時日誌
• Private API 沒連線：去 docs.bluebubbles.app 裝外掛，基礎功能不受影響

---

小結

BlueBubbles 讓 Hermes 用上 iMessage 只花十分鐘。核心三步：裝伺服器、填位址密碼、授權使用者。現在你的 AI 能收發簡訊、處理圖片，還能在群組聊天裡乖乖等 @ 了。

下篇預告：串接 WhatsApp 或 Telegram？敬請期待「訊息平台串接系列」下一期——讓 AI 用上你最常用的聊天軟體！

---