openclaw onboard

راه‌اندازی هدایت‌شده‌ای که ابتدا استنتاج را برقرار می‌کند: دسترسی موجود به هوش مصنوعی را تشخیص می‌دهد، تکمیل زنده را الزامی می‌کند، فقط مسیر عملیاتی را ذخیره می‌کند و سپس OpenClaw را برای پیکربندی باقی موارد آغاز می‌کند. openclaw setup در سامانه‌های تازه یا هر زمان که یک گزینهٔ پذیرش اولیه وجود داشته باشد، به این جریان می‌رسد؛ سامانه‌های پیکربندی‌شده از openclaw setup خالی برای گفت‌وگوی عامل سامانه استفاده می‌کنند. openclaw setup --baseline فقط پیکربندی پایه/فضای کاری را می‌نویسد.

مثال‌ها

openclaw onboardopenclaw onboard --tuiopenclaw onboard --classicopenclaw onboard --modernopenclaw onboard --flow quickstartopenclaw onboard --flow manualopenclaw onboard --flow importopenclaw onboard --import-from hermes --import-source ~/.hermesopenclaw onboard --skip-bootstrapopenclaw onboard recommendations --jsonopenclaw onboard recommendations acknowledgeopenclaw onboard recommendations acknowledge --retry "<failed-id>"openclaw onboard recommendations refreshopenclaw onboard --mode remote --remote-url wss://gateway-host:18789

openclaw onboard recommendations تطبیق‌های در انتظارِ پیشنهاد برنامه را که هنگام پذیرش اولیه ذخیره شده‌اند می‌خواند. برای فهرست ماشین‌خوانِ مورد استفادهٔ راه‌اندازی اولیه، --json را اضافه کنید. این فرمان برنامه‌های نصب‌شده را دوباره اسکن نمی‌کند و مدلی را فراخوانی نمی‌کند. خروجی آن فقط شامل شناسه‌های نصب اعتبارسنجی‌شده، منبع و سطح است؛ عمداً نثر غیرقابل‌اعتماد بازارچه، دلایل مدل و برچسب‌های محلی برنامه را حذف می‌کند. پس از پاسخ‌دادن به پیشنهاد توصیه، فرمان فهرستی خالی برمی‌گرداند و اجراهای آیندهٔ پذیرش اولیه این مرحله را کاملاً رد می‌کنند. openclaw onboard recommendations refresh پیشنهاد ذخیره‌شده را پاک می‌کند تا اجرای بعدی پذیرش اولیه، برنامه‌های نصب‌شده را دوباره اسکن و پیشنهادی جدید ایجاد کند.

فضاهای کاری تازه، انتخاب توصیه را به گفت‌وگوی راه‌اندازی اولیه واگذار می‌کنند. پس از آنکه این گفت‌وگو انتخاب‌های کاربر را پردازش کرد، openclaw onboard recommendations acknowledge پیشنهاد ذخیره‌شده را پاسخ‌داده‌شده علامت می‌زند. تأیید دریافت هم‌توان است. اگر نصب انتخاب‌شده‌ای ناموفق باشد، هر شناسهٔ مبهم ناموفق را با --retry <id...> ارسال کنید؛ تطبیق‌های موفق و ردشده مصرف می‌شوند، درحالی‌که تطبیق‌های ناموفق برای اجرای بعدی پذیرش اولیه در انتظار می‌مانند. شناسه‌های ناشناخته بدون تغییر پیشنهاد ذخیره‌شده با خطا مواجه می‌شوند. پس از قطع‌شدن نصب Skills از ClawHub، هدف موجود فقط زمانی موفق محسوب می‌شود که openclaw skills verify "@owner/slug" برای همان شناسهٔ توصیهٔ واجد نام ناشر موفق شود و خروجی JSON آن openclaw.resolution.source: "installed" را گزارش کند. صرفاً تأیید رجیستری، اثبات نصب محلی نیست. در غیر این صورت، آن شناسه را با --retry در انتظار نگه دارید و Skills موجود را بازنویسی نکنید.

