Cluster Support

Cluster connects to your own Hermes, Odysseus, or OpenClaw gateway. If you need help, email rodolfo.arg.ce@gmail.com.

Connect a Gateway

1. Install the gateway software on the Mac or server you want Cluster to use.
2. Configure it per the gateway's own documentation, then start it — for Hermes, run hermes gateway run in the foreground, or if installed as a background service use hermes gateway start.
3. Copy the API key, bearer token, or bootstrap token from your gateway installation.
4. Open Cluster and tap Connect Gateway or go to Settings > Gateway.
5. Choose your provider type (Hermes, Odysseus, OpenClaw), enter the host URL, path, and authentication token, then save the connection.

Recommended Private Access

For iPhone access outside the gateway host, use a private network such as Tailscale and expose the gateway under a path prefix such as /hermes.

Odysseus and OpenClaw

Advanced users can also connect Odysseus with an API bearer token or OpenClaw with a bootstrap token. Use the provider's gateway URL, matching path prefix, and TLS setting from your own installation. The token must match exactly what the gateway host expects.

Attachments

Cluster can attach images from your photo library. Images are supported across all gateway providers. PDF and text-file attachments are sent only when the gateway supports file uploads — currently this means an Odysseus gateway using the upload-backed attachment provider.

Troubleshooting

• Make sure the gateway is running and reachable from the device — for Hermes, check with hermes gateway status, or confirm your foreground hermes gateway run process is active.
• Check that the token saved in Cluster matches the token on the gateway host — a mismatch is the most common connection failure.
• Verify the host URL, path prefix, and port. If the gateway listens on a non-default port, include it in the URL.
• If you use a reverse proxy, confirm the path prefix and TLS settings in the connection's Advanced section.
• If the app shows "Connect Gateway" again after a successful connection, the saved connection profile may be incomplete — delete the profile and re-enter the details.