用途:BlueBubbles 是 OpenClaw 的旧版 iMessage 桥接,用于已有 BlueBubbles 支持的会话,通过 message 工具并指定 channel: "bluebubbles" 完成消息操作。
主要能力:发送消息、点按回应(tapback)及移除回应、编辑已发送消息、撤回消息、回复指定消息、发送附件(本地路径或 base64 的 buffer + filename)、发送带 iMessage 效果的消息,并支持群组管理。
使用方式:需先收集目标(优先 chat_guid:...,也支持 E.164 格式的 +15551234567 或 user@example.com)、消息文本、messageId(用于回应/编辑/撤回/回复)、附件路径。若用户表述模糊(如“给我妈发短信”),应询问收件人句柄或 chat guid 及确切消息内容。操作以 JSON 形式传入 action、channel、target 等字段,例如发送:{"action": "send", "channel": "bluebubbles", "target": "+15551234567", "message": "hello from OpenClaw"};回应:{"action": "react", "channel": "bluebubbles", "target": "+15551234567", "messageId": "<message-guid>", "emoji": "❤️"};移除回应加 "remove": true;编辑用 action: "edit" 加 message;撤回用 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 在重启后更持久。底层插件的开发者参考见 BlueBubbles 插件包 README。