• --classic: جادوگر کامل گام‌به‌گام را باز می‌کند. نمی‌توان آن را با --non-interactive ترکیب کرد؛ برای راه‌اندازی خودکار، --classic را حذف کنید.
• --flow quickstart: جادوگر کلاسیک را با حداقل درخواست‌ها باز می‌کند، به‌طور پیش‌فرض از احراز هویت توکنی استفاده می‌کند و وقتی هیچ اعتبارنامهٔ ذخیره‌شده یا صریحی قابل‌اعمال نباشد، یک توکن تولید می‌کند. پرچم‌های صریح Gateway محلی مانند --gateway-port، --gateway-bind، --gateway-auth و --tailscale مقادیر متناظر ذخیره‌شده یا پیش‌فرض شروع سریع را لغو می‌کنند؛ گزینه‌های حذف‌شده مقادیر فعلی خود را حفظ می‌کنند.
• --flow manual (نام مستعار advanced): جادوگر کلاسیک را با درخواست‌های کامل برای درگاه، اتصال و احراز هویت باز می‌کند.
• --flow import: یک ارائه‌دهندهٔ مهاجرت تشخیص‌داده‌شده را (برای مثال Hermes از طریق --import-from hermes) روی یک راه‌اندازی تازه اجرا می‌کند. پس از تأیید، پذیرش اولیه پیکربندی، اعتبارنامه‌ها، فایل‌های فضای کاری، حافظه و Skills را زیر اهداف موقت خصوصی آماده می‌کند؛ استنتاج واردشده باید پیش از ارتقای فضای کاری و وضعیت عامل و ثبت پیکربندی، یک تکمیل زنده را با موفقیت پشت سر بگذارد. خرابی یا لغو پیش از ارتقا، هدف زنده را دست‌نخورده باقی می‌گذارد. مراحل فعال‌سازی خارجی که قابل بازگردانی نیستند، مانند نصب Plugin مربوط به Codex، پس از آن اجرا می‌شوند و از گزارش مهاجرت قابل تلاش مجدد باقی می‌مانند. اگر پیکربندی، اعتبارنامه‌ها، نشست‌ها یا وضعیت فضای کاری وجود دارند، ابتدا آن‌ها را بازنشانی کنید. برای طرح‌های اجرای آزمایشی، حالت بازنویسی، پشتیبان‌های تأییدشده، گزارش‌ها و نگاشت‌های دقیق از openclaw migrate استفاده کنید.
• --remote-url و --remote-token: مرحلهٔ Gateway راه دور کلاسیک را از پیش پر می‌کنند و مقادیر راه دور ذخیره‌شده را برای این اجرا لغو می‌کنند. تغییر URL باعث استفادهٔ مجدد از اعتبارنامه‌های ذخیره‌شده نمی‌شود، مگر اینکه توکنی نیز ارسال کنید. توکن در درخواست‌ها پوشیده می‌ماند و از انتخاب موجود جادوگر برای ذخیره‌سازی متن ساده یا SecretRef پیروی می‌کند.
• --tailscale-reset-on-exit و --no-tailscale-reset-on-exit: صراحتاً کنترل می‌کنند که آیا پیکربندی Tailscale Serve یا Funnel هنگام خروج Gateway بازنشانی شود. حذف هر دو، تنظیم فعلی را هنگام اجراهای مجدد غیرتعاملی حفظ می‌کند.
• --modern یک نام مستعار سازگاری برای دستیار راه‌اندازی مکالمه‌ای OpenClaw است. این گزینه از همان دروازهٔ استنتاج زندهٔ openclaw setup استفاده می‌کند و فقط --workspace، --accept-risk، --non-interactive و --json را می‌پذیرد. سایر پرچم‌های راه‌اندازی به‌جای نادیده‌گرفته‌شدن بی‌سروصدا، رد می‌شوند.

جریان هدایت‌شده

