Labsco
firecrawl logo

bluebubbles

✓ Official★ 3

by firecrawl · part of firecrawl/openclaw

Use when you need to send or manage iMessages via BlueBubbles (recommended iMessage integration). Calls go through the generic message tool with…

🔥🔥🔥✓ VerifiedFreeQuick setup
#email#scraping#git#news#video-editing
🧰 Not standalone. This skill ships with firecrawl/openclaw and only works together with that tool — install the tool first, then add this skill.

Use when you need to send or manage iMessages via BlueBubbles (recommended iMessage integration). Calls go through the generic message tool with…

Inspect the full instructions your agent will receiveExpand

This is the exact playbook injected into your agent when the skill activates — shown here so you can audit it before installing. You don't need to read it to use the skill.

by firecrawl

Use when you need to send or manage iMessages via BlueBubbles (recommended iMessage integration). Calls go through the generic message tool with… npx skills add https://github.com/firecrawl/openclaw --skill bluebubbles Download ZIPGitHub3

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 [email protected])

  • 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

Copy & paste — that's it
{
 "action": "send",
 "channel": "bluebubbles",
 "target": "+15551234567",
 "message": "hello from OpenClaw"
}

React (tapback)

Copy & paste — that's it
{
 "action": "react",
 "channel": "bluebubbles",
 "target": "+15551234567",
 "messageId": " ",
 "emoji": "❤️"
}

Remove a reaction

Copy & paste — that's it
{
 "action": "react",
 "channel": "bluebubbles",
 "target": "+15551234567",
 "messageId": " ",
 "emoji": "❤️",
 "remove": true
}

Edit a previously sent message

Copy & paste — that's it
{
 "action": "edit",
 "channel": "bluebubbles",
 "target": "+15551234567",
 "messageId": " ",
 "message": "updated text"
}

Unsend a message

Copy & paste — that's it
{
 "action": "unsend",
 "channel": "bluebubbles",
 "target": "+15551234567",
 "messageId": " "
}

Reply to a specific message

Copy & paste — that's it
{
 "action": "reply",
 "channel": "bluebubbles",
 "target": "+15551234567",
 "replyTo": " ",
 "message": "replying to that"
}

Send an attachment

Copy & paste — that's it
{
 "action": "sendAttachment",
 "channel": "bluebubbles",
 "target": "+15551234567",
 "path": "/tmp/photo.jpg",
 "caption": "here you go"
}

Send with an iMessage effect

Copy & paste — that's it
{
 "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 extensions/bluebubbles/README.md.

Ideas to try

  • React with a tapback to acknowledge a request.

  • Reply in-thread when a user references a specific message.

  • Send a file attachment with a short caption.