मुख्य सामग्री पर जाएं

iOS ऐप (नोड)

Availability: internal preview. The iOS app is not publicly distributed yet.

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

  • WebSocket के माध्यम से Gateway से कनेक्ट होता है (LAN या tailnet)।
  • नोड क्षमताएँ उपलब्ध कराता है: कैनवास, स्क्रीन स्नैपशॉट, कैमरा कैप्चर, लोकेशन, टॉक मोड, वॉयस वेक।
  • node.invoke कमांड्स प्राप्त करता है और नोड स्थिति इवेंट्स रिपोर्ट करता है।

आवश्यकताएँ

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

त्वरित प्रारंभ (पेयर + कनेक्ट)

  1. Gateway शुरू करें:
openclaw gateway --port 18789
  1. iOS ऐप में, Settings खोलें और खोजा गया Gateway चुनें (या Manual Host सक्षम करें और होस्ट/पोर्ट दर्ज करें)।
  2. Gateway होस्ट पर पेयरिंग अनुरोध को स्वीकृत करें:
openclaw nodes pending
openclaw nodes approve <requestId>
  1. कनेक्शन सत्यापित करें:
openclaw nodes status
openclaw gateway call node.list --params "{}"

डिस्कवरी पथ

Bonjour (LAN)

The Gateway advertises _openclaw-gw._tcp on local.. The iOS app lists these automatically.

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

If mDNS is blocked, use a unicast DNS-SD zone (choose a domain; example: openclaw.internal.) and Tailscale split DNS. See Bonjour for the CoreDNS example.

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

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

कैनवास + A2UI

The iOS node renders a WKWebView canvas. Use node.invoke to drive it:
openclaw nodes invoke --node "iOS Node" --command canvas.navigate --params '{"url":"http://<gateway-host>:18793/__openclaw__/canvas/"}'
टिप्पणियाँ:
  • Gateway कैनवास होस्ट /__openclaw__/canvas/ और /__openclaw__/a2ui/ प्रदान करता है।
  • जब कैनवास होस्ट URL का विज्ञापन होता है, तो iOS नोड कनेक्ट होने पर स्वचालित रूप से A2UI पर नेविगेट करता है।
  • canvas.navigate और {"url":""} के साथ बिल्ट-इन स्कैफ़ोल्ड पर वापस लौटें।
  • canvas.navigate और {"url":""} के साथ बिल्ट-इन स्कैफ़ोल्ड पर वापस लौटें।

कैनवास eval / स्नैपशॉट

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 में उपलब्ध हैं।
  • iOS बैकग्राउंड ऑडियो को निलंबित कर सकता है; ऐप सक्रिय न होने पर वॉयस फीचर्स को सर्वोत्तम-प्रयास के रूप में मानें।

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

  • NODE_BACKGROUND_UNAVAILABLE: iOS ऐप को फ़ोरग्राउंड में लाएँ (कैनवास/कैमरा/स्क्रीन कमांड्स के लिए यह आवश्यक है)।
  • A2UI_HOST_NOT_CONFIGURED: Gateway ने कैनवास होस्ट URL का विज्ञापन नहीं किया; Gateway configuration में canvasHost जाँचें।
  • पेयरिंग प्रॉम्प्ट कभी दिखाई नहीं देता: openclaw nodes pending चलाएँ और मैन्युअली स्वीकृत करें।
  • पुनः इंस्टॉल के बाद पुनः कनेक्ट विफल: Keychain पेयरिंग टोकन साफ़ हो गया था; नोड को फिर से पेयर करें।

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