openclaw onboard ساده، جریان هدایت‌شده را آغاز می‌کند. ابتدا اعلان امنیتی را نمایش می‌دهد، سپس یک پرسش مطرح می‌کند: دسترسی کامل (توصیه‌شده — راه‌اندازی به‌طور خودکار برنامه‌های هوش مصنوعی، کلیدها و محیط‌های اجرای محلی را جست‌وجو می‌کند) یا ابتدا بپرس (راه‌اندازی پیش از جست‌وجو فقط یک‌بار اجازه می‌گیرد یا امکان پیکربندی دستی را فراهم می‌کند). این انتخاب به‌صورت wizard.accessMode ذخیره می‌شود. با مجازبودن کشف، پذیرش اولیه دسترسی موجود به هوش مصنوعی را از طریق مدل‌های پیکربندی‌شده، متغیرهای محیطی کلید API و CLIهای محلی پشتیبانی‌شده تشخیص می‌دهد، سپس گزینهٔ توصیه‌شده را با یک تکمیل واقعی آزمایش می‌کند. اگر گزینه‌ای ناموفق باشد، پذیرش اولیه بی‌سروصدا گزینهٔ قابل‌استفادهٔ بعدی را امتحان می‌کند و هر موردی را که پاسخ نداده است در یک خط خلاصه می‌کند؛ مسیر عملیاتی با گزینه‌ای تک‌کلیدی برای مشاهدهٔ همهٔ موارد دیگر اعلام می‌شود.

اگر تشخیص خودکار به نتیجه نرسد، انتخاب‌گر ارائه‌دهنده ابتدا OpenAI، Anthropic، xAI (Grok)، Google و OpenRouter را نمایش می‌دهد. برای مشاهدهٔ همهٔ ارائه‌دهندگان پشتیبانی‌شدهٔ دیگر که بر اساس ارائه‌دهنده گروه‌بندی شده‌اند، More… را انتخاب کنید؛ سپس منطقه‌ها، طرح‌ها و روش‌های احراز هویت در منوی دوم ظاهر می‌شوند. ورود پشتیبانی‌شده از طریق مرورگر یا دستگاه و روش‌های پوشیدهٔ کلید API یا توکن از همان مسیر تکمیل زنده استفاده می‌کنند. OpenClaw فقط پس از موفقیت آزمایش، مسیر مدل تأییدشده و اعتبارنامهٔ آن را ذخیره می‌کند؛ گزینهٔ ناموفق مدل پیکربندی‌شده را جایگزین نمی‌کند و اعتبارنامهٔ امتحان‌شده را ذخیره نمی‌کند. برای خروج بدون آغاز OpenClaw، Skip for now را انتخاب کنید و هر زمان آماده بودید openclaw onboard را دوباره اجرا کنید. راه‌اندازی فضای کاری و Gateway تا آغاز OpenClaw بدون تغییر می‌ماند.

در حالت هدایت‌شده، --workspace <dir> فضای کاری پیشنهادی OpenClaw و زمینهٔ استنتاج ایزوله را تأمین می‌کند. تا زمانی که پیشنهاد راه‌اندازی OpenClaw را تأیید نکنید، ذخیره نمی‌شود. پذیرش اولیهٔ کلاسیک و غیرتعاملی، فضای کاری را از طریق جریان عادی راه‌اندازی خود ذخیره می‌کنند. در اجرای مجدد با فهرست عوامل موجود، پذیرش اولیه فضای کاری ناوگان پیکربندی‌شده را حفظ می‌کند: جادوگر کلاسیک هر دو مسیر را نمایش می‌دهد و پیش از انتقال آن، تأیید صریح می‌خواهد؛ درحالی‌که راه‌اندازی غیرتعاملی هشدار می‌دهد و مقدار فعلی را حفظ می‌کند.

پس از موفقیت استنتاج، پذیرش اولیه وجود حافظه‌های ابزارهای محلی پشتیبانی‌شدهٔ هوش مصنوعی را بررسی می‌کند: حافظهٔ خودکار Claude Code، حافظه‌های تجمیع‌شدهٔ Codex و فایل‌های حافظهٔ Hermes. اگر موردی پیدا شود، صفحه‌ای پیشنهاد می‌دهد آن‌ها را برای بازیابی نمایه‌شده در فضای کاری عامل، زیر memory/imports/ کپی کنید. هیچ‌چیز بدون تأیید وارد نمی‌شود، فایل‌هایی که قبلاً وارد شده‌اند نادیده گرفته می‌شوند و همیشه می‌توانید بعداً از صفحهٔ واردکردن حافظه در Control UI استفاده کنید که همان دامنهٔ محدود به حافظه را ارائه می‌دهد. (اجرای کامل openclaw migrate گسترده‌تر است: می‌تواند پیکربندی، Skills و اعتبارنامه‌ها را نیز وارد کند.) جادوگر کلاسیک پس از آماده‌سازی فضای کاری، همین صفحه را نمایش می‌دهد.

