تطبيق Android

​

لقطة الدعم

• الدور: تطبيق عقدة مرافقة (لا يستضيف Android الـ Gateway).
• Gateway مطلوب: نعم (شغّله على macOS أو Linux أو Windows عبر WSL2).
• التثبيت: Google Play للتطبيق، وبدء الاستخدام للـ Gateway، ثم الإقران.
• Gateway: دليل التشغيل + التكوين.
  • البروتوكولات: بروتوكول Gateway (العُقد + مستوى التحكم).

​

التحكم في النظام

​

دليل تشغيل الاتصال

• المفضّل: Tailscale Serve / Funnel مع https://<magicdns> / wss://<magicdns>
• مدعوم أيضًا: أي عنوان URL آخر للـ Gateway بصيغة wss:// مع نقطة نهاية TLS حقيقية
• يظل النص الصريح ws:// مدعومًا على عناوين LAN الخاصة / مضيفي .local، بالإضافة إلى localhost و127.0.0.1 وجسر محاكي Android (10.0.2.2)

​

المتطلبات المسبقة

• يمكنك تشغيل الـ Gateway على الجهاز “الرئيسي”.
• يمكن لجهاز/محاكي Android الوصول إلى WebSocket الخاص بالـ Gateway:
  • نفس شبكة LAN مع mDNS/NSD، أو
  • نفس شبكة Tailscale tailnet باستخدام Wide-Area Bonjour / unicast DNS-SD (انظر أدناه)، أو
  • مضيف/منفذ Gateway يدوي (احتياطي)
• لا يستخدم إقران Android عبر tailnet/عام نقاط نهاية raw tailnet IP ws://. استخدم Tailscale Serve أو عنوان URL آخر بصيغة wss:// بدلًا من ذلك.
• يمكنك تشغيل CLI (openclaw) على جهاز الـ Gateway (أو عبر SSH).

​

1) ابدأ الـ Gateway

openclaw gateway --port 18789 --verbose

• listening on ws://0.0.0.0:18789

openclaw gateway --tailscale serve

​

2) تحقق من الاكتشاف (اختياري)

dns-sd -B _openclaw-gw._tcp local.

openclaw gateway discover --json

​

اكتشاف Tailnet (فيينا ⇄ لندن) عبر unicast DNS-SD

1. أعدّ منطقة DNS-SD (مثل openclaw.internal.) على مضيف الـ Gateway وانشر سجلات _openclaw-gw._tcp.
2. كوّن Tailscale split DNS لنطاقك المختار بحيث يشير إلى خادم DNS ذلك.

​

3) اتصل من Android

• يحافظ التطبيق على اتصال الـ Gateway حيًا عبر خدمة أمامية (إشعار مستمر).
• افتح تبويب الاتصال.
• استخدم وضع رمز الإعداد أو يدوي.
• إذا كان الاكتشاف محظورًا، فاستخدم المضيف/المنفذ اليدوي في عناصر التحكم المتقدمة. بالنسبة إلى مضيفي LAN الخاصة، يظل ws:// يعمل. وبالنسبة إلى مضيفي Tailscale/العامة، فعّل TLS واستخدم نقطة نهاية wss:// / Tailscale Serve.

• نقطة النهاية اليدوية (إذا كانت مفعّلة)، وإلا
• آخر Gateway مكتشف (بأفضل جهد).

​

منارات حضور alive

​

4) الموافقة على الإقران (CLI)

openclaw devices list
openclaw devices approve <requestId>
openclaw devices reject <requestId>

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

​

5) تحقق من أن العقدة متصلة

• عبر حالة العُقد:
  openclaw nodes status
  
• عبر Gateway:
  openclaw gateway call node.list --params "{}"
  

​

6) الدردشة + السجل

