Hermes BlueBubbles vs Claw Messenger: iMessage Setup Options

Short answer: use BlueBubbles if you already operate a Mac and want to own the Apple relay yourself. Use Claw Messenger if your Hermes agent runs on Linux, a VPS, or a managed server and you want iMessage, RCS, and SMS without maintaining BlueBubbles.

Where BlueBubbles fits in Hermes

BlueBubbles is a popular open-source bridge for reaching iMessage through a Mac. In a Hermes setup, the Mac runs Messages.app and BlueBubbles Server, then Hermes talks to that bridge from your agent environment.

That model can work well for hobby setups and teams that already maintain Apple hardware. It also means your messaging reliability depends on Mac uptime, macOS permissions, BlueBubbles credentials, webhooks, and network reachability between the Mac and Hermes.

Known Hermes BlueBubbles failure points

Hermes users evaluating BlueBubbles should pay close attention to the adapter and webhook path. The public Hermes issue tracker already shows several iMessage-specific failure modes:

• Issue #9263: webhook registration can fail with 400 Bad Request.
• Issue #9265: webhook dispatch can fail with 401 Unauthorized.
• Issue #8514: chatGuid can be null, which can break reply routing.

These are not reasons to avoid BlueBubbles in every case. They are reasons to budget for debugging if Hermes message delivery is part of a production workflow.

Where Claw Messenger fits in Hermes

Claw Messenger gives Hermes a managed messaging relay. Instead of running a Mac bridge, you install the hermes-imessage package, add a Claw Messenger API key, and enable the Hermes toolset.

Hermes can then send and receive iMessage, RCS, and SMS from the same server environment where the agent already runs. The package source is available at emotion-machine-org/hermes-imessage.

Comparison table

Choose BlueBubbles when

• You already have a Mac that can stay awake and online.
• You want messages to come from your Apple ID.
• You are comfortable maintaining Firebase, tunnels, and webhooks.
• You prefer free software over a managed messaging plan.

Choose Claw Messenger when

• Your Hermes agent runs on Linux, Docker, or a VPS.
• You need SMS or RCS alongside iMessage.
• You want a dedicated number for the agent instead of your personal Apple ID.
• You want to avoid Mac uptime, macOS permissions, and BlueBubbles maintenance.

Migration path from BlueBubbles

If you already run BlueBubbles, migrate deliberately so active threads do not surprise users. First, install hermes-imessage in a staging Hermes environment and verify a test conversation. Then decide which chats should move to the Claw Messenger number and keep the BlueBubbles bridge online until those users know the new route.

uv pip install --python ~/.hermes/hermes-agent/venv hermes-imessage
hermes tools enable hermes-claw-messenger
export CLAW_MESSENGER_API_KEY="cm_live_xxxxxxxxxxxxxxxx"
hermes gateway start

Recommendation

For a developer experimenting at home, BlueBubbles remains a useful option. For a Hermes agent that needs to run reliably on a server, Claw Messenger is the simpler path: fewer moving pieces, no Mac relay, and one package install for iMessage, RCS, and SMS.

Need the install steps first? Start with the Hermes iMessage setup guide.