移除 BlueBubbles 與 imsg iMessage 路徑

​

移除 BlueBubbles 與 imsg iMessage 路徑

OpenClaw 不再隨附 BlueBubbles 頻道。iMessage 支援透過內建的 imessage 外掛運作：閘道會在本機或透過 SSH 包裝器，將 imsg 啟動為子程序，並透過 stdin/stdout 使用 JSON-RPC 通訊。不需要伺服器、網路鉤子或連接埠。

如果你的設定仍包含 channels.bluebubbles，請將其遷移至 channels.imessage。舊版 /channels/bluebubbles 文件 URL 會重新導向至從 BlueBubbles 遷移，其中包含完整的設定轉換表與切換檢查清單。

​

變更內容

• 受支援的 iMessage 路徑不包含 BlueBubbles HTTP 伺服器、網路鉤子路由、REST 密碼或 BlueBubbles 外掛執行環境。
• OpenClaw 會在已登入 Messages.app 的 Mac 上，透過 imsg 讀取並監看「訊息」。
• 基本的傳送、接收、歷史記錄與媒體功能使用標準的 imsg 介面及 macOS 權限。
• 進階動作（串接回覆、點按回應、編輯、收回、特效、已讀回條、輸入指示器、群組管理）需要私有 API 橋接器：執行 imsg launch，這需要停用 SIP。
• Linux 與 Windows 閘道仍可使用 iMessage，只要將 channels.imessage.cliPath 指向會在已登入的 Mac 上執行 imsg 的 SSH 包裝器即可。

​

操作方式

1. 在執行「訊息」的 Mac 上安裝並驗證 imsg：

   brew install steipete/tap/imsg
   imsg --version
   imsg chats --limit 3
   imsg rpc --help
   

2. 將「完整磁碟存取權」與「自動化」權限授予執行 imsg 和 OpenClaw 的程序環境。

3. 轉換舊設定：

   {
     channels: {
       imessage: {
         enabled: true,
         cliPath: "/opt/homebrew/bin/imsg",
         dmPolicy: "pairing",
         allowFrom: ["[phone]"],
         groupPolicy: "allowlist",
         groupAllowFrom: ["[phone]"],
         groups: {
           "*": { requireMention: true },
         },
         includeAttachments: true,
       },
     },
   }
   

4. 重新啟動閘道並進行驗證：

   openclaw channels status --probe
   

5. 在刪除舊的 BlueBubbles 伺服器之前，先測試私訊、群組、附件，以及你所依賴的所有私有 API 動作。

​

遷移注意事項

• channels.bluebubbles.serverUrl 和 channels.bluebubbles.password 沒有對應的 iMessage 設定；因為沒有需要連線或驗證的伺服器。
• allowFrom、groupAllowFrom、groups、includeAttachments、attachmentRoots、mediaMaxMb、textChunkLimit 和 actions.* 在 channels.imessage 下仍保持相同含義。
• channels.imessage.includeAttachments 預設仍為關閉。如果你希望代理程式能收到傳入的照片、語音備忘錄、影片或檔案，請明確設定此選項。
• 使用 groupPolicy: "allowlist" 時，請複製舊的 groups 區塊，包括任何 "*" 萬用字元項目。群組傳送者允許清單與群組登錄是不同的關卡；如果 groups 區塊包含項目，但沒有相符的 chat_id（或沒有 "*"），執行階段會捨棄該訊息；而空的 groups 區塊會記錄啟動警告，即使傳送者篩選仍會允許訊息通過。
• 具有 match.channel: "bluebubbles" 的 ACP 繫結必須變更為 "imessage"。
• 舊的 BlueBubbles 工作階段金鑰不會轉換成 iMessage 工作階段金鑰。配對核准是以傳送者識別代號為準，因此複製的 allowFrom 項目仍可運作，但 BlueBubbles 工作階段金鑰下的對話歷史記錄不會移轉。

​

另請參閱

• 從 BlueBubbles 遷移
• iMessage
• 設定參考資料 - iMessage