iOS ऐप

उपलब्धता: किसी रिलीज़ के लिए सक्षम होने पर iPhone ऐप बिल्ड Apple चैनलों के माध्यम से वितरित किए जाते हैं। स्थानीय डेवलपमेंट बिल्ड स्रोत से भी चलाए जा सकते हैं।

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

WebSocket (LAN या tailnet) के माध्यम से Gateway से कनेक्ट करता है।
Node क्षमताएँ उपलब्ध कराता है: Canvas, स्क्रीन स्नैपशॉट, कैमरा कैप्चर, स्थान, Talk मोड, वॉइस वेक और ऑप्ट-इन स्वास्थ्य सारांश।
node.invoke कमांड प्राप्त करता है और Node स्थिति ईवेंट की रिपोर्ट करता है।
Agents सतह (Files) से चयनित एजेंट के वर्कस्पेस को केवल पढ़ने के लिए ब्राउज़ करता है: डायरेक्टरी में ड्रिल-डाउन, सिंटैक्स-हाइलाइट किए गए टेक्स्ट पूर्वावलोकन, इमेज पूर्वावलोकन और शेयर-शीट निर्यात। कोई लेखन कार्रवाई नहीं; पूर्वावलोकन का आकार Gateway द्वारा सीमित होता है।
प्रत्येक पेयर किए गए Gateway के लिए हाल के चैट सत्रों और ट्रांसक्रिप्ट का छोटा, केवल-पढ़ने योग्य ऑफ़लाइन कैश रखता है: कोल्ड ओपन पर अंतिम ज्ञात ट्रांसक्रिप्ट तुरंत दिखता है और Gateway के जवाब देते ही रीफ़्रेश होता है, डिस्कनेक्ट होने पर भी हाल की चैट ब्राउज़ की जा सकती हैं और रीसेट/फ़ॉरगेट संरक्षित स्थानीय कैश को मिटा देता है।
डिस्कनेक्ट रहते हुए भेजे गए टेक्स्ट संदेशों को टिकाऊ, प्रति-Gateway आउटबॉक्स (अधिकतम 50) में कतारबद्ध करता है: कतारबद्ध बबल ट्रांसक्रिप्ट में दिखते हैं, पुनः कनेक्ट होने पर आइडेम्पोटेंट पुनः प्रयासों के साथ क्रम से भेजे जाते हैं, कैनोनिकल इतिहास द्वारा भेजने की पुष्टि होने तक टिकाऊ रहते हैं, पुनः प्रयास/हटाने की कार्रवाई दिखाने से पहले बैकऑफ़ के साथ पुनः प्रयास करते हैं और 48 घंटे ऑफ़लाइन रहने के बाद भेजे जाने के बजाय समाप्त हो जाते हैं; रीसेट/फ़ॉरगेट कैश के साथ कतार भी साफ़ कर देता है।
Chat टेक्स्ट और वॉइस के लिए एकमात्र सतह है। Chat कार्रवाइयाँ Chat छोड़े बिना पूरी Sessions स्क्रीन खोल सकती हैं और सहायक के तर्क तथा टूल गतिविधि को दिखा या छिपा सकती हैं। ड्राफ़्ट डिक्टेशन के लिए माइक्रोफ़ोन पर टैप करें, वॉइस नोट रिकॉर्ड करने के लिए उसका मेनू खोलें या रियलटाइम वॉइस के लिए इनलाइन Talk नियंत्रण का उपयोग करें; सुनते या बोलते समय Talk नियंत्रण लाइव माइक्रोफ़ोन या प्लेबैक स्तर के अनुसार एनिमेट होता है।
Settings -> OpenClaw एक समर्पित Gateway सेटिंग सहायक खोलता है, जब ऑपरेटर कनेक्शन में operator.admin हो और Gateway openclaw.chat का समर्थन करता हो। इसकी सेटअप बातचीत सामान्य Chat से अलग रहती है, गुप्त जवाबों को स्थानीय रूप से छिपाती है और आपके Open Chat पर टैप करने के बाद ही Chat में जाती है।
माँग पर सहायक संदेशों को बोलकर सुनाता है: Chat में किसी संदेश को देर तक दबाएँ और Listen चुनें। ऐप कॉन्फ़िगर किए गए TTS प्रदाता के साथ समर्थित Gateway tts.speak क्लिप चलाता है और Gateway ऑडियो अनुपलब्ध या चलाने योग्य न होने पर डिवाइस पर उपलब्ध वाक् सुविधा का उपयोग करता है। सत्र बदलने या ऐप के बैकग्राउंड में जाने पर प्लेबैक रुक जाता है।

आवश्यकताएँ

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

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

