Agent Skills › the-open-agent/openagent › bluebubbles

bluebubbles

GitHub

通过 BlueBubbles 集成管理 iMessage，支持发送消息、附件、回复、编辑、撤回及反应（tapback）等操作。需配置网关并收集目标与内容信息。

skills/bluebubbles/SKILL.md the-open-agent/openagent

Trigger Scenarios

用户需要通过 iMessage 发送文本或附件用户需要回复、编辑或删除已有的 iMessage

Install

npx skills add the-open-agent/openagent --skill bluebubbles -g -y

More Options

Use without installing

npx skills use the-open-agent/openagent@bluebubbles

指定 Agent (Claude Code)

npx skills add the-open-agent/openagent --skill bluebubbles -a claude-code -g -y

安装 repo 全部 skill

npx skills add the-open-agent/openagent --all -g -y

预览 repo 内 skill

npx skills add the-open-agent/openagent --list

SKILL.md

Frontmatter

{
    "name": "bluebubbles",
    "metadata": {
        "openclaw": {
            "emoji": "🫧",
            "requires": {
                "config": [
                    "channels.bluebubbles"
                ]
            }
        }
    },
    "description": "Use when you need to send or manage iMessages via BlueBubbles (recommended iMessage integration). Calls go through the generic message tool with channel=\"bluebubbles\"."
}

BlueBubbles Actions

Overview

BlueBubbles is OpenClaw’s recommended iMessage integration. Use the message tool with channel: "bluebubbles" to send messages and manage iMessage conversations: send texts and attachments, react (tapbacks), edit/unsend, reply in threads, and manage group participants/names/icons.

Inputs to collect

target (prefer chat_guid:...; also +15551234567 in E.164 or user@example.com)
message text for send/edit/reply
messageId for react/edit/unsend/reply
Attachment path for local files, or buffer + filename for base64

If the user is vague ("text my mom"), ask for the recipient handle or chat guid and the exact message content.

Actions

Send a message

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

React (tapback)

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

Remove a reaction

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

Edit a previously sent message

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

Unsend a message

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

Reply to a specific message

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

Send an attachment

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

Send with an iMessage effect

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

Notes

Requires gateway config channels.bluebubbles (serverUrl/password/webhookPath).
Prefer chat_guid targets when you have them (especially for group chats).
BlueBubbles supports rich actions, but some are macOS-version dependent (for example, edit may be broken on macOS 26 Tahoe).
The gateway may expose both short and full message ids; full ids are more durable across restarts.
Developer reference for the underlying plugin lives in the BlueBubbles plugin package README.