iMessage Troubleshooting

iMessage Troubleshooting

BlueBubbles Not Running

Ensure BlueBubbles Server is running and accessible at the configured URL. Check System Tray for the BlueBubbles icon.

Apple ID Verification Needed

macOS occasionally requires iMessage re-authentication. Go to Messages app → Preferences → iMessage and sign in again.

Permissions Not Granted

BlueBubbles requires Full Disk Access and Contacts permissions:

1. System Preferences → Privacy & Security → Full Disk Access
2. Add BlueBubbles to the list
3. Restart BlueBubbles

Port 1234 Blocked

If running BlueBubbles on a different port, update your OpenClaw config accordingly.

• iMessage Setup Guide
• BlueBubbles Guide