पहली बार लॉन्च करने पर ऐप पेयरिंग की संक्षिप्त व्याख्या और अनुमतियों के पेज (सूचनाएँ, कैमरा, माइक्रोफ़ोन, फ़ोटो, संपर्क, कैलेंडर, रिमाइंडर, स्थान) के माध्यम से आपका मार्गदर्शन करता है। प्रत्येक अनुमति वैकल्पिक है और इसे बाद में Settings -> Permissions या iOS Settings ऐप में बदला जा सकता है।

ऐसे रूट के साथ प्रमाणित Gateway शुरू करें जिस तक आपका फ़ोन पहुँच सके। Tailscale Serve अनुशंसित रिमोट पथ है:

openclaw gateway --port 18789 --tailscale serve

विश्वसनीय समान-LAN सेटअप के लिए इसके बजाय प्रमाणित gateway.bind: "lan" का उपयोग करें। डिफ़ॉल्ट लूपबैक बाइंड तक फ़ोन से नहीं पहुँचा जा सकता। यदि Gateway अभी तक कॉन्फ़िगर नहीं किया गया है, तो पहले openclaw onboard चलाएँ, ताकि सेटअप-कोड बनाने के लिए टोकन या पासवर्ड प्रमाणीकरण पथ उपलब्ध हो।

Control UI खोलें, Nodes चुनें और Devices पेज पर Pair mobile device क्लिक करें। पूर्ण पहुँच अनुशंसित है और डिफ़ॉल्ट रूप से चयनित होती है; केवल तभी Limited access चुनें, जब आप प्रशासनिक Gateway नियंत्रणों को छोड़ना चाहते हों, फिर Create setup code क्लिक करें।
iOS ऐप में Settings -> Gateway खोलें, QR कोड स्कैन करें (या सेटअप कोड पेस्ट करें) और कनेक्ट करें। यदि सेटअप कोड में LAN और Tailscale Serve दोनों रूट हैं, तो ऐप उन्हें क्रम से जाँचता है और पहुँच योग्य पहला एंडपॉइंट सहेजता है। पेयर किए गए Gateway Gateways सूची में बने रहते हैं। चेकमार्क फ़ोकस किए गए Gateway की पहचान करता है; किसी अन्य पंक्ति पर बोल्ट नियंत्रण का उपयोग करके उसके ऑपरेटर सत्र को भी उसी समय कनेक्ट रखें। फ़ोकस बदलने से अन्य सक्षम Gateway डिस्कनेक्ट नहीं होते। केवल फ़ोकस किया गया Gateway iPhone का क्षमता-युक्त Node सत्र प्राप्त करता है, इसलिए कैमरा, स्क्रीन, स्थान और अन्य डिवाइस कमांड का हमेशा एक स्पष्ट स्वामी होता है। ऐप के बैकग्राउंड में जाने के बाद iOS इन फ़ोरग्राउंड कनेक्शन को निलंबित कर सकता है।
आधिकारिक ऐप स्वचालित रूप से कनेक्ट होता है। यदि Pending approval में कोई अनुरोध दिखाई देता है, तो उसे अनुमोदित करने से पहले उसकी भूमिका और स्कोप की समीक्षा करें। Settings → Gateway दिखाता है कि सहेजे गए ऑपरेटर कनेक्शन के पास Full या Limited पहुँच है। प्लेनटेक्स्ट LAN ws:// सेटअप को बेयरर-टोकन सुरक्षा के लिए स्वचालित रूप से सीमित किया जाता है। यदि यह सीमित है, तो wss:// या Tailscale Serve कॉन्फ़िगर करें, Control UI या openclaw qr से नया पूर्ण-पहुँच कोड स्कैन करें, फिर सेटिंग और अपग्रेड सक्षम करने के लिए पुनः कनेक्ट करें।

Control UI बटन के लिए operator.admin वाला पहले से पेयर किया गया सत्र आवश्यक है। टर्मिनल फ़ॉलबैक के रूप में iOS ऐप में खोजा गया Gateway चुनें (या Manual Host सक्षम करके होस्ट/पोर्ट दर्ज करें), फिर Gateway होस्ट पर अनुरोध अनुमोदित करें:

openclaw devices list
openclaw devices approve <requestId>

यदि ऐप बदले हुए प्रमाणीकरण विवरण (भूमिका/स्कोप/सार्वजनिक कुंजी) के साथ पेयरिंग का पुनः प्रयास करता है, तो पिछला लंबित अनुरोध अधिक्रमित हो जाता है और नया requestId बनाया जाता है। अनुमोदन से पहले openclaw devices list फिर से चलाएँ। वैकल्पिक: यदि iOS Node हमेशा कड़ाई से नियंत्रित सबनेट से कनेक्ट होता है, तो आप स्पष्ट CIDR या सटीक IP के साथ पहली बार Node के स्वचालित अनुमोदन को ऑप्ट-इन कर सकते हैं:

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

