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

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

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

در نخستین اجرا روی یک فضای کاری کاملاً جدید (پیش‌فرض ~/.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/ وجود داشته باشد.

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

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

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

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

openclaw onboard --skip-bootstrap

محل اجرا

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

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

• آماده‌سازی اولیه برنامه macOS: آماده‌سازی اولیه
• چیدمان فضای کاری: فضای کاری عامل
• محتوای الگو: الگوی BOOTSTRAP.md