bluebubbles

BlueBubbles 操作

概述

BlueBubbles 是 OpenClaw 的旧版 iMessage 桥接服务。对于需要附件、轻触回、编辑/撤回、回复或群组管理的现有 BlueBubbles 支持对话，请使用 message 工具并设置 channel: "bluebubbles"。

需要收集的输入

• target（优先使用 chat_guid:...；也可使用 E.164 格式的 +15551234567 或 [email protected]）
• 用于发送/编辑/回复的 message 文本
• 用于回应/编辑/撤回/回复的 messageId
• 本地文件的附件 path，或 base64 数据的 buffer + filename

如果用户表述含糊（“给我妈妈发消息”），请询问收件人标识或聊天 guid，以及确切的消息内容。

操作

发送消息

{
  "action": "send",
  "channel": "bluebubbles",
  "target": "+15551234567",
  "message": "hello from OpenClaw"
}

作出回应（轻触回）

{
  "action": "react",
  "channel": "bluebubbles",
  "target": "+15551234567",
  "messageId": "<message-guid>",
  "emoji": "❤️"
}

移除回应

{
  "action": "react",
  "channel": "bluebubbles",
  "target": "+15551234567",
  "messageId": "<message-guid>",
  "emoji": "❤️",
  "remove": true
}

编辑先前发送的消息

{
  "action": "edit",
  "channel": "bluebubbles",
  "target": "+15551234567",
  "messageId": "<message-guid>",
  "message": "updated text"
}

撤回消息

{
  "action": "unsend",
  "channel": "bluebubbles",
  "target": "+15551234567",
  "messageId": "<message-guid>"
}

回复特定消息

{
  "action": "reply",
  "channel": "bluebubbles",
  "target": "+15551234567",
  "replyTo": "<message-guid>",
  "message": "replying to that"
}

发送附件

{
  "action": "sendAttachment",
  "channel": "bluebubbles",
  "target": "+15551234567",
  "path": "/tmp/photo.jpg",
  "caption": "here you go"
}

使用 iMessage 效果发送

{
  "action": "sendWithEffect",
  "channel": "bluebubbles",
  "target": "+15551234567",
  "message": "big news",
  "effect": "balloons"
}

注意事项

• 需要网关配置 channels.bluebubbles（serverUrl/password/webhookPath）。
• 如果有 chat_guid 目标，请优先使用（尤其适用于群聊）。
• BlueBubbles 支持丰富操作，但其中一些取决于 macOS 版本（例如，编辑功能在 macOS 26 Tahoe 上可能无法正常工作）。
• 网关可能会同时提供短消息 ID 和完整消息 ID；完整消息 ID 在重启后更不易失效。
• 底层插件的开发参考文档位于 BlueBubbles 插件包的 README 中。

可以尝试的用法

• 使用轻触回作出回应，以确认收到请求。
• 当用户提及特定消息时，在同一对话线程中回复。
• 发送带简短说明的文件附件。