यह डिफ़ॉल्ट रूप से अक्षम है। यह केवल बिना अनुरोधित स्कोप वाली नई role: node पेयरिंग पर लागू होता है। ऑपरेटर/ब्राउज़र पेयरिंग और भूमिका, स्कोप, मेटाडेटा या सार्वजनिक कुंजी में किसी भी बदलाव के लिए अब भी मैन्युअल अनुमोदन आवश्यक है।

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

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

स्वास्थ्य सारांश

iOS Node वर्तमान कैलेंडर दिन के लिए वैकल्पिक, केवल-पढ़ने योग्य HealthKit समग्र सारांश लौटा सकता है। iOS डिवाइस की सहमति और स्पष्ट Gateway कमांड प्राधिकरण स्वतंत्र नियंत्रण हैं। सेटअप, आह्वान, पेलोड फ़ील्ड, गोपनीयता व्यवहार और समस्या निवारण के लिए HealthKit सारांश देखें। डिफ़ॉल्ट रूप से, Apple Watch सहयोगी मौजूदा iPhone रिले का उपयोग जारी रखता है और उसे अलग Gateway पेयरिंग की आवश्यकता नहीं होती। Apple के Watch ऐप में Watch को iPhone से पेयर करें, Watch app -> My Watch -> Available Apps से OpenClaw इंस्टॉल करें, फिर दोनों डिवाइस पर OpenClaw को एक बार खोलें।

कमांड अनुमोदनों की समीक्षा

operator.admin वाला ऑपरेटर कनेक्शन, या Gateway द्वारा स्पष्ट रूप से लक्षित पेयर किया गया operator.approvals कनेक्शन, iPhone पर लंबित exec अनुरोधों की समीक्षा कर सकता है। अनुमोदन कार्ड Gateway का साफ़ किया गया कमांड पूर्वावलोकन, चेतावनी, होस्ट संदर्भ, समाप्ति और केवल उस अनुरोध द्वारा प्रस्तुत निर्णय दिखाता है। पेयर की गई Apple Watch मौजूदा iPhone रिले के माध्यम से वही समीक्षक-सुरक्षित प्रॉम्प्ट प्राप्त करती है और संक्षिप्त एक-बार-अनुमति/अस्वीकार निर्णय उपसमुच्चय प्रस्तुत करती है। प्रत्यक्ष Watch Gateway मोड अनुमोदन प्रॉम्प्ट संचारित नहीं करता। अनुमोदन स्थिति Control UI और समर्थित चैट सतहों के साथ साझा होती है। पहले प्रतिबद्ध उत्तर को स्वीकार किया जाता है। किसी अन्य सतह द्वारा अनुरोध का समाधान किए जाने के बाद, दूरस्थ समाधान सूचना के बाद और जब भी समाधान की पावती खो जाने की संभावना हो, iPhone और Watch Gateway का प्रामाणिक अंतिम रिकॉर्ड प्राप्त करते हैं। जब तक वह पुनर्प्राप्ति यह पुष्टि नहीं करती कि अनुरोध अभी भी लंबित है या नहीं, कार्रवाइयाँ अनुपलब्ध रहती हैं। अनुमोदन का स्वामित्व चयनित Gateway से संबद्ध होता है। Gateway बदलने पर पुराने प्रॉम्प्ट को प्रतिस्थापन कनेक्शन पर लागू नहीं किया जा सकता। एकीकृत अनुमोदन विधियों से पुराने Gateway, जारी की गई exec-विशिष्ट विधियों पर वापस जाते हैं; सुरक्षित रखी गई अंतिम स्थिति और अधिक समृद्ध अंतर-सतह परिणामों के लिए अपडेट किया गया Gateway आवश्यक है।

एजेंट के प्रश्नों का उत्तर देना

चैट, operator.questions (या operator.admin) वाले ऑपरेटर कनेक्शन के लिए लंबित Gateway प्रश्नों को नेटिव कार्ड के रूप में दिखाती है। कार्ड एकल और बहु-चयन विकल्पों, विकल्प विवरणों, मुक्त-पाठ अन्य उत्तरों और समाप्ति की उलटी गिनती का समर्थन करते हैं। पुनः कनेक्ट होने पर लंबित प्रश्न Gateway से फिर लोड किए जाते हैं। जब यह डिवाइस उत्तर देता है, कोई अन्य सतह पहले उत्तर देती है, या प्रश्न की अवधि समाप्त हो जाती है अथवा उसे रद्द कर दिया जाता है, तो कार्ड लॉक हो जाता है।

वैकल्पिक प्रत्यक्ष Apple Watch Node