پس از موفقیت استنتاج (و پیشنهاد واردکردن حافظه)، پذیرش اولیهٔ هدایت‌شده راه‌اندازی استاندارد را به‌طور خودکار اعمال می‌کند — فضای کاری، Gateway و نشست‌ها؛ همان طرحی که گفت‌وگوی مکالمه‌ای openclaw setup در پاسخ به "yes" اعمال می‌کند — سپس توصیه‌های Plugin و Skills را بر اساس برنامه‌های نصب‌شده ارائه می‌دهد؛ نام برنامه‌ها از طریق مدل پیکربندی‌شده و جست‌وجوی ClawHub تطبیق داده می‌شوند و این مرحله را می‌توان با wizard.appRecommendations غیرفعال کرد. سپس در نشست دسکتاپ macOS، Linux یا Windows، داشبورد احرازشدهٔ Control UI را باز می‌کند و تا 60 ثانیه منتظر اتصال کارخواه مرورگر می‌ماند. در Linux بدون نمایشگر یا از طریق SSH، یک URL برجسته و قابل رونوشت‌چسباندن برای داشبورد چاپ می‌کند که برای Gateway حلقهٔ بازگشتی شامل فرمان هدایت درگاه SSH است و تا پنج دقیقه منتظر می‌ماند. اتصال موفق در مرورگر ادامه پیدا می‌کند؛ Gateway دسترس‌ناپذیر یا پایان مهلت به همان راه خروج ترمینال قبلی بازمی‌گردد. برای ردکردن تحویل به مرورگر و اجبار آن راه خروج ترمینال، --tui را ارسال کنید. اگر اعمال راه‌اندازی ناموفق باشد، پذیرش اولیه به گفت‌وگوی مکالمه‌ای OpenClaw بازمی‌گردد تا کار به‌صورت تعاملی تکمیل شود. کانال‌ها، عامل‌ها، Pluginها و دیگر قابلیت‌های اختیاری همچنان در حوزهٔ گفت‌وگوی OpenClaw هستند: openclaw را اجرا کنید و از open channel wizard for <channel> برای واگذاری جمع‌آوری اعتبارنامهٔ کانال به یک جادوگر ترمینال پوشیده استفاده کنید. برای تغییر ارائه‌دهندهٔ مدل یا احراز هویت آن، از OpenClaw خارج شوید و openclaw onboard را اجرا کنید؛ OpenClaw جریان‌های ارائه‌دهندهٔ هدایت‌شده یا کلاسیک را باز نمی‌کند.

در یک نصب پیکربندی‌شده، اجرای دوبارهٔ openclaw onboard ابتدا مدل پیش‌فرض فعلی را تأیید می‌کند؛ بنابراین همان جریان به‌عنوان مرحلهٔ تأیید و تعمیر عمل می‌کند — راه‌اندازی را دوباره اعمال، نصب یا سرویس Gateway را بازراه‌اندازی نمی‌کند. اگر این بررسی ناموفق باشد، مدل پیکربندی‌شده هرگز به‌طور خودکار جایگزین نمی‌شود — پذیرش اولیه متوقف می‌شود و دربارهٔ نحوهٔ ادامه می‌پرسد. بررسی خارج از فضای کاری انجام می‌شود، بنابراین مدلی که توسط Plugin فضای کاری ارائه شده است ممکن است اینجا ناموفق باشد، هرچند همچنان در عامل کار کند. برای احراز هویت ویژهٔ ارائه‌دهنده، کانال‌ها، Skills، راه‌اندازی Gateway راه دور، واردکردن‌ها یا کنترل‌های کامل Gateway از openclaw onboard --classic استفاده کنید. برای راه‌اندازی و تعمیر مکالمه‌ایِ غیرمرتبط با استنتاج، openclaw setup را اجرا کنید؛ openclaw onboard --modern یک نام مستعار سازگاری از طریق همان دروازهٔ استنتاج است. جادوگر کلاسیک می‌تواند در صورت تمایل مدل پیش‌فرض را با تکمیل زنده تأیید کند، اما OpenClaw تا زمانی که بررسی استنتاج زندهٔ خودش موفق نشود، آغاز نخواهد شد.

