bluebubbles

BlueBubbles runs a self-hosted server on a Mac that remains signed into your Apple ID, exposing an HTTP API and webhook for iMessage. OpenClaw's BlueBubbles skill routes every action through that gateway:You (or your agent) invoke the message tool with channel: "bluebubbles" and an action payload.The skill translates the action — send, react, reply, edit, unsend, sendAttachment, or sendWithEffect — into the corresponding BlueBubbles API call.BlueBubbles delivers the message through the native macOS Messages app on your server machine and returns status back to the agent.Targets can be specified as a chat_guid (preferred, especially for group chats), an E.164 phone number like +15551234567, or an email address.

Send Messages — Deliver text messages to any iMessage contact by phone number, email, or chat GUID.Tapback Reactions — React to or remove reactions from specific messages using emoji tapbacks (❤️, 👍, etc.).Edit & Unsend — Modify previously sent messages or retract them entirely (macOS version dependent).Threaded Replies — Reply directly to a specific message within a conversation thread.Attachment Sending — Share local files by path or base64 buffer with an optional caption.iMessage Effects — Send messages with native iMessage screen effects like balloons, confetti, and more.Group Chat Support — Target group conversations reliably via chat_guid identifiers.

BlueBubbles Gateway Config — Required. A running BlueBubbles server on a Mac with your Apple ID signed in. Configure channels.bluebubbles in OpenClaw with your server URL, password, and webhook path. Self-hosted; no third-party API key needed.

Personal Assistant Messaging — Ask your agent to "text Mom that I'll be 10 minutes late" and have it send the iMessage on your behalf.Automated Notifications — Trigger iMessage alerts when workflows complete, errors occur, or events fire — without touching your phone.Conversational Thread Management — Reply in-thread to specific messages, keeping group chat discussions organized and contextually accurate.Rich Media Sharing — Have your agent send generated images, PDFs, or other files directly to iMessage contacts with a descriptive caption.