bluebubbles¶

Skill 简介¶

BlueBubbles 是一个 OpenClaw 平台下的 Skill，用于通过 BlueBubbles 集成 iMessage 服务，让开发者可以更便捷地在应用中发送和管理 iMessages。通过 BlueBubbles Skill，开发者能够实现发送文本和附件消息、添加反应（Tapback）、编辑或撤回消息、回复特定消息以及管理群组消息等操作。该 Skill 的推荐使用方式是通过通用的消息工具，并指定 channel: "bluebubbles"，这使得它成为 OpenClaw 生态系统中处理 iMessage 的首选方案。

对于开发者而言，集成 iMessage 功能通常需要处理复杂的 API 交互和设备间的通讯协议，而 BlueBubbles Skill 的出现简化了这一过程。它通过预配置的接口和简化的 JSON 格式命令，让开发者能够轻松实现与 iMessage 的交互，从而专注于应用的核心功能开发。

主要功能¶

1. 发送消息

BlueBubbles Skill 支持通过 iMessage 发送文本消息和附件消息。开发者可以使用 send 动作指定目标（如电话号码或邮箱）、消息内容以及可选的附件路径。例如：

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

2. 添加和移除反应（Tapback）

开发者可以通过 react 动作为目标消息添加表情符号反应（Tapback），也可以移除已添加的反应。例如，添加一个❤️反应：

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

要移除该反应，只需将 remove 参数设置为 true：

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

3. 编辑和撤回消息

BlueBubbles Skill 允许开发者编辑之前发送的消息内容或完全撤回消息。使用 edit 动作可以更新消息内容：

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

而使用 unsend 动作则可以撤回消息：

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

4. 回复特定消息

开发者可以使用 reply 动作针对特定消息进行回复：

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

5. 发送带 iMessage 效果的消息

BlueBubbles Skill 支持发送带有特殊 iMessage 效果的消息，例如气球效果：

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

6. 管理群组消息

开发者可以通过该 Skill 添加或移除群组成员、更改群组名称或图标等操作。

使用场景¶

1. 客户服务应用

在客户服务应用中，开发者可以使用 BlueBubbles Skill 实现通过 iMessage 与客户进行沟通，发送订单更新、回复常见问题等。

2. 团队协作工具

在团队协作工具中，开发者可以利用该 Skill 发送通知、提醒或文件附件，并使用群组管理功能组织团队讨论。

3. 社交媒体管理

社交媒体管理应用可以使用 BlueBubbles Skill 发送私信或群组消息，回复用户评论或消息，并添加反应以增强互动。

4. 自动化任务

开发者可以创建自动化任务，例如定时发送消息、基于特定事件触发消息发送等。

5. 消息备份与存档

通过该 Skill，开发者可以实现 iMessage 消息的备份与存档，以便后续查询和分析。

如何使用¶

安装与配置¶

1. 安装 OpenClaw CLI：
   bash npm install -g @openclaw/cli

2. 配置 BlueBubbles 网关：
   在 extensions/bluebubbles/config.json 中配置 serverUrl、password 和 webhookPath。
   json { "serverUrl": "https://your-bluebubbles-server.com", "password": "your-password", "webhookPath": "/path/to/webhook" }

3. 启动 OpenClaw：
   bash openclaw start

前置条件¶

• 已安装 Node.js 和 npm
• 有效的 BlueBubbles 服务器 URL 和密码
• 配置正确的 Webhook 路径以接收消息回调

示例¶

示例 1：发送带附件的消息¶

{
  "action": "sendAttachment",
  "channel": "bluebubbles",
  "target": "+15551234567",
  "path": "/tmp/photo.jpg",
  "caption": "Check out this photo!"
}

示例 2：添加反应并回复消息¶

// 添加反应
{
  "action": "react",
  "channel": "bluebubbles",
  "target": "+15551234567",
  "messageId": "<message-guid>",
  "emoji": "👍"
}

// 回复消息
{
  "action": "reply",
  "channel": "bluebubbles",
  "target": "+15551234567",
  "replyTo": "<message-guid>",
  "message": "Thanks for the update!"
}

总结¶

BlueBubbles Skill 是 OpenClaw 平台中处理 iMessage 交互的强大工具。它不仅简化了与 iMessage 的集成流程，还为开发者提供了丰富的功能选项，包括消息发送、反应管理、消息编辑与撤回、群组消息管理等。通过该 Skill，开发者可以轻松实现各种基于 iMessage 的应用场景，提升用户体验和交互效率。无论是客户服务、团队协作还是自动化任务，BlueBubbles Skill 都是一个值得信赖的解决方案。