Miracles: setup, features and help

Start with your own OpenClaw

Connect Miracles to the assistant you already use.

You need a reachable OpenClaw gateway, its secure address and access credentials. Miracles is the iPhone interface; it does not include a hosted assistant or create server agents.

Open the setup guide for the full steps and a copyable request your agent can help with. Put access codes only in the protected setup fields, never in support messages.

What is a gateway?

Your gateway connects the app to your agents, tools and history.

OpenClaw runs on a computer or server you control or arrange. Miracles connects to that gateway; the gateway supplies conversations, available agents and supported capabilities.

The gateway must remain reachable for new messages and live updates. Closing Miracles does not shut down your gateway. Hosting and model costs are separate from Miracles Pro.

What is an agent?

An assistant with its own setup and available tools.

Choose an available agent in the sidebar. Its instructions, permissions, tools and model options come from your OpenClaw setup. A new conversation starts a separate history, not a new server agent.

Find and organize conversations

Switch chats, search the list and keep your place.

Open the sidebar with the menu button or a deliberate rightward swipe from the left half of the chat. Choose an agent and conversation; search filters the conversation list. Returning to the sidebar preserves your reading position.

Conversation actions let you rename or customize a chat. With Pro, folders add organization without moving the conversation history away from your gateway.

Read without being pulled to the bottom

Scroll back while your assistant continues working.

New content arrives progressively. Scroll up to read earlier content; Miracles stops following the live end. Snap to Live returns to the current answer, while Snap to Latest returns to the newest content when no turn is active.

Expand tool groups to inspect published results. Use Older messages to load more history. Thinking can only show material your gateway publishes, never hidden internal reasoning.

Chat Orbit: progress & control

Stay close to the work without losing your reading position.

The movable Chat Orbit button brings together progress, pending decisions and available history. Open it right from the conversation.

Progress cards show work steps; live status shows the current activity and elapsed time. This is the state reported by your gateway, not a guaranteed completion time.

Adjust individual features in conversation settings. The events available to you depend on your gateway.

Inspect tool calls & results

Understand how an answer came together.

Expand a tool group, then open the call you want to inspect. Read the supplied inputs and results without leaving the conversation.

Supported content includes code, tables, expandable details and progress indicators. Copy code separately when you need it.

Published thinking is optional and stays separate from the final answer. It only shows explicitly shared content, not a model’s hidden reasoning.

Drafts and uncertain delivery

Your text can wait. A missing confirmation is not proof of failure.

Text drafts are kept per conversation on this iPhone, including across chat changes and app restarts. Unsent attachment selections are not part of the saved text draft.

Use a message menu to reply to a specific message. If the connection breaks after sending, reconnect and check the history before sending again. Miracles does not automatically repeat a message with uncertain delivery: a duplicate could repeat an action.

Models, thinking and speed

Available choices depend on your gateway and provider.

Conversation settings offer supported models and options. An agent is your configured assistant; a model is the AI it uses. Availability depends on gateway version, permissions and provider.

Higher thinking levels can take longer and cost more. Speed options do not guarantee lower latency or the same price for every model. Miracles Pro does not include AI credits.

Context and compaction

Long conversations may need a shorter working context.

Context is the material a model receives for its current answer. It is not necessarily the entire visible conversation history. Compaction condenses older material so work can continue within model limits.

Miracles displays compaction information supplied by the gateway. The gateway controls the process; a compaction indicator is not a promise that every earlier detail will remain in the model’s working context.

Photos, files and sharing

Choose what you send and where you share it.

Use the system picker to select photos or files. Sending transfers the selected content to your gateway, where configured models or tools may process it.

Open supported media in answers and use Share. To save an image, choose Save Image; iOS may request permission to add photos, not to browse your entire library. External HTTPS previews contact their hosting service, which may receive your IP address.

On supported gateways, your editable profile name and photo are saved on the gateway and also appear in OpenClaw.

Copy here, paste on your Mac

Miracles uses Apple’s native clipboard.

Copy text, code or a session key, then paste it on your Mac. Universal Clipboard requires nearby devices on the same Apple Account with Wi-Fi, Bluetooth and Handoff enabled.

If pasting fails, copy again and paste promptly. Miracles cannot force Apple’s clipboard handoff. Native text selection also lets you copy or share a selected passage.

Questions and approvals

Review what your assistant is asking before responding.

Supported gateways can send questions and requests to approve an action. Miracles shows the supplied choices in a focused view. Check the action, scope and any consequences before allowing it.

Opening a request is not approval. Some gateway-level requests may require the gateway’s own web interface. Available controls depend on the gateway.

Make Miracles feel like yours

Appearance and conversation options have separate controls.

In Settings → Appearance choose System, Light or Dark. System follows your iPhone; an explicit choice is remembered. Standard and Navy are separate theme choices.

Conversation appearance can be changed through its own actions. Changing a theme does not move or delete your gateway history.

When the connection drops

Reachability, authentication and device permission are different things.

Miracles connects over encrypted HTTPS/WSS. Tailscale is a recommended private route, not a requirement; a suitable public HTTPS address, another VPN or a local network can also work. A valid TLS certificate and gateway authentication remain required.