प्रत्यक्ष मोड Watch को उसकी अपनी हस्ताक्षरित Node पहचान और Gateway कनेक्शन देता है। OpenClaw के सक्रिय रहने पर समर्थित Node कमांड Watch के Wi-Fi या सेल्युलर कनेक्शन पर काम करना जारी रखते हैं, भले ही पेयर किया गया iPhone उपलब्ध न हो। आवश्यकताएँ:

iPhone, operator.admin स्कोप के साथ Gateway से कनेक्ट है।
सेटअप कोड ऐसे wss:// Gateway एंडपॉइंट का विज्ञापन करता है जिसका प्रमाणपत्र watchOS द्वारा विश्वसनीय है; Watch संबंधित https:// ऑरिजिन को पोल करती है। सादा HTTP और स्व-हस्ताक्षरित या केवल-फ़िंगरप्रिंट विश्वसनीयता समर्थित नहीं हैं। एंडपॉइंट कॉन्फ़िगरेशन के लिए Gateway-स्वामित्व वाली पेयरिंग देखें। लूपबैक, केवल-iPhone और केवल-tailnet रूट तक Watch स्वतंत्र रूप से नहीं पहुँच सकती।
सेल्युलर उपयोग के लिए सक्रिय सेवा वाली सेल्युलर-सक्षम Apple Watch आवश्यक है।
OpenClaw Watch पर सक्रिय है। Apple सामान्य watchOS ऐप्स को जेनेरिक WebSocket/TCP कनेक्शन बनाए रखने की अनुमति नहीं देता, इसलिए प्रत्यक्ष Node छोटे HTTPS पोल का उपयोग करता है और ऐप के फिर से अग्रभूमि में आने पर पुनः कनेक्ट होता है। Apple का watchOS निम्न-स्तरीय नेटवर्किंग मार्गदर्शन देखें।

सेटअप:

iPhone पर Settings -> Apple Watch खोलें।
Enable Direct Gateway Connection पर टैप करें।
अल्पकालिक सेटअप कोड की अवधि समाप्त होने से पहले Watch पर OpenClaw खोलें।
openclaw nodes status के साथ अलग Apple Watch पंक्ति सत्यापित करें।

सेटअप कोड में अल्पकालिक, केवल-Node बूटस्ट्रैप क्रेडेंशियल होता है; अवधि समाप्त होने तक इसे पासवर्ड की तरह सुरक्षित रखें। इसमें कभी भी iPhone का सहेजा हुआ Gateway पासवर्ड या टोकन नहीं होता। पेयरिंग के बाद, Watch अपना डिवाइस टोकन संग्रहीत करती है और बूटस्ट्रैप क्रेडेंशियल हटा देती है। प्रत्यक्ष मोड केवल नीचे दिए गए कमांड को कवर करता है। चैट, Talk, अनुमोदन और मौजूदा watch.* सूचना प्रवाह iPhone-रिले सुविधाएँ बने रहते हैं और इनके लिए अब भी पेयर किया गया iPhone आवश्यक है। प्रत्यक्ष watchOS Node कमांड:

सतह	कमांड	टिप्पणियाँ
डिवाइस	`device.info`, `device.status`	Watch पहचान, बैटरी, तापीय स्थिति, स्टोरेज और नेटवर्क।
सूचनाएँ	`system.notify`	ऐप के सक्रिय रहने के दौरान; Watch की अनुमति आवश्यक है।

watchOS तृतीय-पक्ष ऐप्स को WebKit उपलब्ध नहीं कराता, इसलिए प्रत्यक्ष Watch Node Canvas कमांड का विज्ञापन नहीं करता।

आधिकारिक बिल्ड के लिए रिले-समर्थित पुश

आधिकारिक रूप से वितरित iOS बिल्ड कच्चे APNs टोकन को Gateway पर प्रकाशित करने के बजाय बाहरी पुश रिले का उपयोग करते हैं। सार्वजनिक रिलीज़ लेन के आधिकारिक App Store बिल्ड https://ios-push-relay.openclaw.ai पर होस्ट किए गए रिले का उपयोग करते हैं; यह आधार URL App Store वितरण के लिए हार्डकोड किया गया है और किसी ओवरराइड को नहीं पढ़ता। कस्टम रिले परिनियोजनों के लिए जानबूझकर अलग iOS बिल्ड/परिनियोजन पथ आवश्यक है, जिसका रिले URL Gateway के रिले URL से मेल खाता हो। App Store रिलीज़ लेन कभी भी कस्टम रिले URL स्वीकार नहीं करती। यदि आप कस्टम रिले बिल्ड का उपयोग कर रहे हैं, तो मेल खाने वाला Gateway रिले URL सेट करें:

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

प्रवाह कैसे काम करता है:

