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

​
التهيئة الأولية (تطبيق macOS)

تصف هذه الوثيقة تدفق التهيئة الأولية الحالي عند التشغيل لأول مرة. الهدف هو تجربة سلسة من «اليوم صفر»: اختيار مكان تشغيل Gateway (البوابة)، ربط المصادقة، تشغيل معالج الإعداد، وترك الوكيل يهيّئ نفسه ذاتيًا. للاطلاع على نظرة عامة عامة حول مسارات الإعداد الأولي، راجع Onboarding Overview.
1

Approve macOS warning

2

Approve find local networks

3

Welcome and security notice

4

Local vs Remote

أين يعمل Gateway (البوابة)؟
  • هذا الـ Mac (محلي فقط): يمكن للتهيئة الأولية تشغيل تدفقات OAuth وكتابة بيانات الاعتماد محليًا.
  • بعيد (عبر SSH/Tailnet): لا تُشغِّل التهيئة الأولية OAuth محليًا؛ يجب أن تكون بيانات الاعتماد موجودة على مضيف Gateway.
  • التهيئة لاحقًا: تخطَّ الإعداد واترك التطبيق غير مُهيّأ.
نصيحة مصادقة Gateway:
  • يولِّد المعالج الآن رمزًا مميّزًا حتى لـ loopback، لذا يجب على عملاء WS المحليين المصادقة.
  • إذا عطّلت المصادقة، يمكن لأي عملية محلية الاتصال؛ استخدم ذلك فقط على الأجهزة الموثوقة بالكامل.
  • استخدم رمزًا مميّزًا للوصول متعدد الأجهزة أو لعمليات الربط غير loopback.
5

Permissions

تطلب التهيئة الأولية أذونات TCC اللازمة لـ:
  • الأتمتة (AppleScript)
  • الإشعارات
  • إمكانية الوصول
  • تسجيل الشاشة
  • الميكروفون
  • التعرّف على الكلام
  • الكاميرا
  • الموقع
6

CLI

هذه الخطوة اختيارية
يمكن للتطبيق تثبيت CLI العالمي openclaw عبر npm/pnpm بحيث تعمل تدفقات العمل في الطرفية ومهام launchd مباشرة دون إعداد إضافي.
7

Onboarding Chat (dedicated session)

بعد الإعداد، يفتح التطبيق جلسة دردشة مخصّصة للتهيئة الأولية حتى يتمكّن الوكيل من تقديم نفسه وإرشاد الخطوات التالية. يحافظ ذلك على توجيه التشغيل الأول منفصلًا عن محادثتك العادية. راجع Bootstrapping لمعرفة ما يحدث على مضيف Gateway أثناء تشغيل الوكيل لأول مرة.