On return, Miracles reconnects and reconciles history. Connection quality shows connection measurements, not model intelligence or guaranteed response speed.

Disconnect pauses this app’s connection. Remove gateway deletes local access, not server conversations, local drafts or the saved outbox. Revoke the device grant separately on your gateway for full revocation.

Where does my data go?

Your chosen gateway and providers process the content you send.

Miracles is not a separate cloud archive of all your conversations. Local app data, Keychain access credentials, gateway history and optional iCloud organization have different storage and deletion rules.

Read Data & Privacy for the full details, including external media, voice services and local files. Help search runs on your device: queries are not sent to a server or saved as a search history.

What does Pro include?

Extra tools for conversation, organization and comfort.

Pro includes Pulse, Weekly Allowance display, Live Activity, Background Activity, Smart Titles, Chat Folders, iCloud Sync and Keyboard Comfort. You can read every feature explanation without Pro. Device, gateway and provider requirements still apply.

A verified subscription, eligible trial or one-time purchase grants the same Pro features. Gateway hosting, AI credits and voice-provider usage are not included. Use Free & Pro to compare the included app features.

Manage or cancel a subscription

Apple manages billing, renewal and cancellation.

Open Pro options, then Manage subscriptions to review or cancel with Apple. The App Store shows your price and any eligible trial before confirmation. A trial begins only after you confirm and renews as the displayed paid subscription unless cancelled in time.

Restore purchases checks purchases associated with your Apple Account. A one-time purchase does not cancel an existing subscription; manage that separately. Expiry or refund can remove access, but saved preferences and folders are retained.

Talk with Miracles Pulse

A voice conversation with your agent, with its own setup.

Pulse is a Pro voice feature. Its setup explains the available modes, microphone permission, provider requirements and costs. Availability depends on your device, gateway and chosen service; Pro does not pay your voice-provider bill.

Choose and review the mode before activating a call. Voice handling and data flow differ by mode. The feature’s setup and privacy explanations are available before subscribing.

This version supports OpenAI voice services only: GPT Live through a supported ChatGPT connection in OpenClaw or a supported OpenAI API voice connection. Microphone audio goes directly to OpenAI. Availability can depend on region, account and allowance; other voice providers are not supported.

See your provider’s allowance

An overview of reported limits, not extra AI credits.

Enable Weekly Allowance in Pro Features. When supported provider data is available, the sidebar shows its allowance and reset information; tap the bar for details.

Windows and limits come from the provider and may differ. Missing or stale data is not a promise of unlimited usage. Miracles Pro does not increase your provider allowance.

Status on your Lock Screen

Live Activity keeps supported call and chat status visible.

Enable Live Activity in Pro Features to show supported status on the Lock Screen and Dynamic Island. Device support, iOS permissions and the current activity determine what appears.

A Live Activity is a status surface, not a guarantee of a permanently running background connection.

Why can updates pause in the background?

iOS decides how much background time an app receives.

Pro Background Activity can briefly continue receiving an answer and refresh later when iOS allows it. It is not an always-on connection or a promise of updates at an exact time.

Return to Miracles to reconnect and reconcile history. Your gateway may continue work independently while the iPhone app is suspended.

Give new chats useful titles

A concise topic is easier to find than a first sentence.

Smart Titles can name new text conversations after the first substantive contribution. Greetings wait for content. Automatic naming makes one attempt; a failed attempt is not retried after each later message. Existing conversations are not renamed retroactively and your own names take precedence.

Pro defaults to on-device Apple Intelligence where available. The settings explain requirements and the optional Gateway alternative. While a title is generated, chat continues; if it fails, the ordinary title stays.

Auto rename explicitly requests a different suggestion. If Apple Intelligence cannot produce a suitable new title, a short conversation excerpt is used. Uncertain saves or concurrent name changes are not blindly overwritten.

Organize chats into folders

Folders group conversations without deleting or duplicating their history.

Requires Pro and Chat Folders enabled.

In the sidebar, tap ⋯ next to the chat-list heading, then New folder.

To move one or more chats: tap ⋯ → Select chats, select the chats, then Move selected chats and choose a folder.

Deleting a folder does not delete its chats. Choose No folder in the move picker to remove a chat from a folder.

Folders belong to the current gateway workspace and agent. Local organization works without iCloud; sync is a separate choice.

Bring organization to another device

Optional sync complements your gateway connection; it does not replace it.

Enable iCloud Sync separately in Pro Features. On a new device, first pair your gateway. If restored organization is not yet linked, select the matching workspace for this gateway and profile in folder settings.

Sync status shows the last confirmed reconciliation, not an instant-delivery promise. Folder and supported preference sync do not turn iCloud into a backup of the complete gateway conversation history. Check the available sync choices and privacy details before enabling them.

Close the keyboard after sending

Keep more of the answer visible after a successful send.

Enable Keyboard Comfort in Pro Features to dismiss the keyboard after a successful send. It does not clear your draft or confirm an uncertain delivery. Saved choices remain yours when Pro access changes.