---
read_when:
    - فهم ما يحدث عند تشغيل الوكيل لأول مرة
    - شرح مكان وجود ملفات التمهيد
    - تصحيح أخطاء إعداد الهوية أثناء الإعداد الأولي
sidebarTitle: Bootstrapping
summary: طقس تهيئة الوكيل الذي يُنشئ ملفات مساحة العمل والهوية الأولية
title: تهيئة الوكيل الأولية
x-i18n:
    generated_at: "2026-07-12T06:39:01Z"
    model: gpt-5.6
    postprocess_version: locale-links-v1
    provider: openai
    source_hash: d8356684e8567b02f558ce2b455a20019e55579e5dcb4625bb441d66656098e0
    source_path: start/bootstrapping.md
    workflow: 16
---

التهيئة الأولية هي طقس التشغيل الأول الذي يزوّد مساحة عمل وكيل جديدة بالملفات الأولية
ويرشد الوكيل خلال اختيار هوية. وتُجرى مرة واحدة، مباشرةً بعد
الإعداد الأولي، في أول دورة فعلية للوكيل.

## ما الذي يحدث

عند التشغيل الأول باستخدام مساحة عمل جديدة تمامًا (المسار الافتراضي `~/.openclaw/workspace`)،
يقوم OpenClaw بما يلي:

- ينشئ الملفات الأولية `AGENTS.md` و`SOUL.md` و`TOOLS.md` و`IDENTITY.md` و`USER.md` و`HEARTBEAT.md` و`BOOTSTRAP.md`.
- يجعل الوكيل يتبع `BOOTSTRAP.md`: محادثة حرة الصياغة (وليست نموذج أسئلة وأجوبة ثابتًا) للاستقرار على اسم وشخصية وطابع.
- يكتب ما يتعلمه في `IDENTITY.md` و`USER.md` و`SOUL.md`.
- يحذف `BOOTSTRAP.md` بمجرد أن تبدو مساحة العمل مضبوطة، بحيث لا يُجرى هذا الطقس إلا مرة واحدة.

تُعد مساحة العمل مضبوطة بمجرد اختلاف `SOUL.md` أو `IDENTITY.md` أو `USER.md`
عن قالب البداية الخاص به، أو عند وجود مجلد `memory/`.

<Note>
يغطي `BOOTSTRAP.md` محادثة الهوية كاملةً. راجع محتوياته في
[قالب BOOTSTRAP.md](/ar/reference/templates/BOOTSTRAP).
</Note>

## عمليات تشغيل النماذج المضمّنة والمحلية

في عمليات تشغيل النماذج المضمّنة أو المحلية، يُبقي OpenClaw ملف `BOOTSTRAP.md` خارج
سياق النظام ذي الامتيازات. وفي التشغيل التفاعلي الأساسي الأول، يمرر مع ذلك
محتويات الملف عبر مطالبة المستخدم، كي تتمكن النماذج التي لا تستدعي
أداة `read` بموثوقية من إكمال الطقس. وإذا تعذّر على عملية التشغيل الحالية
الوصول بأمان إلى مساحة العمل، يتلقى الوكيل ملاحظة قصيرة عن تهيئة أولية محدودة
بدلًا من تحية عامة.

## تخطي التهيئة الأولية

لتخطي ذلك في مساحة عمل مزوّدة مسبقًا بالملفات الأولية، شغّل:

```bash
openclaw onboard --skip-bootstrap
```

## مكان التشغيل

تُجرى التهيئة الأولية دائمًا على مضيف Gateway. وإذا اتصل تطبيق macOS
بـ Gateway بعيد، فستوجد مساحة العمل وملفات تهيئتها الأولية على ذلك الجهاز
البعيد، لا على جهاز Mac.

<Note>
عندما يعمل Gateway على جهاز آخر، عدّل ملفات مساحة العمل على مضيف Gateway
(على سبيل المثال، `user@gateway-host:~/.openclaw/workspace`).
</Note>

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

- الإعداد الأولي لتطبيق macOS: [الإعداد الأولي](/ar/start/onboarding)
- بنية مساحة العمل: [مساحة عمل الوكيل](/ar/concepts/agent-workspace)
- محتويات القالب: [قالب BOOTSTRAP.md](/ar/reference/templates/BOOTSTRAP)