BlueBubbles — OpenClaw Skill
Send and manage iMessages via BlueBubbles: texts, tapbacks, edits, attachments, and group chats.
What This Skill Does
The BlueBubbles skill is OpenClaw's recommended iMessage integration. It gives your agent the ability to send texts and attachments, react with tapbacks, edit or unsend sent messages, reply in threads, send messages with bubble effects like balloons or confetti, and manage group chat participants and names -- all through the OpenClaw message tool with the bluebubbles channel.
BlueBubbles bridges your iMessage account to OpenClaw via a server running on your Mac. Your agent can target recipients by phone number (E.164 format), email, or chat GUID. It supports both individual and group conversations, making it ideal for personal assistants that need to communicate on your behalf. The skill handles the full lifecycle of a message conversation -- from sending to reacting to editing to unsending.
For simpler iMessage needs like reading chat history and basic sends, you can also use the iMsg skill. BlueBubbles is the richer option with support for reactions, effects, and message editing. For other messaging platforms, see the Discord or Slack skills.
Example Prompts
Text +15551234567 "Running 10 minutes late, be there soon" via iMessage
React with a heart to the last message from Sarah in our group chat
Edit my last message to John to say "Meeting moved to 3pm" instead
Unsend the message I just sent to the wrong group chat
Send the photo at /tmp/receipt.jpg to my roommate with the caption "here's the receipt"
Reply to Mom's question about dinner with "I'll bring dessert!"
Send "Happy Birthday!" to Alex with the balloons effect
Remove my thumbs-up reaction from that message in the family group chat
Requirements
Gateway config: channels.bluebubbles (serverUrl, password, webhookPath)
- Platform: Requires a Mac running BlueBubbles server
- iMessage: Must be signed into an Apple ID with iMessage enabled
- Configuration: Set up
channels.bluebubblesin the OpenClaw gateway config
Setup on KiwiClaw
BlueBubbles requires a Mac with your iMessage account. On KiwiClaw, connect your BlueBubbles server URL and password in the KiwiClaw dashboard under channel settings. The gateway handles webhook routing automatically. Once configured, your agent can send and manage iMessages immediately.
Setup Self-Hosted
- Install and configure BlueBubbles server on your Mac
- Note your server URL and password from the BlueBubbles app
- Add to your OpenClaw gateway config:
channels.bluebubbles.serverUrlandchannels.bluebubbles.password - Configure the webhook path for incoming messages
- The skill will be automatically available once the channel is configured
Related Skills
- iMsg -- simpler iMessage CLI for basic send/read operations
- Discord -- send messages and manage Discord servers
- Slack -- post messages and manage Slack channels
- Voice Call -- make phone calls when messaging isn't enough
FAQ
What can the BlueBubbles skill do in OpenClaw?
The BlueBubbles skill lets your OpenClaw agent send iMessages, add tapback reactions, edit or unsend messages, reply in threads, send attachments with captions, send messages with effects like balloons, and manage group chat participants and names.
How is BlueBubbles different from the iMsg skill?
BlueBubbles is the recommended iMessage integration for OpenClaw. It provides richer functionality including tapback reactions, message editing, unsending, thread replies, effects, and group management. The iMsg skill is a simpler alternative for basic send/read operations.
Does BlueBubbles require a Mac?
Yes. BlueBubbles requires a Mac running the BlueBubbles server connected to your iMessage account. The server bridges iMessage to OpenClaw via webhooks and API calls. See the OpenClaw without Mac Mini guide for alternatives.
Is the BlueBubbles skill safe to use?
The BlueBubbles skill has been security-vetted by KiwiClaw. It communicates through the BlueBubbles gateway channel and only sends messages you explicitly request. All actions are logged and auditable.