---
read_when:
    - درک آنچه در اولین اجرای عامل اتفاق می‌افتد
    - توضیح اینکه فایل‌های راه‌اندازی اولیه کجا قرار دارند
    - اشکال‌زدایی تنظیم هویت در فرایند راه‌اندازی اولیه
sidebarTitle: Bootstrapping
summary: فرایند راه‌اندازی اولیهٔ عامل که فضای کاری و فایل‌های هویتی را مقداردهی اولیه می‌کند
title: راه‌اندازی اولیه عامل
x-i18n:
    generated_at: "2026-05-06T09:43:18Z"
    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: [آنبوردینگ](/fa/start/onboarding)
- چیدمان فضای کاری: [فضای کاری عامل](/fa/concepts/agent-workspace)