​

تطبيق Android ‏(العقدة)

ملاحظة: لم يتم إصدار تطبيق Android للعامة بعد. الشيفرة المصدرية متاحة في مستودع OpenClaw ضمن apps/android. يمكنك بناؤه بنفسك باستخدام Java 17 وAndroid SDK ‏(./gradlew :app:assemblePlayDebug). راجع apps/android/README.md للحصول على تعليمات البناء.

​

لمحة سريعة عن الدعم

• الدور: تطبيق عقدة مرافق (لا يستضيف Android الـ Gateway).
• هل يتطلب Gateway؟ نعم (شغّله على macOS أو Linux أو Windows عبر WSL2).
• التثبيت: البدء + الاقتران.
• 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 الوصول إلى Gateway WebSocket:
  • على الشبكة المحلية نفسها باستخدام mDNS/NSD، أو
  • على tailnet نفسها في Tailscale باستخدام Wide-Area Bonjour / unicast DNS-SD ‏(انظر أدناه)، أو
  • مضيف/منفذ gateway يدويًا (تراجع)
• لا يستخدم اقتران Android المحمول عبر tailnet/public نقاط نهاية 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 ‏(Vienna ⇄ London) عبر unicast DNS-SD

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

​

3) اتصل من Android

• يحافظ التطبيق على اتصال gateway حيًا عبر خدمة foreground ‏(إشعار دائم).
• افتح علامة التبويب Connect.
• استخدم وضع Setup Code أو Manual.
• إذا كان الاكتشاف محظورًا، فاستخدم المضيف/المنفذ اليدويين في Advanced controls. بالنسبة إلى مضيفات LAN الخاصة، لا يزال ws:// يعمل. أما بالنسبة إلى مضيفات Tailscale/public، ففعّل TLS واستخدم نقطة نهاية wss:// / Tailscale Serve.

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

​

4) وافق على الاقتران (CLI)

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

​

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
• تحديثات push ‏(بأفضل جهد): chat.subscribe → event:"chat"

​

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

​

Gateway Canvas Host ‏(موصى به لمحتوى الويب)

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 اسم بديل قديم)

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

​

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

• الصوت: يستخدم Android تدفق تشغيل/إيقاف واحدًا للميكروفون في علامة التبويب Voice مع التقاط النص المفرغ وتشغيل talk.speak. ويتم استخدام TTS المحلي للنظام فقط عندما لا يكون talk.speak متاحًا. ويتوقف الصوت عندما يغادر التطبيق foreground.
• تمت إزالة مفاتيح Voice wake/talk-mode حاليًا من تجربة Android ووقت تشغيله.
• عائلات أوامر Android الإضافية (يعتمد توفرها على الجهاز + الأذونات):
  • device.status وdevice.info وdevice.permissions وdevice.health
  • 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,
  },
}