OpenClaw on iOS: The Mobile AI Agent Setup That Actually Works

Your iPhone is already the most personal computing device you own. OpenClaw on iOS makes it the interface for every AI agent you run — not just a chat window, but a full interaction layer with native notifications, voice, automation, and the ability to share any content from any app directly to your agents. This is what mobile AI should have been from the start.

Architecture: How iOS and OpenClaw Work Together

Understanding the architecture saves you hours of confusion later. The iPhone is not running the AI model. Your OpenClaw server is. The iOS companion app is the front-end: it sends messages to your server, displays responses, and handles the platform-specific features like push notifications and Shortcuts.

This means your server needs to be accessible over the internet — either a cloud deployment or a home server with a public URL. A local-only server works on the same Wi-Fi network but breaks the moment you leave the house. For production use, deploy OpenClaw on a cloud host and use a stable domain name.

The push notification flow works like this: when your OpenClaw agent completes a task or receives a message, the server sends a payload to Apple's APNs servers. APNs delivers it to your device. The app receives it and displays the notification — all without the app being active. This is what makes asynchronous agent tasks actually useful on mobile.

Companion App Setup

Download the OpenClaw companion app from the App Store. On first launch, you're prompted to connect to your OpenClaw instance. Enter your server URL and API key.

1. Open the app and tap "Connect to Instance."
2. Enter your OpenClaw server URL (e.g., https://agents.yourdomain.com).
3. Enter your API key from your OpenClaw dashboard. This authenticates the device.
4. Tap "Connect." The app verifies the connection and fetches your agent list.
5. Select your default agent — the one the app uses for direct chat messages.

Once connected, your configured agents appear as selectable conversation threads. Swipe between them just like switching conversations in Messages. Each thread maintains its own history and context.

Push Notifications via APNs

Push notifications are what separate useful mobile AI from a glorified web page. Without them, you'd have to open the app and check for responses manually. With APNs, your agent can work in the background and notify you the moment it finishes.

Enable push notifications when prompted on first launch. iOS asks for permission — tap "Allow." Then in OpenClaw's server config, add your APNs certificate credentials:

// openclaw.config.js — iOS push notifications
module.exports = {
  notifications: {
    apns: {
      enabled: true,
      keyId: process.env.APNS_KEY_ID,
      teamId: process.env.APNS_TEAM_ID,
      keyPath: './credentials/apns-key.p8',
      bundleId: 'com.openclaw.companion',
      production: true   // false for development/TestFlight
    }
  }
};

You get the APNs key from your Apple Developer account under Certificates → Keys. Create a new key with the Apple Push Notifications service (APNs) capability enabled. Download the .p8 file — you can only download it once, so store it securely.

Apple Shortcuts Integration

This is where OpenClaw on iOS becomes genuinely powerful. The Shortcuts integration exposes every configured agent as an iOS action. You can invoke any agent from a Shortcut triggered by a widget tap, a voice command via Siri, an NFC tag, a Focus mode change — anything that can trigger a Shortcut.

Voice Input and Share Extension

Two features make OpenClaw genuinely hands-free on iOS: voice input and the Share Sheet extension.

Voice input uses Apple's on-device speech recognition. Tap the microphone icon in the chat interface and speak your prompt. Transcription is instant and works offline. For voice output, enable text-to-speech in Settings → OpenClaw → Agent Responses → Read Aloud. The agent's reply is read back using iOS system voices.

The Share Sheet extension is the feature power users discover and never give up. In Safari, highlight text on any page and tap Share → OpenClaw. A prompt sheet slides up — add context if you want, or just tap Send. The content plus your prompt goes directly to your configured agent. Same flow works in Notes, Mail, PDF readers, and any app that supports the iOS Share Sheet.

Common Mistakes

• Using HTTP instead of HTTPS for the server URL. iOS blocks non-HTTPS connections by default (App Transport Security). The companion app will fail to connect silently. Always use a valid HTTPS certificate.
• Setting production: true in APNs config during development. Development builds (including TestFlight) use the APNs sandbox environment. Set production: false until you're in a production App Store build. Wrong environment means push notifications silently fail.
• Not enabling biometric lock. An unlocked OpenClaw app on a found or stolen device gives full access to your agents. Enable Face ID lock from day one — it takes 10 seconds and protects everything.
• Forgetting to configure the default agent. The Shortcuts "Send to Agent" action uses your default agent if no specific agent is named. If you haven't set a default, the action fails with a silent error. Set it in app Settings → Default Agent.
• Expecting agent responses without an internet connection. The iOS app requires connectivity to reach your OpenClaw server. Offline mode shows cached conversation history but cannot send new messages or receive agent responses.

Optimising for Daily Use

The setups that actually stick are the ones woven into existing habits. Don't create a new workflow — replace an existing one. If you already dictate notes, replace the Notes app with an OpenClaw voice prompt to your writing agent. If you already copy text to summarise later, replace that with the Share Sheet extension.

The most powerful daily setup we've seen: a morning Shortcut triggered by the "Arrive at Work" Focus mode that queries a briefing agent and reads the response aloud via text-to-speech during commute. Zero screen time, full briefing. As of early 2025, this approach still works because Shortcuts Focus mode triggers remain reliable on iOS 16 and 17.

Frequently Asked Questions

Does OpenClaw have a native iOS app?

OpenClaw provides an iOS companion app that connects to your self-hosted or cloud OpenClaw instance. The app handles authentication, push notification delivery, and a native chat interface. Your agents run server-side — the iOS app is the interaction layer.

Can OpenClaw agents run entirely on iPhone without a server?

No. The iOS app connects to a running OpenClaw server — either your own hosted instance or an OpenClaw cloud workspace. The heavy AI inference runs server-side. The iPhone handles the UI and push notifications, not the model calls.

How do push notifications work with OpenClaw on iOS?

OpenClaw uses Apple Push Notification service (APNs) to deliver agent replies. When your agent completes a task or receives a message requiring your attention, APNs delivers a notification immediately — even when the app is backgrounded or closed.

Can I trigger OpenClaw agents from Apple Shortcuts?

Yes. The OpenClaw iOS app exposes Shortcuts actions for sending prompts, querying agents, and retrieving results. Build an automation in the Shortcuts app that sends a text prompt to a named agent and returns the response to any downstream action.

Does OpenClaw on iOS support voice input?

The iOS app uses Apple's native speech recognition for voice-to-text input. Speak your prompt and OpenClaw transcribes and sends it to your agent. For voice output, enable text-to-speech in the app settings and agent replies are read aloud.

What iOS version does OpenClaw require?

OpenClaw's iOS companion app requires iOS 16.0 or later. Features like Live Activities and interactive notifications require iOS 16.1+. Apple Shortcuts integration requires iOS 16 with the Shortcuts app installed (included by default on all modern iPhones).

How do I share content from other iOS apps to OpenClaw?

OpenClaw registers as a share extension on iOS. Use the Share Sheet in Safari, Notes, Mail, or any app that supports sharing. Select OpenClaw from the share options, add a prompt if needed, and the content is sent directly to your configured agent.