bluebubbles

Send and manage iMessages with reactions, edits, replies, and group controls via BlueBubbles.

1|Updated Mar 6, 2026
One-click install
npx skills add https://github.com/zhcndoc/openclaw --skill bluebubbles-zhcndoc
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: bluebubbles
Source: https://github.com/zhcndoc/openclaw/tree/main/skills/bluebubbles
Command: npx skills add https://github.com/zhcndoc/openclaw --skill bluebubbles-zhcndoc

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

OpenClaw's BlueBubbles integration enables seamless iMessage communication across devices by allowing you to send texts, attach files, react with tapbacks, edit or unsend messages, reply in threads, and manage group participants and icons from the OpenClaw interface.

Core Features & Use Cases

  • Send a message: deliver texts and attachments to individuals or groups.
  • React and manage conversations: apply tapbacks, edit or unsend messages, and reply in-thread.
  • Group coordination: manage participants, names, and icons for group chats.
  • Use Case: coordinate a team meetup by sending updates, sharing images, and replying to specific messages in a thread.

Quick Start

Send a test message to a contact using the BlueBubbles channel to verify delivery.

Frequently Asked Questions about bluebubbles

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

FAQPage Schema
How do I send iMessages with attachments from a custom interface?

You can send iMessages with attachments by using the BlueBubbles integration to deliver texts and files to individuals or groups. It requires configuring the gateway with your serverUrl, password, and webhookPath to enable cross-device messaging.

Can I edit or unsend an iMessage after it has been delivered?

Yes, you can edit or unsend an iMessage after delivery using the react, edit, and unsend actions provided by the BlueBubbles integration. This allows you to manage conversations and correct mistakes directly from your interface.

Does the BlueBubbles integration support replying in threads and tapbacks?

The BlueBubbles integration supports applying tapbacks and replying in-thread to specific messages. This enables contextual group coordination by allowing you to react to and reply directly to individual messages within a conversation.

What do I need to configure before managing group chats through BlueBubbles?

Before managing group chats, you need to configure the gateway channels.bluebubbles with your serverUrl, password, and webhookPath. Once configured, you can manage group participants, names, and icons for group chats.

How does cross-device iMessage management work for team coordination?

Cross-device iMessage management works by connecting your interface to the BlueBubbles server, enabling you to send updates, share images, and reply in threads. This streamlines team meetups and everyday workflows across multiple devices.

Are there limitations when sending texts and attachments through BlueBubbles?

The primary limitation for sending texts and attachments is the strict requirement for a correctly configured BlueBubbles gateway, specifically the serverUrl, password, and webhookPath channels, without which messaging actions cannot execute.