در یک ترمینال تعاملی، openclaw خالی (بدون زیرفرمان) بر اساس وضعیت پیکربندی مسیریابی می‌شود:

• اگر فایل پیکربندی فعال وجود نداشته باشد یا هیچ تنظیم نوشته‌شده‌ای نداشته باشد (خالی یا فقط شامل فراداده)، پذیرش اولیهٔ هدایت‌شده را آغاز می‌کند.
• اگر فایل پیکربندی وجود داشته باشد اما اعتبارسنجی آن ناموفق باشد، مسیر پذیرش اولیهٔ کلاسیک را با راهنمایی openclaw doctor آغاز می‌کند. OpenClaw به استنتاج عملیاتی نیاز دارد و برای تعمیر این وضعیت پیش از استنتاج استفاده نمی‌شود.
• اگر فایل پیکربندی معتبر باشد، TUI عادی عامل را باز می‌کند. یک Gateway پیکربندی‌شدهٔ در دسترس که عامل و مدل دارد، بدون پذیرش اولیه یا OpenClaw مستقیماً به آن رابط می‌رود. در یک نصب پیکربندی‌شده، با /openclaw درون TUI یا openclaw setup به OpenClaw دسترسی پیدا کنید.

ws:// متن ساده برای حلقهٔ بازگشتی، نشانی‌های IP خصوصی، .local و URLهای Gateway مربوط به *.ts.net در Tailnet پذیرفته می‌شود. برای دیگر نام‌های قابل‌اعتماد DNS خصوصی، OPENCLAW_ALLOW_INSECURE_PRIVATE_WS=1 را در محیط فرایند پذیرش اولیه تنظیم کنید.

بازنشانی

openclaw onboard --resetopenclaw onboard --reset --reset-scope full

--reset پیش از اجرای راه‌اندازی، وضعیت را پاک می‌کند. --reset-scope میزان آن را کنترل می‌کند: config (فقط پیکربندی)، config+creds+sessions (حالت پیش‌فرض هنگامی که --reset بدون دامنه ارسال شود)، یا full (فضای کاری را نیز بازنشانی می‌کند). بازنشانی فضای کاری فقط با --reset-scope full انجام می‌شود.

زبان و منطقه

فرایند آغازین تعاملی برای متن‌های ثابت راه‌اندازی از زبان و منطقهٔ جادوگر CLI استفاده می‌کند. نخستین مقدار غیرخالی در ترتیب زیر استفاده می‌شود:

1. OPENCLAW_LOCALE
2. LC_ALL
3. LC_MESSAGES
4. LANG
5. بازگشت به انگلیسی

زبان‌ها و مناطق پشتیبانی‌شدهٔ جادوگر عبارت‌اند از en، zh-CN و zh-TW. مقادیر زبان و منطقه می‌توانند از قالب‌های دارای زیرخط یا پسوند POSIX مانند zh_CN.UTF-8 استفاده کنند. نام محصولات، نام فرمان‌ها، کلیدهای پیکربندی، URLها، شناسه‌های ارائه‌دهنده، شناسه‌های مدل و برچسب‌های Plugin/کانال بدون تغییر می‌مانند.

OPENCLAW_LOCALE=zh-CN openclaw onboardOPENCLAW_LOCALE=en openclaw onboard # بازنویسی صریح به انگلیسی

راه‌اندازی غیرتعاملی

--non-interactive به --accept-risk نیاز دارد (تأیید می‌کند که عامل‌ها قدرتمندند و دسترسی کامل به سیستم پرخطر است). مقدار پیش‌فرض --mode برابر local است.

