A powerful integration enabling AI agents to send and manage iMessages through a self-hosted BlueBubbles macOS server.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install tc-bluebubbles
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install tc-bluebubbles using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is BlueBubbles iMessage Skill?
The BlueBubbles skill is a specialized communication bridge designed for Openclaw Skills that allows AI agents to interact directly with the iMessage ecosystem. By leveraging a self-hosted BlueBubbles server on macOS, this skill bypasses traditional API limitations, granting agents the ability to send texts, handle attachments, and use native iMessage features.
This tool is essential for developers looking to build responsive AI assistants that live within the Apple messaging environment. It provides a secure, private way to extend Openclaw Skills into personal and professional chat workflows without relying on third-party cloud messaging middle-men.
BlueBubbles iMessage Skill Use Cases
- Automating client updates and reports directly to iMessage contacts.
- Sending real-time system alerts or notifications with native iMessage effects like confetti or lasers.
- Delivering generated documents and media files as iMessage attachments.
- Interactive AI customer support or personal assistant workflows via a standard phone number or iCloud email.
How BlueBubbles iMessage Skill Works
- The AI agent triggers a tool call (e.g., bluebubbles_send) with the recipient's handle and message content.
- The Openclaw Skills gateway processes the request and authenticates with the configured BlueBubbles server URL.
- The self-hosted BlueBubbles macOS server receives the command and interacts with the native macOS Messages app.
- The message is dispatched through the Apple iMessage network to the target device.
- Status confirmations or message IDs are returned to the agent for further interaction, such as reactions or edits.
BlueBubbles iMessage Skill Setup
To enable this skill, you must have a functional BlueBubbles server running on a macOS machine. Configure your gateway by adding the following to your configuration file:
[channels.bluebubbles]
server_url = "http://your-server-ip:port"
password = "your-password"
allowed_senders = ["*"]
Ensure that the Openclaw Skills environment has network access to your BlueBubbles server instance.
BlueBubbles iMessage Skill Data Schema & Taxonomy
The skill manages communication data through structured JSON payloads. Below are the primary data fields used by the Openclaw Skills integration:
| Field | Type | Description |
|---|---|---|
| target | String | The phone number (+1...) or iCloud email of the recipient. |
| message | String | The body text of the iMessage. |
| effect | String | Optional native iMessage screen or bubble effect (e.g., 'spotlight'). |
| file_path | String | Local path to an attachment file to be uploaded and sent. |
| message_id | String | The unique identifier for a specific message, used for reactions. |
BlueBubbles iMessage Skill Advanced Features
- Support for full-screen and bubble effects including slam, loud, gentle, balloons, lasers, and fireworks.
- Attachment handling for seamless delivery of PDFs, images, and reports generated by the agent.
- Message interaction capabilities including native emoji reactions (Tapbacks).
- Fine-grained access control via the allowed_senders configuration to restrict which handles the agent can interact with.
SKILL.md
Loading
Related Openclaw Skills
Subscription Cancel Call Script
A prompt-based tool designed to build firm, honest cancellation call scripts with refusal phrases and confirmation logs for recurring services.
pawr.link Quick Profile Manager
A high-speed interface for deploying and managing AI agent profiles on the pawr.link platform via x402 automated payments.
UI Controller
A specialized automation skill for controlling local user interface actions and desktop behavior on a gateway machine.
memelink
A fast and flexible CLI tool for generating memes and image macros directly from the terminal using the Memegen.link API.
GifGrep
A powerful GIF search and media processing engine that integrates Tenor and Giphy directly into your AI workflow.
LinkedIn Jobs Scraper
A lightweight, authentication-free web scraping tool for extracting LinkedIn job postings using public API endpoints.
Featured*
