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.