• السجل: chat.history (مطبع للعرض؛ تُزال وسوم التعليمات المضمنة من النص المرئي، وتُزال حمولات XML لاستدعاءات الأدوات بالنص العادي (بما في ذلك <tool_call>...</tool_call> و<function_call>...</function_call> و <tool_calls>...</tool_calls> و<function_calls>...</function_calls>، و كتل استدعاء الأدوات المقتطعة) ورموز التحكم بالنموذج المسرّبة ASCII/كاملة العرض، وتُحذف صفوف المساعد ذات الرموز الصامتة الخالصة مثل NO_REPLY / no_reply الدقيقة، ويمكن استبدال الصفوف كبيرة الحجم بعناصر نائبة)
• الإرسال: chat.send
• تحديثات الدفع (بأفضل جهد): chat.subscribe → event:"chat"

​

7) Canvas + الكاميرا

​

مضيف Gateway Canvas (موصى به لمحتوى الويب)

1. أنشئ ~/.openclaw/workspace/canvas/index.html على مضيف الـ Gateway.
2. انتقل بالعقدة إليه (LAN):

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

• canvas.eval، canvas.snapshot، canvas.navigate (استخدم {"url":""} أو {"url":"/"} للعودة إلى السقالة الافتراضية). يعيد canvas.snapshot القيمة { format, base64 } (الافتراضي format="jpeg").
• A2UI: canvas.a2ui.push، canvas.a2ui.reset (canvas.a2ui.pushJSONL اسم مستعار قديم). تستخدم هذه الأوامر صفحة A2UI المملوكة للتطبيق والمضمنة للعرض القادر على الإجراءات.

• camera.snap (jpg)
• camera.clip (mp4)

​

8) الصوت + سطح أوامر Android الموسّع

• تبويب الصوت: لدى Android وضعا التقاط صريحان. الميكروفون هو جلسة يدوية في تبويب الصوت ترسل كل توقف مؤقت كدورة دردشة وتتوقف عندما يغادر التطبيق الواجهة أو يغادر المستخدم تبويب الصوت. التحدث هو وضع Talk مستمر ويواصل الاستماع حتى يتم إيقافه بالتبديل أو تنقطع العقدة.
• يرقّي وضع Talk الخدمة الأمامية الموجودة من connectedDevice إلى connectedDevice|microphone قبل بدء الالتقاط، ثم يخفضها عند توقف وضع Talk. تعلن خدمة العقدة FOREGROUND_SERVICE_CONNECTED_DEVICE مع CHANGE_NETWORK_STATE؛ ويتطلب Android 14+ أيضًا تصريح FOREGROUND_SERVICE_MICROPHONE، ومنح وقت التشغيل RECORD_AUDIO، ونوع خدمة الميكروفون في وقت التشغيل.
• افتراضيًا، يستخدم Android Talk التعرف الأصلي على الكلام، ودردشة Gateway، وtalk.speak عبر مزود Talk المكوّن في الـ Gateway. يُستخدم TTS المحلي للنظام فقط عندما يكون talk.speak غير متاح.
• يستخدم Android Talk ترحيل Gateway بالزمن الحقيقي فقط عندما يكون talk.realtime.mode هو realtime وtalk.realtime.transport هو gateway-relay.
• يظل تنبيه الصوت معطلًا في تجربة مستخدم Android/وقت التشغيل.
• عائلات أوامر Android إضافية (يعتمد التوفر على الجهاز والأذونات وإعدادات المستخدم):
  • device.status، device.info، device.permissions، device.health
  • device.apps فقط عندما يكون الإعدادات > إمكانات الهاتف > التطبيقات المثبتة مفعّلًا؛ يسرد التطبيقات الظاهرة في المشغّل افتراضيًا.
  • notifications.list، notifications.actions (راجع إعادة توجيه الإشعارات أدناه)
  • photos.latest
  • contacts.search، contacts.add
  • calendar.events، calendar.add
  • callLog.search
  • sms.search
  • motion.activity، motion.pedometer

​

نقاط دخول المساعد

​

إعادة توجيه الإشعارات

{
  notifications: {
    allowPackages: ["com.slack", "com.whatsapp"],
    denyPackages: ["com.android.systemui"],
    quietHours: {
      start: "22:00",
      end: "07:00",
    },
    rateLimit: 5,
  },
}

​

ذات صلة

• تطبيق iOS
• العُقَد
• استكشاف أخطاء عقدة Android وإصلاحها