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