> ## Documentation Index
> Fetch the complete documentation index at: https://openclaw.veiseule.ai/llms.txt
> Use this file to discover all available pages before exploring further.

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

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

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

<Steps>
  <Step title="Approve macOS warning">
    <Frame>
      <img src="https://mintcdn.com/veiseuleai/24AKr3LwoEceqr8Z/assets/macos-onboarding/01-macos-warning.jpeg?fit=max&auto=format&n=24AKr3LwoEceqr8Z&q=85&s=52ce8b835daf7a29b63c3ee7f4a0308a" alt="" width="1132" height="818" data-path="assets/macos-onboarding/01-macos-warning.jpeg" />
    </Frame>
  </Step>

  <Step title="Approve find local networks">
    <Frame>
      <img src="https://mintcdn.com/veiseuleai/24AKr3LwoEceqr8Z/assets/macos-onboarding/02-local-networks.jpeg?fit=max&auto=format&n=24AKr3LwoEceqr8Z&q=85&s=898d91d6350aef17eb26d54f2aae7398" alt="" width="1132" height="818" data-path="assets/macos-onboarding/02-local-networks.jpeg" />
    </Frame>
  </Step>

  <Step title="Welcome and security notice">
    <Frame caption="اقرأ إشعار الأمان المعروض واتخذ القرار وفقًا لذلك">
      <img src="https://mintcdn.com/veiseuleai/24AKr3LwoEceqr8Z/assets/macos-onboarding/03-security-notice.png?fit=max&auto=format&n=24AKr3LwoEceqr8Z&q=85&s=f5c2f45dfb79fb3102f3b00349685c5e" alt="" width="1262" height="1570" data-path="assets/macos-onboarding/03-security-notice.png" />
    </Frame>
  </Step>

  <Step title="Local vs Remote">
    <Frame>
      <img src="https://mintcdn.com/veiseuleai/24AKr3LwoEceqr8Z/assets/macos-onboarding/04-choose-gateway.png?fit=max&auto=format&n=24AKr3LwoEceqr8Z&q=85&s=280e34bced7bf879d9b6f74a77abcda0" alt="" width="1262" height="1570" data-path="assets/macos-onboarding/04-choose-gateway.png" />
    </Frame>

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

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

    <Tip>
      **نصيحة مصادقة Gateway:**

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

  <Step title="Permissions">
    <Frame caption="اختر الأذونات التي تريد منحها لـ OpenClaw">
      <img src="https://mintcdn.com/veiseuleai/24AKr3LwoEceqr8Z/assets/macos-onboarding/05-permissions.png?fit=max&auto=format&n=24AKr3LwoEceqr8Z&q=85&s=fe49a0e85fad11452f3ee292d78e2415" alt="" width="1262" height="1570" data-path="assets/macos-onboarding/05-permissions.png" />
    </Frame>

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

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

  <Step title="CLI">
    <Info>
      هذه الخطوة اختيارية
    </Info>

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

  <Step title="Onboarding Chat (dedicated session)">
    بعد الإعداد، يفتح التطبيق جلسة دردشة مخصّصة للتهيئة الأولية حتى يتمكّن الوكيل من
    تقديم نفسه وإرشاد الخطوات التالية. يحافظ ذلك على توجيه التشغيل الأول منفصلًا
    عن محادثتك العادية. راجع [Bootstrapping](/start/bootstrapping) لمعرفة ما يحدث
    على مضيف Gateway أثناء تشغيل الوكيل لأول مرة.
  </Step>
</Steps>