---
read_when:
    - تشغيل الإعداد الأولي لـ CLI أو تكوينه
    - إعداد جهاز جديد
sidebarTitle: 'Onboarding: CLI'
summary: 'الإعداد الأولي عبر CLI: إعداد موجّه لـ Gateway ومساحة العمل والقنوات وSkills'
title: الإعداد الأولي (CLI)
x-i18n:
    generated_at: "2026-04-30T08:27:35Z"
    model: gpt-5.5
    provider: openai
    source_hash: 9e9ee3af82ab9f4a1af5d20e3680eb932a9428cb914bbc08c9a2bf83c94ec158
    source_path: start/wizard.md
    workflow: 16
---

يُعد إعداد CLI هو الطريقة **الموصى بها** لإعداد OpenClaw على macOS،
أو Linux، أو Windows (عبر WSL2؛ موصى به بشدة).
يقوم بتكوين Gateway محلي أو اتصال Gateway بعيد، بالإضافة إلى القنوات وSkills
وافتراضيات مساحة العمل ضمن مسار إرشادي واحد.

```bash
openclaw onboard
```

<Info>
أسرع محادثة أولى: افتح واجهة التحكم (لا يلزم إعداد قناة). شغّل
`openclaw dashboard` وتحدث في المتصفح. الوثائق: [لوحة التحكم](/ar/web/dashboard).
</Info>

لإعادة التكوين لاحقًا:

```bash
openclaw configure
openclaw agents add <name>
```

<Note>
`--json` لا يعني الوضع غير التفاعلي. للبرامج النصية، استخدم `--non-interactive`.
</Note>

<Tip>
يتضمن إعداد CLI خطوة بحث ويب يمكنك فيها اختيار مزود
مثل Brave أو DuckDuckGo أو Exa أو Firecrawl أو Gemini أو Grok أو Kimi أو MiniMax Search
أو Ollama Web Search أو Perplexity أو SearXNG أو Tavily. يتطلب بعض المزودين
مفتاح API، بينما لا يحتاج آخرون إلى مفاتيح. يمكنك أيضًا تكوين ذلك لاحقًا باستخدام
`openclaw configure --section web`. الوثائق: [أدوات الويب](/ar/tools/web).
</Tip>

## البدء السريع مقابل المتقدم

يبدأ الإعداد بـ **البدء السريع** (الافتراضيات) مقابل **المتقدم** (تحكم كامل).

