---
read_when:
    - تصميم مساعد الإعداد الأولي لنظام macOS
    - تنفيذ إعداد المصادقة أو الهوية
sidebarTitle: 'Onboarding: macOS App'
summary: تدفق إعداد التشغيل الأول لـ OpenClaw (تطبيق macOS)
title: الإعداد الأولي (تطبيق macOS)
x-i18n:
    generated_at: "2026-05-06T08:14:25Z"
    model: gpt-5.5
    provider: openai
    source_hash: 6dc7ebea5de7b1398d7b64c00245255c59af8a7ef51315cdd0ef1cb4898a41a4
    source_path: start/onboarding.md
    workflow: 16
---

يصف هذا المستند مسار إعداد التشغيل الأول **الحالي**. الهدف هو توفير تجربة
سلسة في "اليوم 0": اختر أين يعمل Gateway، وصِل المصادقة، وشغّل
المعالج، ودع الوكيل يمهّد نفسه.
للاطلاع على نظرة عامة حول مسارات التهيئة، راجع [نظرة عامة على التهيئة](/ar/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 هو وكيل شخصي: حدّ مشغّل موثوق واحد.
- تتطلب إعدادات المشاركة/تعدد المستخدمين إحكامًا أمنيًا (فصل حدود الثقة، إبقاء الوصول إلى الأدوات في الحد الأدنى، واتباع [الأمان](/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="دردشة التهيئة (جلسة مخصصة)">
  بعد الإعداد، يفتح التطبيق جلسة دردشة تهيئة مخصصة حتى يتمكن الوكيل من
  تقديم نفسه وإرشادك إلى الخطوات التالية. يحافظ هذا على إرشادات التشغيل الأول منفصلة
  عن محادثتك العادية. راجع [التمهيد](/ar/start/bootstrapping) لمعرفة
  ما يحدث على مضيف Gateway أثناء تشغيل الوكيل لأول مرة.
</Step>
</Steps>

## ذات صلة

- [نظرة عامة على التهيئة](/ar/start/onboarding-overview)
- [بدء الاستخدام](/ar/start/getting-started)