> ## Documentation Index
> Fetch the complete documentation index at: https://openclaw.veiseule.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# iOS ऐप

# 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 शुरू करें:

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw gateway --port 18789
```

2. iOS ऐप में, Settings खोलें और खोजा गया Gateway चुनें (या Manual Host सक्षम करें और होस्ट/पोर्ट दर्ज करें)।

3. Gateway होस्ट पर पेयरिंग अनुरोध को स्वीकृत करें:

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw nodes pending
openclaw nodes approve <requestId>
```

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

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
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](/gateway/bonjour) for the CoreDNS example.

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

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

## कैनवास + A2UI

The iOS node renders a WKWebView canvas. Use `node.invoke` to drive it:

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
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 / स्नैपशॉट

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
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\"; })()"}'
```

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
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](/gateway/configuration) में `canvasHost` जाँचें।
* पेयरिंग प्रॉम्प्ट कभी दिखाई नहीं देता: `openclaw nodes pending` चलाएँ और मैन्युअली स्वीकृत करें।
* पुनः इंस्टॉल के बाद पुनः कनेक्ट विफल: Keychain पेयरिंग टोकन साफ़ हो गया था; नोड को फिर से पेयर करें।

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

* [Pairing](/gateway/pairing)
* [Discovery](/gateway/discovery)
* [Bonjour](/gateway/bonjour)