iOS ऐप App Attest और StoreKit ऐप ट्रांज़ैक्शन JWS का उपयोग करके रिले के साथ पंजीकरण करता है।
रिले एक अपारदर्शी रिले हैंडल और पंजीकरण-स्कोप वाला भेजने का अनुदान लौटाता है।
iOS ऐप युग्मित Gateway पहचान (gateway.identity.get) प्राप्त करता है और उसे रिले पंजीकरण में शामिल करता है, ताकि रिले-समर्थित पंजीकरण उस विशिष्ट Gateway को प्रत्यायोजित हो।
ऐप उस रिले-समर्थित पंजीकरण को push.apns.register के साथ युग्मित Gateway को अग्रेषित करता है।
Gateway push.test, पृष्ठभूमि वेक और वेक संकेतों के लिए उस संग्रहीत रिले हैंडल का उपयोग करता है।
यदि ऐप बाद में किसी अलग Gateway या अलग रिले बेस URL वाले बिल्ड से कनेक्ट होता है, तो वह पुराने बाइंडिंग का पुनः उपयोग करने के बजाय रिले पंजीकरण को रीफ़्रेश करता है।

इस पथ के लिए Gateway को इनकी आवश्यकता नहीं है: कोई परिनियोजन-व्यापी रिले टोकन नहीं, आधिकारिक App Store रिले-समर्थित भेजने के लिए कोई प्रत्यक्ष APNs कुंजी नहीं। अपेक्षित ऑपरेटर प्रवाह:

आधिकारिक iOS ऐप इंस्टॉल करें।
वैकल्पिक: केवल जानबूझकर अलग कस्टम रिले बिल्ड का उपयोग करते समय Gateway पर gateway.push.apns.relay.baseUrl सेट करें।
ऐप को Gateway के साथ युग्मित करें और उसे कनेक्शन पूरा करने दें।
APNs टोकन मिलने, ऑपरेटर सत्र कनेक्ट होने और रिले पंजीकरण सफल होने के बाद ऐप push.apns.register प्रकाशित करता है।
इसके बाद, push.test, पुनः कनेक्शन वेक और वेक संकेत संग्रहीत रिले-समर्थित पंजीकरण का उपयोग कर सकते हैं।

पृष्ठभूमि सक्रियता बीकन

जब iOS किसी मौन पुश, पृष्ठभूमि रीफ़्रेश या महत्वपूर्ण-स्थान घटना के लिए ऐप को जगाता है, तो ऐप संक्षिप्त Node पुनः कनेक्शन का प्रयास करता है और फिर event: "node.presence.alive" के साथ node.event को कॉल करता है। प्रमाणित Node डिवाइस पहचान ज्ञात होने के बाद ही Gateway इसे युग्मित Node/डिवाइस मेटाडेटा पर lastSeenAtMs/lastSeenReason के रूप में दर्ज करता है। ऐप पृष्ठभूमि वेक को सफलतापूर्वक दर्ज हुआ तभी मानता है, जब Gateway की प्रतिक्रिया में handled: true शामिल हो। पुराने Gateway { "ok": true } के साथ node.event की अभिस्वीकृति दे सकते हैं; यह प्रतिक्रिया संगत है, लेकिन इसे स्थायी अंतिम-देखे-गए अपडेट के रूप में नहीं गिना जाता। संगतता संबंधी टिप्पणी:

OPENCLAW_APNS_RELAY_BASE_URL अभी भी Gateway के लिए अस्थायी env ओवरराइड के रूप में काम करता है (gateway.push.apns.relay.baseUrl कॉन्फ़िगरेशन-प्रथम पथ है)।
App Store रिलीज़ बिल्ड का पुश मोड होस्ट किए गए रिले होस्ट को हार्डकोड करता है और कभी भी रिले-URL ओवरराइड नहीं पढ़ता — बिल्ड-टाइम env var OPENCLAW_PUSH_RELAY_BASE_URL केवल स्थानीय/सैंडबॉक्स iOS बिल्ड मोड को प्रभावित करता है।

प्रमाणीकरण और विश्वास प्रवाह

रिले उन दो प्रतिबंधों को लागू करने के लिए मौजूद है, जिन्हें आधिकारिक iOS बिल्ड के लिए Gateway पर प्रत्यक्ष APNs उपलब्ध नहीं करा सकता:

केवल Apple के माध्यम से वितरित वास्तविक OpenClaw iOS बिल्ड होस्ट किए गए रिले का उपयोग कर सकते हैं।
कोई Gateway केवल उन iOS डिवाइस के लिए रिले-समर्थित पुश भेज सकता है, जिन्हें उसी विशिष्ट Gateway के साथ युग्मित किया गया था।

हर चरण में:

