Setup & Installation
Or with the ClawHub CLI, for registry-managed skill folders outside a full OpenClaw workspace:
What This Skill Does
A Clawdbot extension package that connects the bot to a self-hosted BlueBubbles server for sending and receiving iMessages. Covers REST message delivery, webhook ingestion, tapback reactions, typing indicators, read receipts, and attachment handling.
Lets Clawdbot participate in iMessage threads without native Apple infrastructure by delegating to a user-controlled BlueBubbles server.
When to use it
- Routing iMessage conversations into a Clawdbot reply pipeline
- Sending automated text replies to iMessages via a Mac-hosted BlueBubbles server
- Forwarding inbound iMessage attachments and stickers to the bot for processing
- Sending tapback reactions to specific iMessages by phone number and message ID
- Health-checking a BlueBubbles server before enabling the channel
Example Workflow
Here's how your AI assistant might use this skill in practice.
User sends an iMessage with a photo to a number handled by the bot
- 1BlueBubbles posts a webhook JSON payload to the registered webhookPath on the gateway
- 2monitor.ts normalizes sender and chat IDs from the payload
- 3Attachment is downloaded via downloadBlueBubblesAttachment and referenced as a <media:...> placeholder
- 4Inbound context is routed into the core reply pipeline through the plugin runtime
- 5Bot processes the message and calls sendMessageBlueBubbles to deliver a reply
Bot reply is delivered to the iMessage thread via the BlueBubbles REST API
Requirements
Accounts, API keys, or tools you or your AI assistant may need to set up while using this skill.