راه‌اندازی اولیه عامل

راه‌اندازی اولیه آیین اجرای نخست است که فضای کاری یک عامل جدید را مقداردهی می‌کند و عامل را در انتخاب یک هویت راهنمایی می‌کند. این فرایند فقط یک‌بار، بلافاصله پس از ورود اولیه و در نخستین نوبت واقعی عامل اجرا می‌شود.

چه اتفاقی می‌افتد

در نخستین اجرا روی یک فضای کاری کاملاً جدید (پیش‌فرض ~/.openclaw/workspace)، OpenClaw:

• فایل‌های AGENTS.md، SOUL.md، TOOLS.md، IDENTITY.md، USER.md، HEARTBEAT.md و BOOTSTRAP.md را مقداردهی اولیه می‌کند.
• عامل را ملزم می‌کند یک توالی تولد سه‌مرحله‌ای و محدود را دنبال کند: می‌پرسد دوست دارید چه نامی روی آن بگذارید، یک جمله کوتاه درباره شخصیت‌وحال‌وهوای خود بیان می‌کند و می‌پرسد آیا مجموعه حداقلی و توصیه‌شده Pluginها را می‌خواهید یا بیشترین امکانات رفاهی را.
• هویت توافق‌شده را دو بار ماندگار می‌کند: در IDENTITY.md و SOUL.md (آنچه عامل درباره خودش می‌خواند) و از طریق openclaw agents set-identity (آنچه کانال‌ها و رابط کاربری نمایش می‌دهند).
• توصیه‌های برنامه را که پیش‌تر هنگام ورود اولیه ذخیره شده‌اند، بدون اسکن مجدد می‌خواند. Pluginهای رسمی از openclaw plugins install <id> استفاده می‌کنند؛ Skillsهای شخص ثالث ClawHub همچنان مستلزم انتخاب صریح هستند. پس از رسیدگی به انتخاب، عامل پیشنهاد ذخیره‌شده را تأیید می‌کند تا هرگز دوباره آن را نپرسد.
• پس از آنکه فضای کاری پیکربندی‌شده به نظر برسد، BOOTSTRAP.md را حذف می‌کند تا این آیین فقط یک‌بار اجرا شود.

یک فضای کاری زمانی پیکربندی‌شده محسوب می‌شود که SOUL.md، IDENTITY.md یا USER.md از قالب آغازین خود متفاوت شده باشد، یا پوشه‌ای به نام memory/ وجود داشته باشد.

اجراهای مدل تعبیه‌شده و محلی

برای اجراهای مدل تعبیه‌شده یا محلی، OpenClaw فایل BOOTSTRAP.md را از بافت سیستمی دارای دسترسی ویژه خارج نگه می‌دارد. در نخستین اجرای تعاملی اصلی، همچنان محتوای فایل را از طریق پیام کاربر ارسال می‌کند تا مدل‌هایی که ابزار read را به‌طور قابل‌اعتماد فراخوانی نمی‌کنند نیز بتوانند این آیین را تکمیل کنند. اگر اجرای فعلی نتواند به‌طور ایمن به فضای کاری دسترسی داشته باشد، عامل به‌جای یک خوشامدگویی عمومی، یادداشت کوتاهی درباره راه‌اندازی اولیه محدود دریافت می‌کند.

نادیده‌گرفتن راه‌اندازی اولیه

برای نادیده‌گرفتن این مرحله در یک فضای کاری ازپیش‌مقداردهی‌شده، اجرا کنید:

openclaw onboard --skip-bootstrap

محل اجرا

راه‌اندازی اولیه همیشه روی میزبان Gateway اجرا می‌شود. اگر برنامه macOS به یک Gateway راه‌دور متصل شود، فضای کاری و فایل‌های راه‌اندازی اولیه آن روی همان دستگاه راه‌دور قرار دارند، نه روی Mac.

مستندات مرتبط

• ورود اولیه برنامه macOS: ورود اولیه
• چیدمان فضای کاری: فضای کاری عامل
• محتوای قالب: قالب BOOTSTRAP.md