跳轉到主要內容

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

狀態：透過 HTTP 與 BlueBubbles macOS 伺服器通訊的內建 Plugin。由於相較於舊版 imsg 頻道，它具備更完整的 API 且設定更簡單，因此建議用於 iMessage 整合。
目前的 OpenClaw 版本已內建 BlueBubbles，因此一般封裝建置不需要另外執行 openclaw plugins install 步驟。

​
概觀

  • 透過 BlueBubbles 輔助 App（bluebubbles.app）在 macOS 上執行。
  • 建議／已測試：macOS Sequoia (15)。macOS Tahoe (26) 可運作；目前 Tahoe 上的編輯功能無法使用，而群組圖示更新可能回報成功但未同步。
  • OpenClaw 透過其 REST API（GET /api/v1/ping、POST /message/text、POST /chat/:id/*）與它通訊。
  • 傳入訊息透過 Webhook 抵達；傳出回覆、輸入中指示、已讀回條與 tapback 都是 REST 呼叫。
  • 附件與貼圖會作為傳入媒體擷取（可行時也會提供給代理）。
  • 合成 MP3 或 CAF 音訊的自動 TTS 回覆會以 iMessage 語音備忘錄氣泡傳送，而不是一般檔案附件。
  • 配對／允許清單的運作方式與其他頻道相同（/channels/pairing 等），搭配 channels.bluebubbles.allowFrom 與配對碼使用。
  • 回應會像 Slack/Telegram 一樣以系統事件呈現，讓代理可在回覆前「提及」它們。
  • 進階功能：編輯、取消傳送、回覆串接、訊息效果、群組管理。

​
快速開始

1

安裝 BlueBubbles

在你的 Mac 上安裝 BlueBubbles 伺服器（依照 bluebubbles.app/install 的指示）。
2

啟用 Web API

在 BlueBubbles 設定中啟用 Web API 並設定密碼。
3

設定 OpenClaw

執行 openclaw onboard 並選取 BlueBubbles，或手動設定：
{
  channels: {
    bluebubbles: {
      enabled: true,
      serverUrl: "http://192.168.1.100:1234",
      password: "example-password",
      webhookPath: "/bluebubbles-webhook",
    },
  },
}
4

將 Webhook 指向 Gateway

將 BlueBubbles Webhook 指向你的 Gateway（範例：https://your-gateway-host:3000/bluebubbles-webhook?password=<password>）。
5

啟動 Gateway

啟動 Gateway；它會註冊 Webhook 處理常式並開始配對。
安全性
  • 一律設定 Webhook 密碼。
  • Webhook 驗證一律為必要。除非 BlueBubbles Webhook 要求包含符合 channels.bluebubbles.password 的密碼／guid（例如 ?password=<password> 或 x-password），否則 OpenClaw 會拒絕該要求，不論 loopback／代理拓撲為何。
  • 密碼驗證會在讀取／解析完整 Webhook 本文之前檢查。

​
讓 Messages.app 保持運作（VM／無頭設定）

某些 macOS VM／常開設定可能會使 Messages.app 進入「閒置」狀態（傳入事件停止，直到 App 被開啟／切到前景）。簡單的替代方案是使用 AppleScript + LaunchAgent 每 5 分鐘戳一下 Messages。
1

儲存 AppleScript

將此儲存為 ~/Scripts/poke-messages.scpt：
try
  tell application "Messages"
    if not running then
      launch
    end if

    -- Touch the scripting interface to keep the process responsive.
    set _chatCount to (count of chats)
  end tell
on error
  -- Ignore transient failures (first-run prompts, locked session, etc).
end try
2

安裝 LaunchAgent

將此儲存為 ~/Library/LaunchAgents/com.user.poke-messages.plist：
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
  <dict>
    <key>Label</key>
    <string>com.user.poke-messages</string>

    <key>ProgramArguments</key>
    <array>
      <string>/bin/bash</string>
      <string>-lc</string>
      <string>/usr/bin/osascript &quot;$HOME/Scripts/poke-messages.scpt&quot;</string>
    </array>

    <key>RunAtLoad</key>
    <true/>

    <key>StartInterval</key>
    <integer>300</integer>

    <key>StandardOutPath</key>
    <string>/tmp/poke-messages.log</string>
    <key>StandardErrorPath</key>
    <string>/tmp/poke-messages.err</string>
  </dict>
</plist>
這會每 300 秒並在登入時執行。第一次執行可能會觸發 macOS Automation 提示（osascript → Messages）。請在執行 LaunchAgent 的同一個使用者工作階段中核准。
3

載入它

launchctl unload ~/Library/LaunchAgents/com.user.poke-messages.plist 2>/dev/null || true
launchctl load ~/Library/LaunchAgents/com.user.poke-messages.plist

​
上線設定

BlueBubbles 可在互動式上線設定中使用： 
openclaw onboard
精靈會提示輸入：
​
伺服器 URL
string
必填
BlueBubbles 伺服器位址（例如 http://192.168.1.100:1234）。
​
密碼
string
必填
來自 BlueBubbles Server 設定的 API 密碼。
​
Webhook 路徑
string
預設值:"/bluebubbles-webhook"
Webhook 端點路徑。
​
DM 政策
string
pairing、allowlist、open 或 disabled。
​
允許清單
string[]
電話號碼、電子郵件或聊天目標。
你也可以透過 CLI 新增 BlueBubbles： 
openclaw channels add bluebubbles --http-url http://192.168.1.100:1234 --password <password>

​
存取控制（DM + 群組）

  • 預設：channels.bluebubbles.dmPolicy = "pairing"。
  • 未知寄件者會收到配對碼；在核准前訊息會被忽略（代碼會在 1 小時後過期）。
  • 透過以下方式核准：
    • openclaw pairing list bluebubbles
    • openclaw pairing approve bluebubbles <CODE>
  • 配對是預設的權杖交換。詳細資訊：配對

​
聯絡人名稱補充（macOS，選用）

BlueBubbles 群組 Webhook 通常只包含原始參與者位址。如果你希望 GroupMembers 內容改為顯示本機聯絡人名稱，可以在 macOS 上選擇啟用本機 Contacts 補充：
  • channels.bluebubbles.enrichGroupParticipantsFromContacts = true 啟用查詢。預設：false。
  • 查詢只會在群組存取、命令授權與提及閘控允許訊息通過後執行。
  • 只會補充未命名的電話參與者。
  • 找不到本機符合項目時，原始電話號碼會保留作為後備。
{
  channels: {
    bluebubbles: {
      enrichGroupParticipantsFromContacts: true,
    },
  },
}

​
提及閘控（群組）

BlueBubbles 支援群組聊天的提及閘控，與 iMessage/WhatsApp 行為一致：
  • 使用 agents.list[].groupChat.mentionPatterns（或 messages.groupChat.mentionPatterns）偵測提及。
  • 對群組啟用 requireMention 時，代理只會在被提及時回應。
  • 來自已授權寄件者的控制命令會略過提及閘控。
每群組設定： 
{
  channels: {
    bluebubbles: {
      groupPolicy: "allowlist",
      groupAllowFrom: ["+15555550123"],
      groups: {
        "*": { requireMention: true }, // default for all groups
        "iMessage;-;chat123": { requireMention: false }, // override for specific group
      },
    },
  },
}

​
命令閘控

  • 控制命令（例如 /config、/model）需要授權。
  • 使用 allowFrom 與 groupAllowFrom 判定命令授權。
  • 已授權寄件者即使未在群組中提及，也可以執行控制命令。

​
每群組系統提示

channels.bluebubbles.groups.* 下的每個項目都接受選用的 systemPrompt 字串。該值會在處理該群組訊息的每一輪中注入代理的系統提示，因此你可以設定每群組的人格或行為規則，而不必編輯代理提示： 
{
  channels: {
    bluebubbles: {
      groups: {
        "iMessage;-;chat123": {
          systemPrompt: "Keep responses under 3 sentences. Mirror the group's casual tone.",
        },
      },
    },
  },
}
鍵會符合 BlueBubbles 為該群組回報的 chatGuid / chatIdentifier / 數字 chatId，而 "*" 萬用字元項目會為沒有精確符合項目的每個群組提供預設值（與 requireMention 和每群組工具政策使用相同模式）。精確符合一律優先於萬用字元。DM 會忽略此欄位；請改用代理層級或帳號層級的提示自訂。

​
實作範例：串接回覆與 tapback 回應（Private API）

啟用 BlueBubbles Private API 後，傳入訊息會附帶短訊息 ID（例如 [[reply_to:5]]），且代理可以呼叫 action=reply 以串接到特定訊息，或呼叫 action=react 放置 tapback。每群組 systemPrompt 是讓代理選擇正確工具的可靠方式： 
{
  channels: {
    bluebubbles: {
      groups: {
        "iMessage;+;chat-family": {
          systemPrompt: [
            "When replying in this group, always call action=reply with the",
            "[[reply_to:N]] messageId from context so your response threads",
            "under the triggering message. Never send a new unlinked message.",
            "",
            "For short acknowledgements ('ok', 'got it', 'on it'), use",
            "action=react with an appropriate tapback emoji (❤️, 👍, 😂, ‼️, ❓)",
            "instead of sending a text reply.",
          ].join(" "),
        },
      },
    },
  },
}
Tapback 回應和串接回覆都需要 BlueBubbles Private API；請參閱進階動作與訊息 ID以了解底層機制。

​
ACP 對話繫結

BlueBubbles 聊天可以在不變更傳輸層的情況下轉換為持久 ACP 工作區。 快速操作流程：
  • 在 DM 或允許的群組聊天中執行 /acp spawn codex --bind here。
  • 同一個 BlueBubbles 對話中的後續訊息會路由到產生的 ACP 工作階段。
  • /new 和 /reset 會就地重設同一個已繫結的 ACP 工作階段。
  • /acp close 會關閉 ACP 工作階段並移除繫結。
也支援透過頂層 bindings[] 項目設定持久繫結，其中包含 type: "acp" 與 match.channel: "bluebubbles"。 match.peer.id 可以使用任何支援的 BlueBubbles 目標形式：
  • 正規化 DM 控點，例如 +15555550123 或 user@example.com
  • chat_id:<id>
  • chat_guid:<guid>
  • chat_identifier:<identifier>
對於穩定的群組繫結，建議使用 chat_id:* 或 chat_identifier:*。 範例： 
{
  agents: {
    list: [
      {
        id: "codex",
        runtime: {
          type: "acp",
          acp: { agent: "codex", backend: "acpx", mode: "persistent" },
        },
      },
    ],
  },
  bindings: [
    {
      type: "acp",
      agentId: "codex",
      match: {
        channel: "bluebubbles",
        accountId: "default",
        peer: { kind: "dm", id: "+15555550123" },
      },
      acp: { label: "codex-imessage" },
    },
  ],
}
請參閱 ACP Agents 以了解共用的 ACP 繫結行為。

​
輸入中 + 已讀回條

  • 輸入中指示器：會在回覆生成前與生成期間自動傳送。
  • 已讀回條：由 channels.bluebubbles.sendReadReceipts 控制（預設值：true）。
  • 輸入中指示器：OpenClaw 會傳送開始輸入事件；BlueBubbles 會在傳送或逾時時自動清除輸入狀態（透過 DELETE 手動停止並不可靠）。
{
  channels: {
    bluebubbles: {
      sendReadReceipts: false, // disable read receipts
    },
  },
}

​
進階動作

BlueBubbles 在設定中啟用後支援進階訊息動作： 
{
  channels: {
    bluebubbles: {
      actions: {
        reactions: true, // tapbacks (default: true)
        edit: true, // edit sent messages (macOS 13+, broken on macOS 26 Tahoe)
        unsend: true, // unsend messages (macOS 13+)
        reply: true, // reply threading by message GUID
        sendWithEffect: true, // message effects (slam, loud, etc.)
        renameGroup: true, // rename group chats
        setGroupIcon: true, // set group chat icon/photo (flaky on macOS 26 Tahoe)
        addParticipant: true, // add participants to groups
        removeParticipant: true, // remove participants from groups
        leaveGroup: true, // leave group chats
        sendAttachment: true, // send attachments/media
      },
    },
  },
}
  • react：新增/移除 tapback 反應（messageId、emoji、remove）。iMessage 的原生 tapback 集合是 love、like、dislike、laugh、emphasize 和 question。當代理選擇該集合之外的 emoji（例如 👀）時，反應工具會退回使用 love，讓 tapback 仍能顯示，而不是讓整個請求失敗。已設定的確認反應仍會嚴格驗證，並在未知值上報錯。
  • edit：編輯已傳送的訊息（messageId、text）。
  • unsend：收回訊息（messageId）。
  • reply：回覆特定訊息（messageId、text、to）。
  • sendWithEffect：使用 iMessage 效果傳送（text、to、effectId）。
  • renameGroup：重新命名群組聊天（chatGuid、displayName）。
  • setGroupIcon：設定群組聊天的圖示/照片（chatGuid、media）— 在 macOS 26 Tahoe 上不穩定（API 可能回傳成功，但圖示不會同步）。
  • addParticipant：將某人加入群組（chatGuid、address）。
  • removeParticipant：將某人從群組移除（chatGuid、address）。
  • leaveGroup：離開群組聊天（chatGuid）。
  • upload-file：傳送媒體/檔案（to、buffer、filename、asVoice）。
    • 語音備忘錄：設定 asVoice: true，並使用 MP3 或 CAF 音訊，以 iMessage 語音訊息傳送。BlueBubbles 會在傳送語音備忘錄時將 MP3 → CAF。
  • 舊版別名：sendAttachment 仍可使用，但 upload-file 是標準動作名稱。

​
訊息 ID（短 ID 與完整 ID）

OpenClaw 可能會顯示_短_訊息 ID（例如 1、2）以節省 Token。
  • MessageSid / ReplyToId 可以是短 ID。
  • MessageSidFull / ReplyToIdFull 包含提供者的完整 ID。
  • 短 ID 儲存在記憶體中；它們可能會在重新啟動或快取淘汰後過期。
  • 動作接受短或完整 messageId，但如果短 ID 已無法取得，將會報錯。
對於持久的自動化與儲存，請使用完整 ID：
  • 範本：{{MessageSidFull}}、{{ReplyToIdFull}}
  • 情境：傳入酬載中的 MessageSidFull / ReplyToIdFull
範本變數請參閱設定。

​
合併分段傳送的 DM（指令 + URL 在同一次組合中）

當使用者在 iMessage 中同時輸入指令和 URL，例如 Dump https://example.com/article，Apple 會將傳送拆成兩個獨立的 Webhook 投遞：
  1. 一則文字訊息（"Dump"）。
  2. 一個 URL 預覽氣泡（"https://..."），並以附件形式包含 OG 預覽圖片。
在多數設定中，兩個 Webhook 約相隔 0.8-2.0 秒抵達 OpenClaw。若沒有合併，代理會在第 1 回合只收到指令並回覆（通常是「把 URL 傳給我」），然後只在第 2 回合看到 URL，此時指令情境已經遺失。 channels.bluebubbles.coalesceSameSenderDms 會選擇讓 DM 將連續的同一寄件者 Webhook 合併成單一代理回合。群組聊天會繼續按每則訊息作為鍵，以保留多使用者回合結構。
在以下情況啟用：
  • 你提供預期一則訊息中有 command + payload 的 Skills（dump、paste、save、queue 等）。
  • 你的使用者會在指令旁貼上 URL、圖片或長內容。
  • 你可以接受增加的 DM 回合延遲（見下方）。
在以下情況保持停用：
  • 你需要單字 DM 觸發的最低指令延遲。
  • 你的所有流程都是沒有後續酬載的一次性指令。

​
場景與代理看到的內容

使用者組合內容Apple 投遞關閉旗標（預設）開啟旗標 + 2500 ms 視窗
Dump https://example.com（一次傳送）約相隔 1 秒的 2 個 Webhook兩個代理回合：只有 “Dump”，接著是 URL一個回合：合併文字 Dump https://example.com
Save this 📎image.jpg caption（附件 + 文字）2 個 Webhook兩個回合一個回合：文字 + 圖片
/status（獨立指令）1 個 Webhook立即派送等待最多到視窗結束，然後派送
單獨貼上的 URL1 個 Webhook立即派送立即派送（桶中只有一個項目）
文字 + URL 以兩則刻意分開的訊息傳送，相隔數分鐘視窗外的 2 個 Webhook兩個回合兩個回合（視窗在兩者之間到期）
快速大量湧入（視窗內 >10 則小型 DM）N 個 WebhookN 個回合一個回合，有界限的輸出（套用第一個 + 最新、文字/附件上限）

​
分段傳送合併疑難排解

如果旗標已開啟，但分段傳送仍以兩個回合抵達，請檢查每一層： 
grep coalesceSameSenderDms ~/.openclaw/openclaw.json
然後執行 openclaw gateway restart — 此旗標會在建立防抖器註冊表時讀取。
查看 ~/Library/Logs/bluebubbles-server/main.log 下的 BlueBubbles 伺服器日誌：
grep -E "Dispatching event to webhook" main.log | tail -20
測量 "Dump" 風格文字派送與後續 "https://..."; Attachments: 派送之間的間隔。將 messages.inbound.byChannel.bluebubbles 提高到能從容涵蓋該間隔的值。
工作階段事件時間戳（~/.openclaw/agents/<id>/sessions/*.jsonl）反映 Gateway 將訊息交給代理的時間，不是 Webhook 抵達的時間。標記為 [Queued messages while agent was busy] 的已佇列第二則訊息，表示第二個 Webhook 抵達時第一回合仍在執行，合併桶已經清空。請根據 BB 伺服器日誌調整視窗，而不是工作階段日誌。
在較小的機器（8 GB）上，代理回合可能會花很久，導致合併桶在回覆完成前清空，而 URL 會以已佇列的第二回合進入。檢查 memory_pressure 和 ps -o rss -p $(pgrep openclaw-gateway)；如果 Gateway 超過約 500 MB RSS 且壓縮器正在作用，請關閉其他高負載程序或改用更大的主機。
如果使用者點選 Dump 作為既有 URL 氣泡的回覆（iMessage 在 Dump 氣泡上顯示「1 Reply」徽章），URL 會位於 replyToBody，而不是第二個 Webhook 中。合併不適用 — 那是 Skills/提示詞問題，不是防抖器問題。

​
區塊串流

控制回覆要以單一訊息傳送，或以區塊串流傳送： 
{
  channels: {
    bluebubbles: {
      blockStreaming: true, // enable block streaming (off by default)
    },
  },
}

​
媒體 + 限制

  • 傳入附件會下載並儲存在媒體快取中。
  • 透過 channels.bluebubbles.mediaMaxMb 設定傳入與傳出媒體的媒體上限（預設值：8 MB）。
  • 傳出文字會依 channels.bluebubbles.textChunkLimit 分段（預設值：4000 字元）。

​
設定參考

完整設定：設定
  • channels.bluebubbles.enabled：啟用/停用頻道。
  • channels.bluebubbles.serverUrl：BlueBubbles REST API 基礎 URL。
  • channels.bluebubbles.password：API 密碼。
  • channels.bluebubbles.webhookPath：Webhook 端點路徑（預設值：/bluebubbles-webhook）。
  • channels.bluebubbles.dmPolicy：pairing | allowlist | open | disabled（預設值：pairing）。
  • channels.bluebubbles.allowFrom：DM 允許清單（帳號、電子郵件、E.164 號碼、chat_id:*、chat_guid:*）。
  • channels.bluebubbles.groupPolicy：open | allowlist | disabled（預設值：allowlist）。
  • channels.bluebubbles.groupAllowFrom：群組寄件者允許清單。
  • channels.bluebubbles.enrichGroupParticipantsFromContacts：在 macOS 上，通過門檻檢查後，可選擇從本機「聯絡人」補充未命名群組參與者。預設值：false。
  • channels.bluebubbles.groups：每個群組的設定（requireMention 等）。
  • channels.bluebubbles.sendReadReceipts: 傳送已讀回條（預設：true）。
  • channels.bluebubbles.blockStreaming: 啟用區塊串流（預設：false；串流回覆需要此項）。
  • channels.bluebubbles.textChunkLimit: 外送分塊大小，以字元數計（預設：4000）。
  • channels.bluebubbles.sendTimeoutMs: 透過 /api/v1/message/text 傳送外送文字時，每個請求的逾時時間，以毫秒計（預設：30000）。在 macOS 26 設定中，如果 Private API iMessage 傳送可能在 iMessage framework 內停滯 60 秒以上，請提高此值；例如 45000 或 60000。探測、聊天查找、反應、編輯和健康檢查目前仍保留較短的 10 秒預設值；後續計畫將涵蓋範圍擴大到反應和編輯。每個帳號覆寫：channels.bluebubbles.accounts.<accountId>.sendTimeoutMs。
  • channels.bluebubbles.chunkMode: length（預設）只會在超過 textChunkLimit 時分割；newline 會先依空白行（段落邊界）分割，再按長度分塊。
  • channels.bluebubbles.mediaMaxMb: 傳入/傳出媒體上限，以 MB 計（預設：8）。
  • channels.bluebubbles.mediaLocalRoots: 明確允許用於傳出本機媒體路徑的絕對本機目錄允許清單。除非已設定此項，否則預設拒絕傳送本機路徑。每個帳號覆寫：channels.bluebubbles.accounts.<accountId>.mediaLocalRoots。
  • channels.bluebubbles.coalesceSameSenderDms: 將連續的同一寄件者 DM Webhook 合併成一次代理回合，讓 Apple 的文字+URL 分割傳送以單一訊息抵達（預設：false）。請參閱合併分割傳送的 DM，了解情境、視窗調整與取捨。啟用時若未明確設定 messages.inbound.byChannel.bluebubbles，會將預設傳入防抖視窗從 500 ms 擴大到 2500 ms。
  • channels.bluebubbles.historyLimit: 內容脈絡的群組訊息數上限（0 會停用）。
  • channels.bluebubbles.dmHistoryLimit: DM 歷史記錄限制。
  • channels.bluebubbles.actions: 啟用/停用特定動作。
  • channels.bluebubbles.accounts: 多帳號設定。
相關全域選項：
  • agents.list[].groupChat.mentionPatterns（或 messages.groupChat.mentionPatterns）。
  • messages.responsePrefix。

​
定址 / 傳遞目標

建議使用 chat_guid 進行穩定路由：
  • chat_guid:iMessage;-;+15555550123（群組建議使用）
  • chat_id:123
  • chat_identifier:...
  • 直接 handle：+15555550123、user@example.com
    • 如果直接 handle 沒有既有的 DM 聊天，OpenClaw 會透過 POST /api/v1/chat/new 建立一個。這需要啟用 BlueBubbles Private API。

​
iMessage 與 SMS 路由

當同一個 handle 在 Mac 上同時有 iMessage 和 SMS 聊天時（例如某個電話號碼已註冊 iMessage，但也曾收到綠色氣泡備援），OpenClaw 會優先使用 iMessage 聊天，且絕不會默默降級為 SMS。若要強制使用 SMS 聊天，請使用明確的 sms: 目標前綴（例如 sms:+15555550123）。沒有相符 iMessage 聊天的 handle 仍會透過 BlueBubbles 回報的任何聊天傳送。

​
安全性

  • Webhook 請求會透過比較 guid/password 查詢參數或標頭與 channels.bluebubbles.password 來驗證。
  • 請將 API 密碼和 Webhook 端點保密（視同憑證處理）。
  • BlueBubbles Webhook 驗證沒有 localhost 繞過。如果你代理 Webhook 流量，請在請求端到端保留 BlueBubbles 密碼。此處的 gateway.trustedProxies 不會取代 channels.bluebubbles.password。請參閱 Gateway 安全性。
  • 如果要將 BlueBubbles 伺服器暴露到 LAN 外，請啟用 HTTPS + 防火牆規則。

​
疑難排解

  • 如果輸入/已讀事件停止運作，請檢查 BlueBubbles Webhook 記錄，並確認 Gateway 路徑符合 channels.bluebubbles.webhookPath。
  • 配對代碼會在一小時後過期；請使用 openclaw pairing list bluebubbles 和 openclaw pairing approve bluebubbles <code>。
  • 反應需要 BlueBubbles Private API（POST /api/v1/message/react）；請確認伺服器版本有公開它。
  • 編輯/取消傳送需要 macOS 13+ 和相容的 BlueBubbles 伺服器版本。在 macOS 26（Tahoe）上，由於 Private API 變更，編輯目前無法使用。
  • 群組圖示更新在 macOS 26（Tahoe）上可能不穩定：API 可能回傳成功，但新圖示不會同步。
  • OpenClaw 會根據 BlueBubbles 伺服器的 macOS 版本自動隱藏已知無法運作的動作。如果在 macOS 26（Tahoe）上仍看到編輯，請使用 channels.bluebubbles.actions.edit=false 手動停用它。
  • 已啟用 coalesceSameSenderDms，但分割傳送（例如 Dump + URL）仍以兩個回合抵達：請參閱分割傳送合併疑難排解檢查清單 — 常見原因包括防抖視窗太短、將工作階段記錄時間戳誤讀為 Webhook 抵達時間，或回覆引用傳送（其使用 replyToBody，而不是第二個 Webhook）。
  • 如需狀態/健康資訊：openclaw status --all 或 openclaw status --deep。
如需一般頻道工作流程參考，請參閱頻道和 Plugin 指南。

​
相關