用途 BlueBubbles 是 OpenClaw 推荐的 iMessage 集成方式。需要通过 message 工具并指定 channel: "bluebubbles" 来发送消息、管理 iMessage 会话,包括发送文本和附件、Tapback 回应、编辑、撤回、线程回复,以及管理群组成员、名称和图标。
需要收集的输入 target:优先使用 chat_guid:...,也可使用 E.164 格式的 +15551234567 或 user@example.com。 message:用于 send/edit/reply 的文本。 messageId:用于 react/edit/unsend/reply。 附件:本地文件路径,或 buffer 加 filename 的 base64 形式。 如果用户表述模糊(例如“给我妈发短信”),应询问收件人句柄或 chat guid,以及确切的消息内容。
主要动作 支持 send、react(Tapback,可用 remove: true 移除回应)、edit、unsend、reply、sendAttachment,以及带 iMessage 特效的 sendWithEffect。各动作通过 action 字段区分,配合 channel、target、message、messageId、emoji、replyTo、path、caption、effect 等参数使用。
注意事项 需要网关配置 channels.bluebubbles(serverUrl/password/webhookPath)。 有 chat_guid 时优先使用,尤其是群聊。 BlueBubbles 支持丰富的动作,但部分动作依赖 macOS 版本,例如 edit 在 macOS 26 Tahoe 上可能失效。 网关可能同时暴露短消息 id 和完整消息 id,完整 id 在重启后更持久。 底层插件的开发者参考见 extensions/bluebubbles/README.md。
适用场景 可用于用 Tapback 回应确认请求、在用户引用某条特定消息时进行线程回复、发送带简短说明的文件附件等。
限制 具体平台、收费与价格信息暂未提供;部分能力受 macOS 版本影响。