用途:BlueBubbles 是 OpenClaw 推荐的 iMessage 集成方案,用于通过 message 工具发送和管理 iMessage 会话。调用时指定 channel: "bluebubbles"。
主要能力:发送文本与附件;点按回应(tapback)及移除回应;编辑与撤回已发消息;在指定消息下线程回复;管理群组成员、名称与图标;发送带 iMessage 效果的消息。
必要输入:target(优先使用 chat_guid:...,也可用 E.164 格式的 +15551234567 或 user@example.com);发送/编辑/回复所需的 message 文本;react/edit/unsend/reply 所需的 messageId;附件需本地路径,或 buffer 加 filename 的 base64。若用户表述含糊(如“给我妈发短信”),需先询问收件人句柄或 chat guid 及确切消息内容。
用法示例:发送消息使用 action: "send" 并附 target 与 message;点按回应使用 action: "react" 并附 messageId 与 emoji,移除回应时加 remove: true;编辑用 action: "edit",撤回用 action: "unsend",线程回复用 action: "reply" 并附 replyTo;发送附件用 action: "sendAttachment" 并附 path 与可选 caption;带效果发送用 action: "sendWithEffect" 并附 effect。
限制与注意:需在网关配置 channels.bluebubbles(serverUrl/password/webhookPath)。有 chat_guid 时优先使用,群聊尤其如此。部分富操作依赖 macOS 版本,例如编辑在 macOS 26 Tahoe 上可能失效。网关可能同时暴露短消息 id 与完整消息 id,完整 id 在重启后更稳定。底层插件的开发者参考见 extensions/bluebubbles/README.md。