🎯

bluebubbles

🎯Skill

from steipete/clawdis

What it does

Sends and manages iMessages via BlueBubbles, enabling text, attachment, reaction, and thread interactions across conversations.

📦

Part of

steipete/clawdis(48 items)

bluebubbles

Installation

npm installInstall npm package

npm install -g openclaw@latest

git cloneClone repository

git clone https://github.com/openclaw/openclaw.git

pnpmRun with pnpm

pnpm install

📖 Extracted from docs: steipete/clawdis

Need more details? View full documentation on GitHub →

9Installs

AddedFeb 4, 2026

View on GitHub Back to Skills

Skill Details

SKILL.md

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

Overview

# 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

```json

{

"action": "send",

"channel": "bluebubbles",

"target": "+15551234567",

"message": "hello from OpenClaw"

}

```

React (tapback)

```json

{

"action": "react",

"channel": "bluebubbles",

"target": "+15551234567",

"messageId": "",

"emoji": "❤️"

}

```

Remove a reaction

```json

{

"action": "react",

"channel": "bluebubbles",

"target": "+15551234567",

"messageId": "",

"emoji": "❤️",

"remove": true

}

```

Edit a previously sent message

```json

{

"action": "edit",

"channel": "bluebubbles",

"target": "+15551234567",

"messageId": "",

"message": "updated text"

}

```

Unsend a message

```json

{

"action": "unsend",

"channel": "bluebubbles",

"target": "+15551234567",

"messageId": ""

}

```

Reply to a specific message

```json

{

"action": "reply",

"channel": "bluebubbles",

"target": "+15551234567",

"replyTo": "",

"message": "replying to that"

}

```

Send an attachment

```json

{

"action": "sendAttachment",

"channel": "bluebubbles",

"target": "+15551234567",

"path": "/tmp/photo.jpg",

"caption": "here you go"

}

```

Send with an iMessage effect

```json

{

"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.

More from this repository10

🎯

gog🎯Skill

Manages Gmail, Calendar, Drive, Contacts, Sheets, and Docs via CLI with OAuth-based Google Workspace interactions.

🎯

weather🎯Skill

Retrieves current weather and forecasts for any location using free services, with multiple output formats and no API key required.

🎯

summarize🎯Skill

Quickly summarizes URLs, local files, and YouTube links using AI models with flexible extraction options.

🎯

coding-agent🎯Skill

Runs coding agents like Claude Code or Codex in bash with PTY support, enabling programmatic control and background processing.

🎯

mcporter🎯Skill

Streamlines interaction with MCP servers through CLI, enabling listing, configuration, authentication, and direct tool calls via HTTP or stdio.

🎯

apple-reminders🎯Skill

Manages Apple Reminders via CLI, enabling listing, adding, editing, completing, and deleting tasks with flexible date and list filtering.

🎯

gifgrep🎯Skill

Searches and downloads GIFs from Tenor/Giphy with a CLI/TUI, enabling preview, extraction, and easy sharing.

🎯

nano-pdf🎯Skill

Edits PDFs using natural language instructions, allowing precise page-level modifications with simple CLI commands.

🎯

obsidian🎯Skill

Automates interactions with Obsidian vaults, enabling searching, creating, moving, and managing Markdown notes via obsidian-cli.

🎯

peekaboo🎯Skill

Automates macOS UI interactions by capturing screens, targeting elements, driving input, and managing apps via a powerful CLI tool.