bluebubbles

Send and manage iMessage texts, reactions, edits, and attachments via BlueBubbles.

Updated Feb 8, 2026
One-click install
npx skills add https://github.com/nomad3/openclaw-k8s --skill bluebubbles-nomad3
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: bluebubbles
Source: https://github.com/nomad3/openclaw-k8s/tree/main/package/skills/bluebubbles
Command: npx skills add https://github.com/nomad3/openclaw-k8s --skill bluebubbles-nomad3

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Bluebubbles helps you send and manage iMessages without manually interacting with the iOS/macOS app, including replies, edits, reactions, and attachments.

Core Features & Use Cases

  • Message sending & conversation management: Send new iMessages and manage conversation context for direct chats or groups.
  • Rich actions: React (tapbacks), edit/unsend previously sent messages, and reply to specific messages in-thread.
  • Attachments and effects: Send local file attachments (with optional captions) and include message effects for richer communication.
  • Example use case: Ask for a quick acknowledgment to a request by reacting to the triggering message and replying with the next step in the same chat thread.

Quick Start

Use the bluebubbles skill to send a message to +15551234567 saying "hello from OpenClaw".

Frequently Asked Questions about bluebubbles

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I send iMessages programmatically without using the iOS app directly?▼

You can send iMessages by routing requests through the BlueBubbles gateway using a specified channel, recipient handle, and message text. This automates sending and managing conversations without manual iOS app interaction.

Can I reply to a specific message in an iMessage thread?▼

Yes, you can reply to specific iMessage thread messages by providing a target messageId and reply context. This maintains threaded conversations within one-to-one or group iMessage workflows.

Does BlueBubbles support sending message effects and file attachments?▼

Yes, BlueBubbles supports sending local file attachments with captions and applying message effects. You provide the file path or buffer with a filename to enrich your iMessage communications.

What are the prerequisites for managing iMessage conversations through a gateway?▼

Managing iMessage conversations requires a configured BlueBubbles gateway at the channels.bluebubbles routing path. You must also provide target identifiers like a chat_guid or recipient E.164 address.

How do I edit or unsend a previously sent iMessage?▼

To edit or unsend prior iMessages, you reference the specific messageId of the target message. This enables correcting or retracting sent messages within your active iMessage workflows.

Can I use tapbacks to react to iMessages in group chats?▼

Yes, you can apply tapback reactions to messages in direct or group iMessage chats. By targeting a specific messageId, you can react to messages without sending a new text reply.