iOS app -> gateway: ऐप सामान्य Gateway प्रमाणीकरण प्रवाह के माध्यम से Gateway के साथ युग्मित होता है, जिससे उसे एक प्रमाणित Node सत्र और एक प्रमाणित ऑपरेटर सत्र मिलता है। ऑपरेटर सत्र gateway.identity.get को कॉल करता है।
iOS app -> relay: ऐप App Attest प्रमाण और StoreKit ऐप ट्रांज़ैक्शन JWS के साथ HTTPS पर रिले पंजीकरण एंडपॉइंट को कॉल करता है। रिले बंडल ID, App Attest प्रमाण और Apple वितरण प्रमाण को सत्यापित करता है तथा आधिकारिक/प्रोडक्शन वितरण पथ की आवश्यकता रखता है — यही स्थानीय Xcode/डेवलपमेंट बिल्ड को होस्ट किए गए रिले का उपयोग करने से रोकता है, क्योंकि स्थानीय बिल्ड आधिकारिक Apple वितरण प्रमाण को पूरा नहीं कर सकता।
gateway identity delegation: रिले पंजीकरण से पहले, ऐप gateway.identity.get से युग्मित Gateway पहचान प्राप्त करता है और उसे रिले पंजीकरण पेलोड में शामिल करता है। रिले उस Gateway पहचान को प्रत्यायोजित एक रिले हैंडल और पंजीकरण-स्कोप वाला भेजने का अनुदान लौटाता है।
gateway -> relay: Gateway push.apns.register से रिले हैंडल और भेजने का अनुदान संग्रहीत करता है। push.test, पुनः कनेक्शन वेक और वेक संकेतों पर Gateway अपनी डिवाइस पहचान से भेजने के अनुरोध पर हस्ताक्षर करता है; रिले पंजीकरण से प्रत्यायोजित Gateway पहचान के विरुद्ध संग्रहीत भेजने के अनुदान और Gateway हस्ताक्षर, दोनों को सत्यापित करता है। कोई अन्य Gateway उस संग्रहीत पंजीकरण का पुनः उपयोग नहीं कर सकता, भले ही उसे किसी तरह हैंडल मिल जाए।
relay -> APNs: आधिकारिक बिल्ड के प्रोडक्शन APNs क्रेडेंशियल और मूल APNs टोकन का स्वामित्व रिले के पास होता है। रिले-समर्थित आधिकारिक बिल्ड के लिए Gateway कभी भी मूल APNs टोकन संग्रहीत नहीं करता; रिले युग्मित Gateway की ओर से अंतिम पुश APNs को भेजता है।

यह डिज़ाइन क्यों बनाया गया: प्रोडक्शन APNs क्रेडेंशियल को उपयोगकर्ता Gateway से बाहर रखने, Gateway पर आधिकारिक बिल्ड के मूल APNs टोकन संग्रहीत करने से बचने, केवल आधिकारिक OpenClaw iOS बिल्ड को होस्ट किए गए रिले के उपयोग की अनुमति देने और किसी Gateway को किसी दूसरे Gateway के स्वामित्व वाले iOS डिवाइस पर वेक पुश भेजने से रोकने के लिए। स्थानीय/मैन्युअल बिल्ड प्रत्यक्ष APNs पर बने रहते हैं। यदि रिले के बिना उन बिल्ड का परीक्षण किया जा रहा है, तो Gateway को अभी भी प्रत्यक्ष APNs क्रेडेंशियल चाहिए:

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

ये Gateway होस्ट रनटाइम env var हैं, Fastlane सेटिंग नहीं। apps/ios/fastlane/.env केवल APP_STORE_CONNECT_KEY_ID और APP_STORE_CONNECT_ISSUER_ID जैसे App Store Connect प्रमाणीकरण को संग्रहीत करता है; यह स्थानीय iOS बिल्ड के लिए प्रत्यक्ष APNs डिलीवरी कॉन्फ़िगर नहीं करता। ~/.openclaw/credentials/ के अंतर्गत अन्य प्रदाता क्रेडेंशियल के अनुरूप अनुशंसित Gateway होस्ट संग्रहण:

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"

.p8 फ़ाइल को कमिट न करें और न ही उसे रिपॉज़िटरी चेकआउट के अंतर्गत रखें।

खोज पथ

Bonjour (LAN)

iOS ऐप local. पर _openclaw-gw._tcp ब्राउज़ करता है और कॉन्फ़िगर होने पर उसी विस्तृत-क्षेत्र DNS-SD खोज डोमेन को भी ब्राउज़ करता है। समान LAN वाले Gateway local. से स्वतः दिखाई देते हैं; क्रॉस-नेटवर्क खोज बीकन प्रकार बदले बिना कॉन्फ़िगर किए गए विस्तृत-क्षेत्र डोमेन का उपयोग कर सकती है।

Tailnet (क्रॉस-नेटवर्क)

