---
read_when:
    - تصميم مساعد الإعداد الأولي على macOS
    - تنفيذ إعدادات المصادقة أو الهوية
sidebarTitle: 'Onboarding: macOS App'
summary: تدفق الإعداد عند التشغيل الأول لـ OpenClaw (تطبيق macOS)
title: الإعداد الأولي (تطبيق macOS)
x-i18n:
    generated_at: "2026-04-05T12:56:40Z"
    model: gpt-5.4
    provider: openai
    source_hash: a3c5f313a8e5c3a2e68a9488f07c40fcdf75b170dc868c7614565ad9f67755d6
    source_path: start/onboarding.md
    workflow: 15
---

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

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

<Steps>
<Step title="الموافقة على تحذير macOS">
<Frame>
<img src="/assets/macos-onboarding/01-macos-warning.jpeg" alt="" />
</Frame>
</Step>
<Step title="الموافقة على العثور على الشبكات المحلية">
<Frame>
<img src="/assets/macos-onboarding/02-local-networks.jpeg" alt="" />
</Frame>
</Step>
<Step title="الترحيب وإشعار الأمان">
<Frame caption="اقرأ إشعار الأمان المعروض واتخذ قرارك وفقًا لذلك">
<img src="/assets/macos-onboarding/03-security-notice.png" alt="" />
</Frame>

نموذج الثقة الأمني:

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

</Step>
<Step title="محلي أم بعيد">
<Frame>
<img src="/assets/macos-onboarding/04-choose-gateway.png" alt="" />
</Frame>

أين يتم تشغيل **Gateway**؟

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

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

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

</Tip>
</Step>
<Step title="الأذونات">
<Frame caption="اختر الأذونات التي تريد منحها لـ OpenClaw">
<img src="/assets/macos-onboarding/05-permissions.png" alt="" />
</Frame>

يطلب الإعداد الأولي أذونات TCC اللازمة من أجل:

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

</Step>
<Step title="CLI">
  <Info>هذه الخطوة اختيارية</Info>
  يمكن للتطبيق تثبيت CLI العام `openclaw` عبر npm أو pnpm أو bun.
  وهو يفضّل npm أولًا، ثم pnpm، ثم bun إذا كان مدير الحزم الوحيد
  المكتشف. بالنسبة إلى وقت تشغيل Gateway، يظل Node هو المسار الموصى به.
</Step>
<Step title="دردشة الإعداد الأولي (جلسة مخصصة)">
  بعد الإعداد، يفتح التطبيق جلسة دردشة مخصصة للإعداد الأولي حتى يتمكن الوكيل من
  تقديم نفسه وتوجيه الخطوات التالية. هذا يُبقي إرشادات التشغيل الأول منفصلة
  عن محادثتك العادية. راجع [Bootstrapping](/start/bootstrapping) لمعرفة
  ما يحدث على مضيف gateway أثناء أول تشغيل للوكيل.
</Step>
</Steps>