<Tabs>
  <Tab title="البدء السريع (الافتراضيات)">
    - Gateway محلي (local loopback)
    - افتراضي مساحة العمل (أو مساحة عمل موجودة)
    - منفذ Gateway **18789**
    - مصادقة Gateway **Token** (يُنشأ تلقائيًا، حتى على loopback)
    - افتراضي سياسة الأدوات للإعدادات المحلية الجديدة: `tools.profile: "coding"` (يُحافَظ على الملف الشخصي الصريح الموجود)
    - افتراضي عزل الرسائل المباشرة: يكتب الإعداد المحلي `session.dmScope: "per-channel-peer"` عندما لا يكون مضبوطًا. التفاصيل: [مرجع إعداد CLI](/ar/start/wizard-cli-reference#outputs-and-internals)
    - عرض Tailscale **متوقف**
    - الرسائل المباشرة في Telegram وWhatsApp تستخدم **قائمة السماح** افتراضيًا (سيُطلب منك رقم هاتفك)

  </Tab>
  <Tab title="المتقدم (تحكم كامل)">
    - يكشف كل خطوة (الوضع، مساحة العمل، Gateway، القنوات، الخدمة الخلفية، Skills).

  </Tab>
</Tabs>

## ما الذي يكوّنه الإعداد

يرشدك **الوضع المحلي (الافتراضي)** خلال هذه الخطوات:

1. **النموذج/المصادقة** — اختر أي مزود/مسار مصادقة مدعوم (مفتاح API أو OAuth أو مصادقة يدوية خاصة بالمزود)، بما في ذلك مزود مخصص
   (متوافق مع OpenAI، أو متوافق مع Anthropic، أو كشف تلقائي غير معروف). اختر نموذجًا افتراضيًا.
   ملاحظة أمان: إذا كان هذا الوكيل سيشغّل أدوات أو يعالج محتوى Webhook/hooks، ففضّل أقوى نموذج متاح من أحدث جيل وأبقِ سياسة الأدوات صارمة. المستويات الأضعف/الأقدم أسهل في حقن المطالبات.
   للتشغيل غير التفاعلي، يخزن `--secret-input-mode ref` مراجع مدعومة بالبيئة في ملفات تعريف المصادقة بدلًا من قيم مفاتيح API بنص صريح.
   في وضع `ref` غير التفاعلي، يجب ضبط متغير بيئة المزود؛ تمرير أعلام مفاتيح مضمّنة دون متغير البيئة هذا يفشل بسرعة.
   في التشغيل التفاعلي، يتيح لك اختيار وضع مرجع السر الإشارة إما إلى متغير بيئة أو مرجع مزود مكوّن (`file` أو `exec`)، مع تحقق تمهيدي سريع قبل الحفظ.
   بالنسبة إلى Anthropic، يعرض الإعداد/التكوين التفاعلي **Anthropic Claude CLI** كالمسار المحلي المفضل و**مفتاح Anthropic API** كالمسار الإنتاجي الموصى به. يظل setup-token من Anthropic متاحًا أيضًا كمسار مصادقة رمزية مدعوم.
2. **مساحة العمل** — موقع ملفات الوكيل (الافتراضي `~/.openclaw/workspace`). يزرع ملفات التمهيد.
3. **Gateway** — المنفذ، عنوان الربط، وضع المصادقة، عرض Tailscale.
   في وضع الرمز التفاعلي، اختر تخزين الرمز النصي الصريح الافتراضي أو انتقل إلى SecretRef.
   مسار SecretRef للرمز في الوضع غير التفاعلي: `--gateway-token-ref-env <ENV_VAR>`.
4. **القنوات** — قنوات الدردشة المدمجة والمرفقة مثل BlueBubbles وDiscord وFeishu وGoogle Chat وMattermost وMicrosoft Teams وQQ Bot وSignal وSlack وTelegram وWhatsApp والمزيد.
5. **الخدمة الخلفية** — يثبّت LaunchAgent (macOS)، أو وحدة مستخدم systemd (Linux/WSL2)، أو مهمة Windows Scheduled Task أصلية مع بديل مجلد Startup لكل مستخدم.
   إذا كانت مصادقة الرمز تتطلب رمزًا وكان `gateway.auth.token` مُدارًا بواسطة SecretRef، فإن تثبيت الخدمة الخلفية يتحقق منه لكنه لا يحفظ الرمز المحلول في بيانات تعريف بيئة خدمة المشرف.
   إذا كانت مصادقة الرمز تتطلب رمزًا وكان SecretRef للرمز المكوّن غير قابل للحل، فسيُحظر تثبيت الخدمة الخلفية مع إرشادات قابلة للتنفيذ.
   إذا تم تكوين كل من `gateway.auth.token` و`gateway.auth.password` وكان `gateway.auth.mode` غير مضبوط، فسيُحظر تثبيت الخدمة الخلفية حتى يتم ضبط الوضع صراحةً.
6. **فحص الصحة** — يبدأ Gateway ويتحقق من أنه يعمل.
7. **Skills** — يثبّت Skills الموصى بها والتبعيات الاختيارية.

<Note>
لا تؤدي إعادة تشغيل الإعداد إلى مسح أي شيء ما لم تختر **إعادة تعيين** صراحةً (أو تمرر `--reset`).
تستهدف `--reset` في CLI افتراضيًا التكوين وبيانات الاعتماد والجلسات؛ استخدم `--reset-scope full` لتضمين مساحة العمل.
إذا كان التكوين غير صالح أو يحتوي على مفاتيح قديمة، فسيطلب منك الإعداد تشغيل `openclaw doctor` أولًا.
</Note>

يقوم **الوضع البعيد** فقط بتكوين العميل المحلي للاتصال بـ Gateway في مكان آخر.
لا يثبّت أو يغيّر أي شيء على المضيف البعيد.

## إضافة وكيل آخر

استخدم `openclaw agents add <name>` لإنشاء وكيل منفصل له مساحة عمله الخاصة،
وجلساته، وملفات تعريف المصادقة الخاصة به. التشغيل بدون `--workspace` يطلق الإعداد.

ما يضبطه:

- `agents.list[].name`
- `agents.list[].workspace`
- `agents.list[].agentDir`

ملاحظات:

- تتبع مساحات العمل الافتراضية `~/.openclaw/workspace-<agentId>`.
- أضف `bindings` لتوجيه الرسائل الواردة (يمكن للإعداد فعل ذلك).
- أعلام الوضع غير التفاعلي: `--model`، `--agent-dir`، `--bind`، `--non-interactive`.

## المرجع الكامل

للحصول على تفصيل خطوة بخطوة ومخرجات التكوين، راجع
[مرجع إعداد CLI](/ar/start/wizard-cli-reference).
لأمثلة الوضع غير التفاعلي، راجع [أتمتة CLI](/ar/start/wizard-cli-automation).
للمرجع التقني الأعمق، بما في ذلك تفاصيل RPC، راجع
[مرجع الإعداد](/ar/reference/wizard).

## وثائق ذات صلة

- مرجع أوامر CLI: [`openclaw onboard`](/ar/cli/onboard)
- نظرة عامة على الإعداد: [نظرة عامة على الإعداد](/ar/start/onboarding-overview)
- إعداد تطبيق macOS: [الإعداد](/ar/start/onboarding)
- طقس التشغيل الأول للوكيل: [تمهيد الوكيل](/ar/start/bootstrapping)
