Connect iMessage

Table of contents

1. Choose Method
2. BlueBubbles Setup
3. AppleScript Setup (Legacy)
4. Login Command
5. Send First Message
6. Next Steps
7. FAQ

Choose Method

BlueBubbles (recommended): Stable, supports media, works on non-Mac clients.

AppleScript (legacy): Built-in, no extra software, but limited and fragile.

BlueBubbles Setup

1. Install BlueBubbles on your Mac from bluebubbles.app
2. Open BlueBubbles and go to Settings > Server
3. Enable “Private API” and “Remote Access”
4. Note the server URL (e.g., http://192.168.1.10:8080)
5. Generate an API key in Settings > API

AppleScript Setup (Legacy)

No setup needed, but ensure:

• macOS is unlocked
• Messages app is running
• Accessibility permissions are granted to Terminal/PowerShell

Login Command

BlueBubbles

openclaw channels login imessage --url BB_URL --key BB_KEY

Replace BB_URL and BB_KEY with your BlueBubbles server URL and API key.

AppleScript

openclaw channels login imessage --method applescript

Send First Message

Send a test iMessage to your bot to verify the connection.

Next Steps

• Getting Started Overview
• Allowlists and Sender Policies
• Daily Brief Workflow
• iMessage Setup Guide
• iMessage Troubleshooting

FAQ

Q: Does iMessage work on non-Mac devices?
A: Only via BlueBubbles server running on a Mac.

Q: Can I send media via AppleScript?
A: No. Use BlueBubbles for media support.

Q: What if AppleScript fails?
A: Ensure Messages app is running and Terminal has Accessibility permissions.

Q: Is BlueBubbles secure?
A: Yes, if you use HTTPS and a strong API key. Keep the server on your local network.

Q: How do I disconnect?
A: Run openclaw channels logout imessage.

Recommended next

Connect Microsoft Teams