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

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

أين يعمل Gateway (البوابة)؟

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

نصيحة مصادقة Gateway: - يولِّد المعالج الآن رمزًا مميّزًا حتى لـ loopback، لذا يجب على عملاء WS المحليين المصادقة. - إذا عطّلت المصادقة، يمكن لأي عملية محلية الاتصال؛ استخدم ذلك فقط على الأجهزة الموثوقة بالكامل. - استخدم رمزًا مميّزًا للوصول متعدد الأجهزة أو لعمليات الربط غير loopback.

تطلب التهيئة الأولية أذونات TCC اللازمة لـ:

• الأتمتة (AppleScript)
• الإشعارات
• إمكانية الوصول
• تسجيل الشاشة
• الميكروفون
• التعرّف على الكلام
• الكاميرا
• الموقع

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