用途:BlueBubbles 是 OpenClaw 推荐的 iMessage 集成方案,用于发送和管理 iMessage 会话。调用统一走 message 工具,并指定 channel: "bluebubbles"。
主要能力:发送文本与附件;点按回应(tapback)及移除回应;编辑与撤回已发送消息;在指定消息下线程回复;管理群组成员、名称与图标。
使用方式:需先收集输入,包括 target(优先 chat_guid:...,也支持 E.164 格式如 +15551234567 或 user@example.com)、消息文本、messageId(用于回应/编辑/撤回/回复)、附件路径或 buffer 加 filename。若用户表述含糊(如“给我妈发短信”),应先询问收件人标识与确切消息内容。动作通过 JSON 参数指定,例如 action 为 send、react、edit、unsend、reply、sendAttachment、sendWithEffect,并配合 channel、target、message、messageId、emoji、path、caption、effect 等字段。
适用场景:需要以 iMessage 渠道发送消息、回应请求、针对特定消息线程回复,或发送带简短说明的文件附件。
限制:需要网关配置 channels.bluebubbles(serverUrl/password/webhookPath)。有 chat_guid 时优先使用,群聊尤其如此。部分富动作依赖 macOS 版本,例如编辑在 macOS 26 Tahoe 上可能失效。网关可能同时暴露短消息 id 与完整消息 id,完整 id 在重启后更稳定。底层插件开发者参考见 extensions/bluebubbles/README.md。