iOS ऐप

​

यह क्या करता है

• WebSocket (LAN या tailnet) पर Gateway से कनेक्ट करता है।
• नोड क्षमताएं उजागर करता है: Canvas, Screen snapshot, Camera capture, Location, Talk mode, Voice wake।
• node.invoke कमांड प्राप्त करता है और नोड स्थिति इवेंट रिपोर्ट करता है।

​

आवश्यकताएं

• किसी अन्य डिवाइस (macOS, Linux, या WSL2 के माध्यम से Windows) पर चल रहा Gateway।
• नेटवर्क पथ:
  • Bonjour के माध्यम से वही LAN, या
  • unicast DNS-SD के माध्यम से tailnet (उदाहरण डोमेन: openclaw.internal.), या
  • मैन्युअल होस्ट/पोर्ट (fallback).

​

त्वरित शुरुआत (पेयर + कनेक्ट)

1. Gateway शुरू करें:

openclaw gateway --port 18789

2. iOS ऐप में, Settings खोलें और खोजे गए Gateway को चुनें (या Manual Host सक्षम करें और होस्ट/पोर्ट दर्ज करें)।
3. Gateway होस्ट पर पेयरिंग अनुरोध स्वीकृत करें:

openclaw devices list
openclaw devices approve <requestId>

{
  gateway: {
    nodes: {
      pairing: {
        autoApproveCidrs: ["192.168.1.0/24"],
      },
    },
  },
}

4. कनेक्शन सत्यापित करें:

openclaw nodes status
openclaw gateway call node.list --params "{}"

​

आधिकारिक बिल्ड के लिए relay-backed push

{
  gateway: {
    push: {
      apns: {
        relay: {
          baseUrl: "https://relay.example.com",
        },
      },
    },
  },
}

• iOS ऐप App Attest और StoreKit app transaction JWS का उपयोग करके relay के साथ पंजीकरण करता है।
• relay एक opaque relay handle और registration-scoped send grant लौटाता है।
• iOS ऐप paired Gateway identity fetch करता है और उसे relay registration में शामिल करता है, ताकि relay-backed registration उसी विशिष्ट Gateway को delegated हो।
• ऐप उस relay-backed registration को push.apns.register के साथ paired Gateway को forward करता है।
• Gateway उस stored relay handle का उपयोग push.test, background wakes, और wake nudges के लिए करता है।
• Custom Gateway relay URLs का iOS build में baked relay URL से मेल खाना आवश्यक है।
• यदि ऐप बाद में किसी अलग Gateway या अलग relay base URL वाले build से कनेक्ट करता है, तो वह पुराने binding को reuse करने के बजाय relay registration refresh करता है।

• कोई deployment-wide relay token नहीं।
• आधिकारिक/TestFlight relay-backed sends के लिए कोई direct APNs key नहीं।

1. आधिकारिक/TestFlight iOS build इंस्टॉल करें।
2. वैकल्पिक: Gateway पर gateway.push.apns.relay.baseUrl केवल तब सेट करें जब जानबूझकर अलग custom relay build का उपयोग कर रहे हों।
3. ऐप को Gateway से pair करें और उसे connecting पूरा करने दें।
4. APNs token मिलने, operator session connected होने, और relay registration सफल होने के बाद ऐप अपने-आप push.apns.register प्रकाशित करता है।
5. इसके बाद, push.test, reconnect wakes, और wake nudges stored relay-backed registration का उपयोग कर सकते हैं।

​

Background alive beacons

• OPENCLAW_APNS_RELAY_BASE_URL अब भी Gateway के लिए temporary env override के रूप में काम करता है।
• सार्वजनिक App Store release lane iOS builds के लिए OPENCLAW_PUSH_RELAY_BASE_URL को reject करता है।

​

Authentication और trust flow

• Apple के माध्यम से वितरित genuine OpenClaw iOS builds ही hosted relay का उपयोग कर सकते हैं।
• Gateway relay-backed pushes केवल उन iOS devices के लिए भेज सकता है जिन्होंने उसी विशिष्ट Gateway के साथ pair किया हो।

1. iOS app -> gateway
   • ऐप पहले सामान्य Gateway auth flow के माध्यम से Gateway के साथ pair करता है।
   • इससे ऐप को authenticated node session और authenticated operator session मिलता है।
   • operator session का उपयोग gateway.identity.get कॉल करने के लिए किया जाता है।
2. iOS app -> relay
   • ऐप HTTPS पर relay registration endpoints कॉल करता है।
   • Registration में App Attest proof और StoreKit app transaction JWS शामिल होता है।
   • relay bundle ID, App Attest proof, और Apple distribution proof validate करता है, और official/production distribution path की आवश्यकता रखता है।
   • यही local Xcode/dev builds को hosted relay का उपयोग करने से रोकता है। local build signed हो सकता है, लेकिन वह relay द्वारा अपेक्षित official Apple distribution proof को satisfy नहीं करता।