openclaw onboard --non-interactive \  --auth-choice custom-api-key \  --custom-base-url "https://llm.example.com/v1" \  --custom-model-id "foo-large" \  --custom-api-key "$CUSTOM_API_KEY" \  --secret-input-mode plaintext \  --custom-compatibility openai \  --custom-image-input

--custom-api-key اختیاری است؛ اگر حذف شود، فرایند آغازین CUSTOM_API_KEY را در محیط بررسی می‌کند. OpenClaw شناسه‌های رایج مدل‌های بینایی (GPT-4o/4.1/5.x، Claude 3/4، Gemini، Qwen-VL، LLaVA، Pixtral و موارد مشابه) را به‌طور خودکار دارای قابلیت تصویر علامت‌گذاری می‌کند. برای شناسه‌های سفارشی ناشناختهٔ بینایی، --custom-image-input را ارسال کنید، یا برای اجبار فرادادهٔ فقط‌متنی از --custom-text-input استفاده کنید. برای نقاط پایانی سازگار با OpenAI که از /v1/responses پشتیبانی می‌کنند اما از /v1/chat/completions پشتیبانی نمی‌کنند، از --custom-compatibility openai-responses استفاده کنید؛ مقادیر معتبر عبارت‌اند از openai (پیش‌فرض)، openai-responses و anthropic.

LM Studio همچنین یک پرچم کلید مختص ارائه‌دهنده دارد:

openclaw onboard --non-interactive \  --auth-choice lmstudio \  --custom-base-url "http://localhost:1234/v1" \  --custom-model-id "qwen/qwen3.5-9b" \  --lmstudio-api-key "$LM_API_TOKEN" \  --accept-risk

Ollama غیرتعاملی:

openclaw onboard --non-interactive \  --auth-choice ollama \  --custom-base-url "http://ollama-host:11434" \  --custom-model-id "qwen3.5:27b" \  --accept-risk

مقدار پیش‌فرض --custom-base-url برابر http://127.0.0.1:11434 است. --custom-model-id اختیاری است؛ اگر حذف شود، فرایند آغازین از پیش‌فرض‌های پیشنهادی Ollama استفاده می‌کند. شناسه‌های مدل ابری مانند kimi-k2.5:cloud نیز در اینجا کار می‌کنند.

کلیدهای ارائه‌دهنده را به‌جای متن ساده به‌صورت ارجاع ذخیره کنید:

openclaw onboard --non-interactive \  --auth-choice openai-api-key \  --secret-input-mode ref \  --accept-risk

با --secret-input-mode ref، فرایند آغازین به‌جای مقادیر کلیدِ متن ساده، ارجاع‌های مبتنی بر محیط می‌نویسد: برای ارائه‌دهندگان مبتنی بر نمایهٔ احراز هویت، keyRef: { source: "env", provider: "default", id: <envVar> } نوشته می‌شود؛ برای ارائه‌دهندگان سفارشی نیز models.providers.<id>.apiKey به همان شیوه نوشته می‌شود (برای مثال { source: "env", provider: "default", id: "CUSTOM_API_KEY" }). قرارداد: متغیر محیطی ارائه‌دهنده را در محیط فرایند آغازین تنظیم کنید (برای مثال OPENAI_API_KEY) و مگر آنکه آن متغیر محیطی تنظیم شده باشد، پرچم کلید درون‌خطی را نیز ارسال نکنید؛ مقدار پرچم بدون متغیر محیطی متناظر، با راهنمایی فوراً ناموفق می‌شود.

احراز هویت Gateway (غیرتعاملی)

