الانتقال إلى المحتوى الرئيسي

​
تطبيق iOS (عُقدة)

التوفّر: معاينة داخلية. لم يتم توزيع تطبيق iOS للعامة بعد.

​
ما الذي يفعله

  • يتصل بـ Gateway عبر WebSocket (شبكة محلية LAN أو tailnet).
  • يعرّض قدرات العُقدة: اللوحة (Canvas)، لقطة الشاشة، التقاط الكاميرا، الموقع، وضع التحدث، الاستيقاظ الصوتي.
  • يستقبل أوامر node.invoke ويبلّغ عن أحداث حالة العُقدة.

​
المتطلبات

  • تشغيل Gateway على جهاز آخر (macOS أو Linux أو Windows عبر WSL2).
  • مسار الشبكة:
    • نفس شبكة LAN عبر Bonjour، أو
    • عبر tailnet باستخدام unicast DNS-SD (نطاق مثال: openclaw.internal.)، أو
    • إدخال المضيف/المنفذ يدويًا (حل احتياطي).

​
البدء السريع (إقران + اتصال)

  1. ابدأ Gateway:
openclaw gateway --port 18789
  1. في تطبيق iOS، افتح الإعدادات واختر Gateway مكتشفة (أو فعّل «Manual Host» وأدخل المضيف/المنفذ).
  2. وافق على طلب الإقران على مضيف Gateway: 
openclaw nodes pending
openclaw nodes approve <requestId>
  1. التحقق من الاتصال:
openclaw nodes status
openclaw gateway call node.list --params "{}"

​
مسارات الاكتشاف

​
Bonjour (LAN)

يعلن Gateway عن _openclaw-gw._tcp على local.. يعرض تطبيق iOS هذه العناصر تلقائيًا.

​
Tailnet (عبر الشبكات)

إذا كان mDNS محظورًا، استخدم منطقة unicast DNS-SD (اختر نطاقًا؛ مثال: openclaw.internal.) وتقسيم DNS في Tailscale. انظر Bonjour لمثال CoreDNS.

​
المضيف/المنفذ اليدوي

في الإعدادات، فعّل Manual Host وأدخل مضيف Gateway + المنفذ (الافتراضي 18789).

​
اللوحة (Canvas) + A2UI

تعرض عُقدة iOS لوحة WKWebView. استخدم node.invoke للتحكم بها: 
openclaw nodes invoke --node "iOS Node" --command canvas.navigate --params '{"url":"http://<gateway-host>:18793/__openclaw__/canvas/"}'
ملاحظات:
  • يقدّم مضيف لوحة Gateway /__openclaw__/canvas/ و/__openclaw__/a2ui/.
  • يتم تقديمه من خادم Gateway عبر HTTP (نفس المنفذ gateway.port، الافتراضي 18789).
  • تنتقل عُقدة iOS تلقائيًا إلى A2UI عند الاتصال عندما يتم الإعلان عن عنوان URL لمضيف اللوحة.
  • عُد إلى الهيكل الافتراضي المدمج باستخدام canvas.navigate و{"url":""}.

​
قماش فاس / لقطة

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

​
الاستيقاظ الصوتي + وضع التحدث

  • يتوفر الاستيقاظ الصوتي ووضع التحدث في الإعدادات.
  • قد يعلّق iOS الصوت في الخلفية؛ تعامل مع ميزات الصوت على أنها «أفضل جهد» عندما لا يكون التطبيق نشطًا.

​
أخطاء شائعة

  • NODE_BACKGROUND_UNAVAILABLE: اجلب تطبيق iOS إلى الواجهة (تتطلب أوامر اللوحة/الكاميرا/الشاشة ذلك).
  • A2UI_HOST_NOT_CONFIGURED: لم يعلن Gateway عن عنوان URL لمضيف اللوحة؛ تحقّق من canvasHost في تهيئة Gateway.
  • لا يظهر طلب الإقران أبدًا: شغّل openclaw nodes pending ووافق يدويًا.
  • فشل إعادة الاتصال بعد إعادة التثبيت: تم مسح رمز الإقران من Keychain؛ أعد إقران العُقدة.

​
مستندات ذات صلة