name: bluebubbles description: 当需要通过BlueBubbles发送或管理iMessage时使用（推荐使用的iMessage集成）。调用通过通用消息工具完成，并设置channel=“bluebubbles”。 metadata: { “openclaw”: { “emoji”: “🫧”, “requires”: { “config”: [“channels.bluebubbles”] } } }
BlueBubbles 操作指南
概述
BlueBubbles 是 OpenClaw 推荐的 iMessage 集成方案。使用 message 工具并设置 channel: "bluebubbles" 来发送消息和管理 iMessage 对话：发送文本和附件、添加反应（轻点回放）、编辑/撤销发送、在主题中回复以及管理群聊参与者和群组名称/图标。
需要收集的输入信息
target（优先使用chat_guid:...；也可以是 E.164 格式的+15551234567或user@example.com）message用于发送/编辑/回复的文本内容messageId用于反应/编辑/撤销发送/回复- 附件
path用于本地文件，或buffer+filename用于 base64 编码
如果用户描述模糊（例如“给我妈发个短信”），请询问收件人的句柄或聊天 GUID 以及确切的消息内容。
操作
发送消息
{
"action": "send",
"channel": "bluebubbles",
"target": "+15551234567",
"message": "来自 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": "更新后的文本"
}
撤销发送消息
{
"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）。 - 尽可能优先使用
chat_guid作为目标（尤其是群聊）。 - BlueBubbles 支持丰富的操作，但部分功能依赖于 macOS 版本（例如，编辑功能在 macOS 26 Tahoe 上可能无法使用）。
- 网关可能同时暴露短消息 ID 和完整消息 ID；完整 ID 在重启后更具持久性。
- 底层插件的开发者参考文档位于
extensions/bluebubbles/README.md。
可以尝试的想法
- 使用轻点回放反应来确认收到请求。
- 当用户引用特定消息时，在主题内进行回复。
- 发送带有简短说明的文件附件。