SuperAPI AI 工具集

bluebubbles

通用与其它

查看项目

更新于 10-16 09:59

技能介绍

用途:BlueBubbles 是 OpenClaw 推荐的 iMessage 集成方式,用于发送和管理 iMessage 会话。调用时统一走通用 message 工具,并指定 channel: "bluebubbles"。

主要能力:可发送文本与附件;添加点按回应(tapback)并移除回应;编辑或撤回已发送消息;在指定消息下回复;以及管理群组成员、名称和图标。

输入项:target 优先使用 chat_guid:... 形式,也可用 E.164 格式手机号(如 +15551234567)或 user@example.com;发送/编辑/回复需要消息文本;react/edit/unsend/reply 需要 messageId;本地附件需提供路径,base64 需提供 buffer 加 filename。若用户表述模糊(如“给我妈发消息”),应先询问收件人标识或 chat guid 以及确切消息内容。

用法示例:发送消息可用 action: send,channel: bluebubbles,target 与 message;点按回应用 action: react 并给出 messageId 与 emoji,加 remove: true 可移除回应;编辑用 action: edit 配 messageId 和新 message;撤回用 action: unsend;线程回复用 action: reply 配 replyTo;发附件用 action: sendAttachment 配 path 与可选 caption;特效发送用 action: sendWithEffect 并指定 effect(如 balloons)。

场景思路:用点按回应确认请求;用户引用某条消息时进行线程回复;发送文件并附简短说明。

限制与注意事项:需要在网关配置 channels.bluebubbles(serverUrl/password/webhookPath)。尽量优先使用 chat_guid 目标,群聊尤其如此。BlueBubbles 虽支持丰富操作,但部分功能依赖 macOS 版本,例如编辑在 macOS 26 Tahoe 上可能失效。网关可能同时暴露短 id 和完整 id,完整 id 在重启后更稳定。底层插件的开发者参考见 BlueBubbles 插件包 README。