BlueBubbles 是 OpenClaw 推荐的 iMessage 集成方式。使用时通过 message 工具并指定 channel: "bluebubbles" 来发送消息和管理 iMessage 会话。
主要能力包括:发送文本和附件;点按回应(tapbacks);编辑或撤回消息;在线程中回复;管理群聊参与者、群名称与群图标。示例动作包括 send、react、edit、unsend、reply、sendAttachment、sendWithEffect,均通过 action 字段指定。
使用方式:需要收集目标(优先 chat_guid:...,也可用 E.164 格式如 +15551234567,或 user@example.com)、发送/编辑/回复的正文、用于回应/编辑/撤回/回复的 messageId,以及本地附件的路径或 base64 的 buffer 加 filename。若用户表述模糊(如“给我妈发短信”),应主动索要收件人标识或 chat guid 及确切消息内容。
注意事项:使用前需配置网关 channels.bluebubbles(serverUrl/password/webhookPath)。有 chat_guid 时优先使用,尤其在群聊中。BlueBubbles 支持丰富的动作,但部分功能依赖 macOS 版本,例如在 macOS 26 Tahoe 上编辑可能失效。网关可能同时暴露短消息 ID 和完整消息 ID,完整 ID 在重启后更稳定。底层插件的开发者参考见 extensions/bluebubbles/README.md。