Help with Miracles and your OpenClaw connection

Yes, if your gateway is running and reachable over the connection you configured. We recommend Tailscale Serve for private setups; suitable public HTTPS or another VPN can also work. A LAN-only address does not automatically work away from home.

No. Tailscale Serve is our recommendation for personal setups. Miracles can also use a suitable public HTTPS/WSS endpoint, another VPN or your local network. Every route needs a reachable address, a valid TLS certificate and the right gateway authentication. The setup guide explains the requirements and limits of all four options.

First check that the gateway computer is running and its HTTPS/WSS address is reachable from iPhone. For Tailscale, check the connection, tailnet, access rules and Serve target. For public HTTPS, check the proxy/tunnel, TLS and WebSocket support; for another VPN or LAN, also check DNS, routing and firewall rules. A new setup code will not repair a broken network route.

If you see “Gateway is only bound to loopback”, the pairing dialogue may lack an address reachable from iPhone. Check your chosen HTTPS/WSS route and plugins.entries.device-pair.config.publicUrl against the installed documentation. Loopback can stay enabled with Tailscale Serve. Do not simply disable authentication or expose an unprotected gateway. Generate a new code after an address change.

For a setup code, choose “Setup code”, not “Tailscale identity”. Use a fresh, complete code from the correct gateway. For a token or password, choose the matching sign-in method instead. Match any pending device request to your current attempt and fingerprint, then approve it. Miracles keeps checking while open. After pausing, you can resume setup.

These depend on the model and gateway permissions. Miracles currently also needs operator.admin for these controls. Check this specific device’s access. Fast Mode may incur higher model-provider costs.

Text and reply references are stored in protected, gateway-specific files on this iPhone. Unconfirmed outgoing messages remain available for reconciliation and are not automatically sent again after interruption. Unsent file selections are not persistent draft attachments.

“Disconnect” pauses the app. “Reconnect gateway” uses the saved access. “Remove gateway” deletes this gateway’s credentials and device key from Keychain. It does not delete server conversations, the server’s device grant, local drafts or the saved outbox.

Check the connection and whether the gateway still provides the file. Previews are currently limited to 25 MB; sending uses the limits reported by your gateway. External HTTPS media providers may also be unavailable.

Miracles is now available free on the App Store for iPhone and iPad. You need iOS or iPadOS 26 or later and your own OpenClaw gateway.

Download free on the App Store ↗