skills.rest
Polealpha
PolealphaCOMMUNITY
Explore all skills by this author →
GitHub

bluebubbles

Send iMessages, reply in threads, and manage conversation actions via BlueBubbles.

Updated Mar 21, 2026
Search Tags:#threads#attachments#imessage#bluebubbles#messaging automation#chat_guid#tapback reactions
One-click install
npx skills add https://github.com/Polealpha/XINNIAN_PI --skill bluebubbles-polealpha
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: bluebubbles
Source: https://github.com/Polealpha/XINNIAN_PI/tree/main/app%20windows/vendor/openclaw-runtime/skills/bluebubbles
Command: npx skills add https://github.com/Polealpha/XINNIAN_PI --skill bluebubbles-polealpha

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

BlueBubbles streamlines sending and managing iMessages without manually switching to a phone or chat app, so you can reliably trigger message actions from an AI workflow.

Core Features & Use Cases

  • Message sending and thread replies: Send new texts and reply to a specific message id for in-thread context.
  • Conversation actions: Perform rich iMessage actions like tapbacks (reactions), edit, unsend, and targeted replies.
  • Attachment delivery: Send files as attachments with optional captions for things like photos or documents.
  • Group and participant targeting: Use chat_guid when available to keep group targeting accurate, including names/icons management when supported.

Quick Start

Use the bluebubbles channel to send a message by specifying the target chat guid or phone number plus the exact text you want to send.

Frequently Asked Questions about bluebubbles

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

FAQPage Schema
How do I automate sending iMessages from an AI workflow?▼

Automate iMessage delivery by configuring the BlueBubbles integration and using the message tool with channel set to "bluebubbles" to send texts to target chats from your agent.

Can I reply to a specific iMessage thread or send attachments via an agent?▼

Replying in iMessage threads requires specifying the target message id, while sending attachments is supported by passing files with optional captions through the BlueBubbles channel.

How do tapback reactions work when automating iMessage conversations?▼

Tapback reactions are managed as conversation actions through the BlueBubbles integration, requiring a valid target message identifier to apply the reaction to the correct iMessage.

Do I need a chat_guid to target iMessage group chats accurately?▼

Using a chat_guid is optional but recommended for iMessage group chats to ensure participant targeting remains accurate when triggering message actions from an agent.

What iMessage actions can I perform besides sending a new text message?▼

Beyond sending new iMessages, you can perform conversation actions like editing, unsending, targeted replies, and tapback reactions on existing messages within individual or group chats.

Why is my BlueBubbles messaging automation not delivering to the correct chat?▼

Delivery issues in BlueBubbles messaging automation often stem from missing a valid gateway configuration via channels.bluebubbles or failing to specify a stable chat_guid for the target conversation.

Related Skills

Explore More Content & Communication Skills→
vbgatevbgate
1

discord-setup

Configures OpenClaw to connect to Discord for messaging and channel-controlled operations.

Official
Intermediate
jpcaparasjpcaparas
37

notification-auditor

Audit notification configurations and delivery evidence without sending messages.

Community
Basic
simplefarmer69simplefarmer69
2

bluebubbles

Send and manage iMessage texts and attachments via BlueBubbles.

Community
Intermediate
silva2kandsilva2kand

imsg

Manage iMessage and SMS chats, histories, and message sending from the command line.

Community
Basic