OpenClaw iPhone Setup: Share Extension, Talk Mode & Watch App in One Guide

OpenClaw on iPhone: A Full Setup in 2026

OpenClaw's iOS support has expanded dramatically in recent releases. What started as a simple node pairing app now includes a Share Extension, background Talk Mode, Apple Watch companion, APNs wake for instant push delivery, and QR-based onboarding. This guide covers how all these pieces fit together and what you need to set up each one.

The iOS Architecture: Node vs. Gateway

Before diving in, it's worth understanding how iOS fits into OpenClaw:

• Your main OpenClaw gateway runs on a server, VPS, or Mac — this is the "brain" that connects to Telegram, Discord, Slack, etc., and runs your cron jobs and agents
• The iOS app is a node — it pairs with your gateway and becomes a delivery target. When your gateway wants to push something to your iPhone (or Watch), it sends via APNs to the iOS node

Think of the gateway as the server and your iPhone as a connected client — but a client that can also send messages back, trigger actions, and run Talk Mode locally.

Step 1: QR Onboarding

v2026.2.17 added a QR-first onboarding wizard. Instead of manually entering your gateway URL and token, you:

1. Open the iOS app for the first time → you see a QR scanner
2. On your gateway machine, run: openclaw devices qr
3. Scan the QR code with your iPhone
4. Pairing completes automatically

The QR encodes a setup-code deep link that handles the full pairing handshake. No manual URL entry required.

Troubleshooting: If you hit a "pairing required" deadlock (the iPhone shows paired but the gateway doesn't), v2026.2.20 added a local fallback: openclaw devices --local-fallback recovers the pairing via loopback without needing the iOS app to be online.

Step 2: APNs Configuration

APNs (Apple Push Notification Service) is what lets your gateway wake up and deliver content to your iPhone even when the app is backgrounded. Setting it up requires:

1. An Apple Developer account ($99/year)
2. Creating an APNs key in your developer portal
3. Configuring the APNs credentials in your OpenClaw gateway
4. The gateway then uses the push token from your iPhone to send delivery events

v2026.2.19 added BGAppRefresh wake fallback and location-wake hook throttling — so even if an APNs push is delayed, your iPhone node reconnects reliably in the background.

Step 3: Setting Up the Share Extension

The Share Extension (added in v2026.2.17) appears in your iPhone's system share sheet alongside AirDrop, Messages, and other apps. Once installed:

• Browse a webpage in Safari → tap share → select OpenClaw → the URL goes directly to your agent
• Read an article in a news app → share to OpenClaw → your agent gets the article content
• Take a photo → share to OpenClaw → your agent receives the image for analysis

The Share Extension routes to your gateway's agent.request endpoint with delivery-route fallback — if the gateway is temporarily unreachable, the share is queued and delivered when the connection resumes.

Step 4: Talk Mode Configuration

Talk Mode turns your iPhone into a hands-free voice interface for OpenClaw. Recent improvements (v2026.2.17):

• Background Listening toggle — Keep Talk Mode active with the app backgrounded (off by default, enable for always-on use)
• Voice Directive Hint toggle — Disable ElevenLabs voice-switching instructions if you don't need multi-voice output (saves tokens)
• Barge-in hardening — False interruptions from local TTS bleed-through are now blocked when the output route is the built-in speaker/receiver

Configure Talk Mode in the iOS app under Settings → Talk Mode. To use background listening for a wake-word style experience:

1. Enable Background Listening in app settings
2. Enable Background App Refresh for OpenClaw in iOS Settings
3. Set a wake phrase in your OpenClaw config

Step 5: Apple Watch Companion

The Apple Watch app (v2026.2.19) pairs automatically once your iOS app is connected. Once paired, your Watch shows:

• Inbox UI with recent messages from your agent
• Push notifications relayed from the gateway via APNs
• Quick-reply capability via voice dictation
• Agent status (what session is active, what's running)

No additional pairing steps — if your iPhone is paired with your gateway and your Watch is paired with your iPhone, the companion works.

Step 6: Delivery Routing

Once your iPhone is paired, configure it as a delivery target in your gateway:

channels:
  telegram:
    defaultTo: "@yourtelegramhandle"  # For Telegram delivery

# For iOS-specific delivery (e.g., cron jobs direct to iPhone)
cron:
  deliver: ios  # Deliver cron output to iOS node by default

With the defaultTo option added in v2026.2.20, you can set iOS (and by extension, Watch) as the default delivery target without specifying it on every cron job.

The Complexity Involved

Getting all five of these working correctly requires:

• Apple Developer account and APNs certificate management
• Building or sideloading the iOS app (it's not on the App Store yet)
• Correct gateway config for APNs credentials
• Tailscale or equivalent for secure remote gateway access from your iPhone
• Proper delivery routing config for iOS-specific channels
• iOS signing configuration for local builds

This is one of the more involved OpenClaw setup paths. We cover it as part of our Native App Setup add-on service.