3. gateway identity delegation
   • relay registration से पहले, ऐप paired Gateway identity को gateway.identity.get से fetch करता है।
   • ऐप उस Gateway identity को relay registration payload में शामिल करता है।
   • relay एक relay handle और registration-scoped send grant लौटाता है, जो उस Gateway identity को delegated होते हैं।
4. gateway -> relay
   • Gateway push.apns.register से relay handle और send grant store करता है।
   • push.test, reconnect wakes, और wake nudges पर, Gateway अपने device identity के साथ send request sign करता है।
   • relay stored send grant और Gateway signature, दोनों को registration से delegated Gateway identity के विरुद्ध verify करता है।
   • कोई दूसरा Gateway उस stored registration को reuse नहीं कर सकता, भले ही वह किसी तरह handle प्राप्त कर ले।
5. relay -> APNs
   • relay official build के लिए production APNs credentials और raw APNs token own करता है।
   • relay-backed official builds के लिए Gateway raw APNs token कभी store नहीं करता।
   • relay paired Gateway की ओर से अंतिम push APNs को भेजता है।

• production APNs credentials को user Gateways से बाहर रखने के लिए।
• Gateway पर raw official-build APNs tokens store करने से बचने के लिए।
• hosted relay usage को केवल official/TestFlight OpenClaw builds के लिए अनुमति देने के लिए।
• एक Gateway को किसी अलग Gateway के स्वामित्व वाले iOS devices को wake pushes भेजने से रोकने के लिए।

export OPENCLAW_APNS_TEAM_ID="TEAMID"
export OPENCLAW_APNS_KEY_ID="KEYID"
export OPENCLAW_APNS_PRIVATE_KEY_P8="$(cat /path/to/AuthKey_KEYID.p8)"

mkdir -p ~/.openclaw/credentials/apns
chmod 700 ~/.openclaw/credentials/apns
mv /path/to/AuthKey_KEYID.p8 ~/.openclaw/credentials/apns/AuthKey_KEYID.p8
chmod 600 ~/.openclaw/credentials/apns/AuthKey_KEYID.p8
export OPENCLAW_APNS_PRIVATE_KEY_PATH="$HOME/.openclaw/credentials/apns/AuthKey_KEYID.p8"

​

Discovery paths

​

Bonjour (LAN)

​

Tailnet (cross-network)

​

Manual host/port

​

Canvas + A2UI

openclaw nodes invoke --node "iOS Node" --command canvas.navigate --params '{"url":"http://<gateway-host>:18789/__openclaw__/canvas/"}'

• Gateway canvas host /__openclaw__/canvas/ और /__openclaw__/a2ui/ serve करता है।
• यह Gateway HTTP server से serve होता है (gateway.port जैसा ही port, default 18789)।
• iOS node built-in scaffold को connected default view के रूप में रखता है। canvas.a2ui.push और canvas.a2ui.reset bundled app-owned A2UI page का उपयोग करते हैं।
• Remote Gateway A2UI pages iOS पर render-only हैं; native A2UI button actions केवल bundled app-owned pages से स्वीकार किए जाते हैं।
• canvas.navigate और {"url":""} के साथ built-in scaffold पर वापस जाएं।

​

Computer Use संबंध

​

Canvas eval / snapshot

openclaw nodes invoke --node "iOS Node" --command canvas.eval --params '{"javaScript":"(() => { const {ctx} = window.__openclaw; ctx.clearRect(0,0,innerWidth,innerHeight); ctx.lineWidth=6; ctx.strokeStyle=\"#ff2d55\"; ctx.beginPath(); ctx.moveTo(40,40); ctx.lineTo(innerWidth-40, innerHeight-40); ctx.stroke(); return \"ok\"; })()"}'

openclaw nodes invoke --node "iOS Node" --command canvas.snapshot --params '{"maxWidth":900,"format":"jpeg"}'

​

Voice wake + talk mode

• Voice wake और talk mode Settings में उपलब्ध हैं।
• Talk-capable iOS nodes talk capability advertise करते हैं और talk.ptt.start, talk.ptt.stop, talk.ptt.cancel, और talk.ptt.once declare कर सकते हैं; Gateway trusted Talk-capable nodes के लिए उन push-to-talk commands को default रूप से allow करता है।
• iOS background audio suspend कर सकता है; ऐप active न होने पर voice features को best-effort मानें।

​

Common errors

• NODE_BACKGROUND_UNAVAILABLE: iOS ऐप को foreground में लाएं (canvas/camera/screen commands को इसकी आवश्यकता होती है)।
• A2UI_HOST_UNAVAILABLE: bundled A2UI page ऐप WebView में reachable नहीं था; ऐप को Screen tab पर foregrounded रखें और retry करें।
• Pairing prompt कभी नहीं दिखता: openclaw devices list चलाएं और manually approve करें।
• Reinstall के बाद reconnect fail होता है: Keychain pairing token clear हो गया था; node को फिर से pair करें।

​

Related docs

• Pairing
• Discovery
• Bonjour