---
read_when:
    - فهم ما يحدث عند تشغيل الوكيل لأول مرة
    - توضيح مكان وجود ملفات التمهيد
    - تصحيح أخطاء إعداد الهوية أثناء الإعداد الأولي
sidebarTitle: Bootstrapping
summary: إجراء تمهيد الوكيل الذي يهيئ مساحة العمل وملفات الهوية
title: تمهيد الوكيل
x-i18n:
    generated_at: "2026-05-06T08:14:03Z"
    model: gpt-5.5
    provider: openai
    source_hash: e25f05ca47184068b87f0bf8b7dea1c427f4ed48edde170a74888d586b8a606d
    source_path: start/bootstrapping.md
    workflow: 16
---

التمهيد هو طقس **التشغيل الأول** الذي يجهز مساحة عمل الوكيل ويجمع تفاصيل الهوية. يحدث ذلك بعد الإعداد الأولي، عندما يبدأ الوكيل لأول مرة.

## ما الذي يفعله التمهيد

في أول تشغيل للوكيل، يمهّد OpenClaw مساحة العمل (الافتراضية
`~/.openclaw/workspace`):

- يضيف ملفات `AGENTS.md` و`BOOTSTRAP.md` و`IDENTITY.md` و`USER.md` الأولية.
- يشغّل طقس سؤال وجواب قصيرا (سؤال واحد في كل مرة).
- يكتب الهوية والتفضيلات إلى `IDENTITY.md` و`USER.md` و`SOUL.md`.
- يزيل `BOOTSTRAP.md` عند الانتهاء حتى لا يعمل إلا مرة واحدة.

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

## تخطي التمهيد

لتخطي ذلك لمساحة عمل مهيأة مسبقا، شغّل `openclaw onboard --skip-bootstrap`.

## أين يعمل

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

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

## مستندات ذات صلة

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