• --gateway-auth token --gateway-token <token> یک توکن متن ساده ذخیره می‌کند. token حالت پیش‌فرض احراز هویت است.
• --gateway-auth token --gateway-token-ref-env <name>، gateway.auth.token را به‌عنوان SecretRef محیطی ذخیره می‌کند. به یک متغیر محیطی غیرخالی با همان نام در محیط فرایند آغازین نیاز دارد.
• --gateway-token و --gateway-token-ref-env متقابلاً انحصاری‌اند.
• با --install-daemon: یک gateway.auth.token مدیریت‌شده با SecretRef اعتبارسنجی می‌شود، اما به‌صورت متن سادهٔ حل‌شده در فرادادهٔ محیط سرویس ناظر ماندگار نمی‌شود؛ اگر ارجاع حل‌نشده باشد، نصب با راهنمای رفع مشکل به‌صورت بسته ناموفق می‌شود. اگر هر دو gateway.auth.token و gateway.auth.password پیکربندی شده باشند و gateway.auth.mode تنظیم نشده باشد، نصب تا زمان تنظیم صریح حالت مسدود می‌شود.
• فرایند آغازین محلی، gateway.mode="local" را در پیکربندی می‌نویسد. اگر فایل پیکربندی بعدی فاقد gateway.mode باشد، این وضعیت نشان‌دهندهٔ آسیب‌دیدگی پیکربندی یا ویرایش دستی ناقص است، نه یک میان‌بر معتبر برای حالت محلی.
• فرایند آغازین محلی، Pluginهای قابل‌دریافتی را که مسیر راه‌اندازی انتخاب‌شده نیاز دارد نصب می‌کند (برای مثال Plugin زمان‌اجرای Codex یا Copilot برای آن گزینه‌های احراز هویت). فرایند آغازین راه‌دور فقط اطلاعات اتصال Gateway راه‌دور را می‌نویسد و هرگز بسته‌های Plugin محلی را نصب نمی‌کند.
• --allow-unconfigured یک راه فرار جداگانهٔ openclaw gateway run است؛ به فرایند آغازین اجازه نمی‌دهد gateway.mode را نادیده بگیرد.

export OPENAI_API_KEY="your-provider-key"export OPENCLAW_GATEWAY_TOKEN="your-token"openclaw onboard --non-interactive \  --mode local \  --auth-choice openai-api-key \  --secret-input-mode ref \  --gateway-auth token \  --gateway-token-ref-env OPENCLAW_GATEWAY_TOKEN \  --accept-risk

سلامت Gateway محلی

• مگر آنکه --skip-health را ارسال کنید، فرایند آغازین پیش از خروج موفقیت‌آمیز منتظر دسترس‌پذیری Gateway محلی می‌ماند.
• --install-daemon ابتدا مسیر نصب Gateway مدیریت‌شده را آغاز می‌کند. بدون آن، یک Gateway محلی باید از قبل در حال اجرا باشد (برای مثال openclaw gateway run).
• --skip-health درصورتی‌که در خودکارسازی فقط نوشتن پیکربندی/فضای کاری/راه‌انداز اولیه را بخواهید، انتظار را نادیده می‌گیرد.
• --skip-bootstrap، agents.defaults.skipBootstrap: true را تنظیم می‌کند و ایجاد AGENTS.md، SOUL.md، TOOLS.md، IDENTITY.md، USER.md، HEARTBEAT.md و BOOTSTRAP.md را نادیده می‌گیرد.
• در Windows بومی، --install-daemon ابتدا Scheduled Tasks را امتحان می‌کند و اگر ایجاد وظیفه رد شود، به یک مورد ورودِ پوشهٔ Startup برای هر کاربر بازمی‌گردد.

حالت ارجاع تعاملی

• هنگام درخواست، استفاده از ارجاع راز را انتخاب کنید، سپس متغیر محیطی یا یک ارائه‌دهندهٔ راز پیکربندی‌شده (file یا exec) را برگزینید.
• فرایند آغازین پیش از ذخیرهٔ ارجاع، یک اعتبارسنجی سریع پیش‌ازاجرا انجام می‌دهد و در صورت شکست امکان تلاش مجدد را فراهم می‌کند.

گزینه‌های نقطهٔ پایانی Z.AI

# انتخاب نقطهٔ پایانی بدون اعلانopenclaw onboard --non-interactive \  --auth-choice zai-coding-global \  --zai-api-key "$ZAI_API_KEY" # دیگر گزینه‌های نقطهٔ پایانی Z.AI: zai-coding-cn، zai-global، zai-cn

