CLI commands
راهاندازی
openclaw setup
openclaw setup همان فرایند هدایتشدهٔ راهاندازی اولیهٔ openclaw onboard را اجرا میکند:
ابتدا استنتاج را اعتبارسنجی و ذخیره میکند، سپس Crestodian را برای پیکربندی
فضای کاری، Gateway، کانالها، Skills و سلامت سامانه راهاندازی میکند. زمانی از --baseline استفاده کنید که
فقط میخواهید پوشههای پیکربندی/فضای کاری را بدون ویزارد مقداردهی اولیه کنید.
در حالت هدایتشده، --workspace <dir> فضای کاری پیشنهادی به Crestodian است؛
این مقدار فقط پس از تأیید پیشنهاد شما ذخیره میشود. راهاندازی پایه، کلاسیک و
غیرتعاملی، فضای کاری ارائهشده را از طریق فرایند عادی خود ذخیره میکنند.
setup همان پرچمهای راهاندازی اولیهٔ openclaw onboard را میپذیرد، از جمله
احراز هویت (--auth-choice، --token، پرچمهای کلید ارائهدهنده)، Gateway
(--gateway-port، --gateway-bind، --gateway-auth، --install-daemon)،
Tailscale (--tailscale)، بازنشانی (--reset، --reset-scope)، جریان
(--flow quickstart|advanced|manual|import) و پرچمهای رد کردن
(--skip-channels، --skip-skills، --skip-bootstrap، --skip-search،
--skip-health، --skip-ui، --skip-hooks). برای مرجع کامل پرچمها و
نمونههای غیرتعاملی، به راهاندازی اولیه و
خودکارسازی CLI مراجعه کنید. openclaw onboard --modern نام مستعار
سازگاری برای دستیار Crestodian با الزام استنتاج است و معادلی در setup ندارد.
گزینهها
| پرچم | توضیحات |
|---|---|
--workspace <dir> |
پیشنهاد فضای کاری در حالت هدایتشده؛ در راهاندازی پایه، کلاسیک و غیرتعاملی مستقیماً ذخیره میشود. |
--baseline |
پوشههای پایهٔ پیکربندی/فضای کاری/نشست را بدون راهاندازی اولیه ایجاد میکند. |
--wizard |
برای سازگاری پذیرفته میشود؛ setup بهطور پیشفرض راهاندازی اولیه را اجرا میکند. |
--non-interactive |
راهاندازی اولیه را بدون درخواست ورودی اجرا میکند. |
--accept-risk |
پذیرش خطر دسترسی عامل به کل سامانه؛ همراه --non-interactive الزامی است. |
--mode <mode> |
حالت راهاندازی اولیه: local یا remote. |
--flow <flow> |
جریان راهاندازی اولیه: quickstart، advanced، manual یا import. |
--reset |
پیکربندی + اعتبارنامهها + نشستها را پیش از راهاندازی اولیه بازنشانی میکند (فضای کاری فقط با --reset-scope full). |
--reset-scope <scope> |
دامنهٔ بازنشانی: config، config+creds+sessions یا full. |
--import-from <provider> |
ارائهدهندهٔ مهاجرتی که هنگام راهاندازی اولیه اجرا میشود. |
--import-source <path> |
خانهٔ عامل مبدأ برای --import-from. |
--import-secrets |
اسرار پشتیبانیشده را هنگام مهاجرت راهاندازی اولیه وارد میکند. |
--remote-url <url> |
نشانی WebSocket مربوط به Gateway راهدور. |
--remote-token <token> |
توکن Gateway راهدور (اختیاری). |
--json |
یک خلاصهٔ JSON خروجی میدهد. |
--classic و --non-interactive با یکدیگر ناسازگارند: حالت کلاسیک
ویزارد دارای درخواست ورودی را باز میکند، درحالیکه راهاندازی غیرتعاملی از مسیر خودکارسازی استفاده میکند.
حالت پایه
openclaw setup --baseline رفتار قدیمیِ محدود به حالت پایه را حفظ میکند:
دایرکتوریهای پیکربندی، فضای کاری و نشست را ایجاد میکند و سپس بدون
اجرای راهاندازی اولیه خارج میشود.
نمونهها
openclaw setupopenclaw setup --baselineopenclaw setup --workspace ~/.openclaw/workspaceopenclaw setup --import-from hermes --import-source ~/.hermesopenclaw setup --non-interactive --accept-risk --mode remote --remote-url wss://gateway-host:18789 --remote-token <token>نکات
- پس از راهاندازی پایه، برای طیکردن کامل فرایند هدایتشده
openclaw setupیاopenclaw onboard، برای تغییرات هدفمندopenclaw configure، یا برای افزودن حسابهای کانالopenclaw channels addرا اجرا کنید. - اگر وضعیت Hermes شناسایی شود، راهاندازی اولیهٔ تعاملی میتواند مهاجرت را بهطور خودکار پیشنهاد دهد. راهاندازی اولیه از طریق واردکردن به یک راهاندازی تازه نیاز دارد؛ برای طرحهای اجرای آزمایشی، پشتیبانگیری و حالت بازنویسی خارج از راهاندازی اولیه، از مهاجرت استفاده کنید.
