iMessage Setup Guide

iMessage Setup (macOS Only)

OpenClaw supports iMessage on macOS via the BlueBubbles bridge. This requires a dedicated Mac running BlueBubbles server.

Requirements

• macOS 12 Monterey or later
• iMessage signed in and active
• BlueBubbles Server installed
• OpenClaw with Gateway Daemon running

Step 1: Install BlueBubbles

# Download from https://bluebubbles.app
# Install and sign in with your Apple ID

Step 2: Configure BlueBubbles in OpenClaw

{
  "channels": {
    "imessage": {
      "enabled": true,
      "blueBubblesUrl": "http://localhost:1234",
      "password": "your-bluebubbles-password"
    }
  }
}

Step 3: Test the Connection

openclaw test-channel imessage

• iMessage Troubleshooting
• BlueBubbles Guide