BlueBubbles 操作

概述

BlueBubbles 是 OpenClaw 推荐的 iMessage 集成方式。使用 message 工具并设置 channel: "bluebubbles" 来发送消息和管理 iMessage 对话：发送文本和附件、添加反应（tapback）、编辑/撤回、在线程中回复，以及管理群组成员/名称/图标。

需要收集的输入

• target（优先使用 chat_guid:...；也可以是 E.164 格式的 +15551234567 或 user@example.com）
• 用于发送/编辑/回复的 message 文本
• 用于反应/编辑/撤回/回复的 messageId
• 附件的本地文件 path，或 base64 格式的 buffer + filename

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

操作

发送消息

{
  "action": "send",
  "channel": "bluebubbles",
  "target": "+15551234567",
  "message": "来自 OpenClaw 的问候"
}

添加反应（tapback）

{
  "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": "更新后的文本"
}

撤回消息

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

回复特定消息

{
  "action": "reply",
  "channel": "bluebubbles",
  "target": "+15551234567",
  "replyTo": "<message-guid>",
  "message": "回复那条消息"
}

发送附件

{
  "action": "sendAttachment",
  "channel": "bluebubbles",
  "target": "+15551234567",
  "path": "/tmp/photo.jpg",
  "caption": "给你"
}

带 iMessage 特效发送

{
  "action": "sendWithEffect",
  "channel": "bluebubbles",
  "target": "+15551234567",
  "message": "重大消息",
  "effect": "balloons"
}

注意事项

• 需要在网关配置 channels.bluebubbles 中设置（serverUrl/password/webhookPath）。
• 当有聊天 GUID 时，优先使用 chat_guid 作为目标（尤其是群聊）。
• BlueBubbles 支持丰富的操作，但部分功能可能受 macOS 版本影响（例如，在 macOS 26 Tahoe 上编辑功能可能存在问题）。
• 网关可能暴露短消息 ID 和完整消息 ID；完整 ID 在重启后更稳定。
• 底层插件的开发者参考位于 extensions/bluebubbles/README.md。

尝试的想法

• 使用 tapback 反应来确认请求。
• 当用户引用特定消息时，在线程中进行回复。
• 发送带有简短说明的文件附件。