यदि mDNS अवरुद्ध है, तो यूनिकास्ट DNS-SD ज़ोन (कोई डोमेन चुनें; उदाहरण: openclaw.internal.) और Tailscale स्प्लिट DNS का उपयोग करें। CoreDNS उदाहरण के लिए Bonjour देखें।

मैन्युअल होस्ट/पोर्ट

Settings में Manual Host सक्षम करें और Gateway होस्ट + पोर्ट दर्ज करें (डिफ़ॉल्ट 18789)।

एकाधिक Gateway

ऐप अपने साथ युग्मित किए गए प्रत्येक Gateway की रजिस्ट्री रखता है, इसलिए आप दोबारा युग्मन किए बिना उनके बीच स्विच कर सकते हैं:

Settings -> Gateway सक्रिय Gateway को चिह्नित करते हुए Paired Gateways सूची दिखाता है। स्विच करने के लिए किसी प्रविष्टि पर टैप करें; ऐप वर्तमान सत्रों को समाप्त करता है और चयनित Gateway से पुनः कनेक्ट होता है। एक से अधिक Gateway युग्मित होने पर कनेक्शन पंक्ति के पास त्वरित-स्विच मेनू दिखाई देता है।
क्रेडेंशियल, TLS विश्वास निर्णय, प्रति-Gateway प्राथमिकताएँ और कैश किया गया चैट इतिहास प्रत्येक Gateway के लिए अलग-अलग संग्रहीत होते हैं। स्विच करने पर Gateway के बीच स्थिति कभी मिश्रित नहीं होती, और पुश पंजीकरण सक्रिय Gateway का अनुसरण करता है।
किसी युग्मित Gateway को स्वाइप करें (या उसके संदर्भ मेनू का उपयोग करें) और उसे Forget करें, जिससे उसके क्रेडेंशियल, डिवाइस टोकन, TLS पिन और कैश की गई चैट हट जाती हैं।
खोजे गए Gateway पर स्विच करने के लिए उनका नेटवर्क पर दिखाई देना आवश्यक है; मैन्युअल Gateway सहेजे गए होस्ट और पोर्ट द्वारा पुनः कनेक्ट होते हैं।

Canvas + A2UI

iOS Node एक WKWebView कैनवस रेंडर करता है। इसे संचालित करने के लिए node.invoke का उपयोग करें:

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

टिप्पणियाँ:

Gateway कैनवस होस्ट, Gateway HTTP सर्वर (वही पोर्ट जो gateway.port का है, डिफ़ॉल्ट 18789) से /__openclaw__/canvas/ और /__openclaw__/a2ui/ प्रदान करता है।
iOS Node अंतर्निहित स्कैफ़ोल्ड को कनेक्टेड डिफ़ॉल्ट दृश्य के रूप में रखता है। canvas.a2ui.push और canvas.a2ui.reset बंडल किए गए ऐप-स्वामित्व वाले A2UI पृष्ठ का उपयोग करते हैं।
दूरस्थ Gateway A2UI पृष्ठ iOS पर केवल रेंडर किए जा सकते हैं; नेटिव A2UI बटन क्रियाएँ केवल बंडल किए गए ऐप-स्वामित्व वाले पृष्ठों से स्वीकार की जाती हैं।
canvas.navigate और {"url":""} के साथ अंतर्निहित स्कैफ़ोल्ड पर लौटें।

Computer Use संबंध

iOS ऐप एक मोबाइल Node सतह है, Codex Computer Use बैकएंड नहीं। Codex Computer Use और cua-driver mcp MCP टूल के माध्यम से स्थानीय macOS डेस्कटॉप को नियंत्रित करते हैं; iOS ऐप canvas.*, camera.*, screen.*, location.* और talk.* जैसे OpenClaw Node कमांड के माध्यम से iPhone क्षमताएँ उपलब्ध कराता है। एजेंट अभी भी Node कमांड लागू करके OpenClaw के माध्यम से iOS ऐप संचालित कर सकते हैं, लेकिन ये कॉल Gateway Node प्रोटोकॉल से होकर गुजरती हैं और iOS की अग्रभूमि/पृष्ठभूमि सीमाओं का पालन करती हैं। स्थानीय डेस्कटॉप नियंत्रण के लिए Codex Computer Use और iOS Node क्षमताओं के लिए इस पृष्ठ का उपयोग करें।

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"}'

वॉइस वेक + टॉक मोड

