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

الإعداد الأولي (تطبيق macOS)

يوضح هذا المستند تدفق الإعداد الحالي عند التشغيل الأول. الهدف هو تجربة سلسة في “اليوم الأول”: اختيار مكان تشغيل Gateway، وربط المصادقة، وتشغيل المعالج، وترك الوكيل يهيئ نفسه بنفسه. للحصول على نظرة عامة على مسارات الإعداد الأولي، راجع Onboarding Overview.
1

الموافقة على تحذير macOS

2

الموافقة على العثور على الشبكات المحلية

3

الترحيب وإشعار الأمان

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

محلي أم بعيد

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

الأذونات

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

CLI

هذه الخطوة اختيارية
يمكن للتطبيق تثبيت CLI العام openclaw عبر npm أو pnpm أو bun. وهو يفضّل npm أولًا، ثم pnpm، ثم bun إذا كان مدير الحزم الوحيد المكتشف. بالنسبة إلى وقت تشغيل Gateway، يظل Node هو المسار الموصى به.
7

دردشة الإعداد الأولي (جلسة مخصصة)

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