Using OpenClaw with iMessage

iMessage Integration

OpenClaw can respond on iMessage through the BlueBubbles bridge — making it the only open-source AI assistant that works natively with Apple's messaging platform.

Requirements

• macOS (iMessage integration is macOS-only)
• An Apple ID signed into Messages
• BlueBubbles server running on your Mac
• OpenClaw installed and configured

What Is BlueBubbles?

BlueBubbles is an open-source server that provides API access to iMessage on macOS. OpenClaw connects to BlueBubbles to send and receive iMessages.

Setup Steps

Step 1: Install BlueBubbles

Download BlueBubbles from their official website and install it on your Mac. Follow their setup guide to:

• Grant necessary permissions (Accessibility, Full Disk Access)
• Configure the BlueBubbles server
• Note the server URL and password

Step 2: Configure OpenClaw

Add BlueBubbles configuration to OpenClaw:

{
  "channels": {
    "imessage": {
      "enabled": true,
      "bluebubbles_url": "http://localhost:1234",
      "bluebubbles_password": "YOUR_PASSWORD"
    }
  }
}

Step 3: Test the Connection

Send an iMessage to the Apple ID signed into your Mac. OpenClaw should receive it and respond through iMessage.

Features

• Blue bubbles — Responses appear as iMessages, not SMS
• Group chats — Works in iMessage group conversations
• Tapbacks — Receives and can reference reactions
• Rich content — Supports images and links in responses

Limitations

• macOS only — iMessage requires a Mac running BlueBubbles
• The Mac must be powered on and connected to the internet
• Some iMessage features (Memoji, effects) aren't supported

Tips

• Keep your Mac in a stable location with reliable internet
• Consider a Mac Mini as a dedicated iMessage server
• BlueBubbles can run alongside other apps without issues