वॉइस वेक और टॉक मोड Settings में उपलब्ध हैं।
जब talk.realtime.transport, webrtc हो, तब OpenAI रियलटाइम Talk क्लाइंट-स्वामित्व वाले WebRTC का उपयोग करता है; स्पष्ट gateway-relay कॉन्फ़िगरेशन का स्वामित्व Gateway के पास बना रहता है। Talk मोड देखें।
Talk-सक्षम iOS Node talk क्षमता की घोषणा करते हैं और talk.ptt.start, talk.ptt.stop, talk.ptt.cancel और talk.ptt.once घोषित कर सकते हैं; Gateway विश्वसनीय Talk-सक्षम Node के लिए उन पुश-टू-टॉक कमांड की डिफ़ॉल्ट रूप से अनुमति देता है।
iOS पृष्ठभूमि ऑडियो को निलंबित कर सकता है; ऐप सक्रिय न होने पर वॉइस सुविधाओं को सर्वोत्तम-प्रयास के रूप में मानें।

सामान्य त्रुटियाँ

NODE_BACKGROUND_UNAVAILABLE: iOS ऐप को अग्रभूमि में लाएँ (कैनवस/कैमरा/स्क्रीन कमांड के लिए यह आवश्यक है)।
A2UI_HOST_UNAVAILABLE: बंडल किया गया A2UI पृष्ठ ऐप WebView में उपलब्ध नहीं था; ऐप को Screen टैब पर अग्रभूमि में रखें और पुनः प्रयास करें।
युग्मन संकेत कभी दिखाई नहीं देता: openclaw devices list चलाएँ और मैन्युअल रूप से स्वीकृति दें।
Watch कोई iPhone स्थिति नहीं दिखाती: पुष्टि करें कि iPhone watch.status में watchPaired: true और watchAppInstalled: true रिपोर्ट करता है। यदि युग्मन false है, तो Apple के Watch ऐप में Watch को युग्मित करें। यदि इंस्टॉलेशन false है, तो सहयोगी ऐप को My Watch -> Available Apps से इंस्टॉल करें। इनमें से किसी भी बदलाव के बाद, Watch पर OpenClaw एक बार खोलें; तत्काल पहुँच के लिए अभी भी दोनों ऐप का चलना आवश्यक है, जबकि कतारबद्ध अपडेट बाद में पृष्ठभूमि में पहुँच सकते हैं।
पुनः इंस्टॉल करने के बाद पुनः कनेक्शन विफल होता है: Keychain युग्मन टोकन साफ़ हो गया था; Node को फिर से युग्मित करें।

Platforms overview

macOS companion app

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

आवश्यकताएँ

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

स्वास्थ्य सारांश

कमांड अनुमोदनों की समीक्षा

एजेंट के प्रश्नों का उत्तर देना

वैकल्पिक प्रत्यक्ष Apple Watch Node

आधिकारिक बिल्ड के लिए रिले-समर्थित पुश

पृष्ठभूमि सक्रियता बीकन

प्रमाणीकरण और विश्वास प्रवाह

खोज पथ

Bonjour (LAN)

Tailnet (क्रॉस-नेटवर्क)

मैन्युअल होस्ट/पोर्ट

एकाधिक Gateway

Canvas + A2UI

Computer Use संबंध

Canvas eval / snapshot

वॉइस वेक + टॉक मोड

सामान्य त्रुटियाँ

संबंधित दस्तावेज़

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

​आवश्यकताएँ

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

​स्वास्थ्य सारांश

​कमांड अनुमोदनों की समीक्षा

​एजेंट के प्रश्नों का उत्तर देना

​वैकल्पिक प्रत्यक्ष Apple Watch Node

​आधिकारिक बिल्ड के लिए रिले-समर्थित पुश

​पृष्ठभूमि सक्रियता बीकन

​प्रमाणीकरण और विश्वास प्रवाह

​खोज पथ

​Bonjour (LAN)

​Tailnet (क्रॉस-नेटवर्क)

​मैन्युअल होस्ट/पोर्ट

​एकाधिक Gateway

​Canvas + A2UI

​Computer Use संबंध

​Canvas eval / snapshot

​वॉइस वेक + टॉक मोड

​सामान्य त्रुटियाँ

​संबंधित दस्तावेज़

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

आवश्यकताएँ

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

स्वास्थ्य सारांश

कमांड अनुमोदनों की समीक्षा

एजेंट के प्रश्नों का उत्तर देना

वैकल्पिक प्रत्यक्ष Apple Watch Node

आधिकारिक बिल्ड के लिए रिले-समर्थित पुश

पृष्ठभूमि सक्रियता बीकन

प्रमाणीकरण और विश्वास प्रवाह

खोज पथ

Bonjour (LAN)

Tailnet (क्रॉस-नेटवर्क)

मैन्युअल होस्ट/पोर्ट

एकाधिक Gateway

Canvas + A2UI

Computer Use संबंध

Canvas eval / snapshot

वॉइस वेक + टॉक मोड

सामान्य त्रुटियाँ

संबंधित दस्तावेज़