الإعداد الأولي (تطبيق macOS)
يصف هذا المستند التجربة الحالية لتدفق الإعداد الأولي. الهدف هو تجربة سلسة "في اليوم 0": اختيار مكان تشغيل البوابة، وتوصيل المصادقة، وتشغيل المعالج، والسماح للوكيل بتهيئة نفسه. للحصول على نظرة عامة على مسارات الإعداد الأولي، راجع نظرة عامة على الإعداد الأولي.
الخطوة 1: الموافقة على تحذير macOS

الخطوة 2: الموافقة على البحث عن الشبكات المحلية

الخطوة 3: الترحيب وإشعار الأمان

نموذج الثقة الأمني:
- افتراضيًا، OpenClaw هو وكيل شخصي: حدود مشغل واحد موثوق به.
- تتطلب الإعدادات المشتركة/متعددة المستخدمين تأمينًا صارمًا (فصل حدود الثقة، والحفاظ على وصول الأدوات في الحد الأدنى، واتباع الأمان).
- يحدد الإعداد الأولي المحلي الآن التكوينات الجديدة افتراضيًا على
tools.profile: "coding"حتى تحتفظ الإعدادات المحلية الجديدة بأدوات نظام الملفات/وقت التشغيل دون فرض ملف التعريف غير المقيدfull. - إذا تم تمكين الخطافات/الخطافات الويب أو مصادر المحتوى غير الموثوقة الأخرى، فاستخدم طبقة نموذج حديثة قوية وحافظ على سياسة/عزل صارم للأدوات.
الخطوة 4: محلي مقابل بعيد

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

يطلب الإعداد الأولي أذونات TCC اللازمة لـ:
- الأتمتة (AppleScript)
- الإشعارات
- إمكانية الوصول
- تسجيل الشاشة
- الميكروفون
- التعرف على الكلام
- الكاميرا
- الموقع
الخطوة 6: واجهة سطر الأوامر
ℹ️ هذه الخطوة اختيارية
يمكن للتطبيق تثبيت واجهة سطر الأوامر العالمية openclaw عبر npm/pnpm بحيث تعمل سير عمل الطرفية ومهام launchd بشكل جاهز.
الخطوة 7: محادثة الإعداد الأولي (جلسة مخصصة)
بعد الإعداد، يفتح التطبيق جلسة محادثة مخصصة للإعداد الأولي حتى يتمكن الوكيل من تقديم نفسه وتوجيه الخطوات التالية. هذا يحافظ على توجيهات التشغيل الأولى منفصلة عن محادثتك العادية. راجع التهيئة لمعرفة ما يحدث على مضيف البوابة أثناء التشغيل الأول للوكيل.
الإعداد الأولي: واجهة سطر الأوامرإعداد المساعد الشخصي