---
read_when:
    - درک آنچه در نخستین اجرای عامل رخ می‌دهد
    - توضیح محل قرارگیری فایل‌های راه‌اندازی اولیه
    - اشکال‌زدایی راه‌اندازی هویت در فرایند شروع‌به‌کار
sidebarTitle: Bootstrapping
summary: آیین راه‌اندازی اولیه عامل که فایل‌های فضای کاری و هویت را ایجاد می‌کند
title: راه‌اندازی اولیه عامل
x-i18n:
    generated_at: "2026-07-12T10:52:55Z"
    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](/fa/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: [آماده‌سازی اولیه](/fa/start/onboarding)
- چیدمان فضای کاری: [فضای کاری عامل](/fa/concepts/agent-workspace)
- محتوای الگو: [الگوی BOOTSTRAP.md](/fa/reference/templates/BOOTSTRAP)