Mistral:

openclaw onboard --non-interactive \  --auth-choice mistral-api-key \  --mistral-api-key "$MISTRAL_API_KEY"

پرچم‌های غیرتعاملی اضافی

احراز هویت مدل مبتنی بر توکن (همراه با --auth-choice token استفاده می‌شود):

Cloudflare AI Gateway: --cloudflare-ai-gateway-account-id <id>، --cloudflare-ai-gateway-gateway-id <id>.

کنترل نصب دیمن: --no-install-daemon / --skip-daemon (نام‌های مستعار؛ نصب سرویس Gateway را نادیده می‌گیرند)، --daemon-runtime <node>.

Skills: --node-manager <npm|pnpm|bun> (پیش‌فرض npm)، --skip-skills.

راه‌اندازی رابط کاربری و هوک: --skip-ui (اعلان‌های Control UI/TUI را نادیده می‌گیرد)، --skip-hooks (راه‌اندازی webhook/هوک را نادیده می‌گیرد)، --skip-channels، --skip-search.

خروجی: --suppress-gateway-token-output خروجی Gateway/رابط کاربری حاوی توکن را سرکوب می‌کند (راهنمای توکن، URL ورود خودکار با توکن جاسازی‌شده و اجرای خودکار Control UI)؛ برای پایانه‌های مشترک و CI مفید است.

پیش‌فیلترکردن ارائه‌دهنده

هنگامی که یک گزینهٔ احراز هویت بر ارائه‌دهندهٔ ترجیحی دلالت دارد، فرایند آغازین انتخاب‌گرهای مدل پیش‌فرض و فهرست مجاز را از پیش به مدل‌های همان ارائه‌دهنده محدود می‌کند. این فیلتر همچنین با دیگر ارائه‌دهندگان متعلق به همان Plugin مطابقت دارد، که گونه‌های Coding Plan مانند volcengine/volcengine-plan و byteplus/byteplus-plan را پوشش می‌دهد. اگر فیلتر ارائه‌دهندهٔ ترجیحی هیچ مدل بارگذاری‌شده‌ای برنگرداند، فرایند آغازین به‌جای خالی گذاشتن انتخاب‌گر، به فهرست بدون فیلتر بازمی‌گردد.

پیگیری‌های جست‌وجوی وب

برخی ارائه‌دهندگان جست‌وجوی وب در طول فرایند آغازین، اعلان‌های پیگیری مختص ارائه‌دهنده را فعال می‌کنند:

• Grok می‌تواند راه‌اندازی اختیاری x_search را با همان احراز هویت xAI و انتخاب مدل x_search پیشنهاد دهد.
• Kimi می‌تواند دربارهٔ منطقهٔ API سرویس Moonshot (api.moonshot.ai در برابر api.moonshot.cn) و مدل پیش‌فرض جست‌وجوی وب Kimi پرس‌وجو کند.

رفتارهای دیگر

• رفتار دامنهٔ پیام مستقیم در فرایند آغازین محلی: مرجع راه‌اندازی CLI.
• سریع‌ترین گفت‌وگوی نخست: openclaw dashboard (Control UI، بدون راه‌اندازی کانال).
• ارائه‌دهندهٔ سفارشی: هر نقطهٔ پایانی سازگار با OpenAI یا Anthropic، از جمله ارائه‌دهندگان میزبانی‌شدهٔ فهرست‌نشده را متصل کنید. برای تشخیص خودکار از طریق یک کاوش زنده، از سازگاری ناشناخته استفاده کنید.
• اگر وضعیت Hermes شناسایی شود، فرایند آغازین یک جریان مهاجرت پیشنهاد می‌دهد (به --flow import در بالا مراجعه کنید).

فرمان‌های پیگیری رایج

بعداً برای تغییرات هدفمند بدون استنتاج از openclaw configure و برای راه‌اندازی صرفاً کانال از openclaw channels add استفاده کنید. برای تغییرات ارائه‌دهندهٔ مدل یا مسیر احراز هویت، به‌جای آن openclaw onboard را اجرا کنید.

openclaw channels addopenclaw configureopenclaw agents add <name>