Guides

مرجع راه‌اندازی CLI

این صفحه رفتار، خروجی‌ها و جزئیات داخلی راه‌اندازی اولیه را به‌صورت گام‌به‌گام پوشش می‌دهد. برای راهنمای عملی، به راه‌اندازی اولیه (CLI) مراجعه کنید. برای مرجع کامل پرچم‌های CLI (همهٔ --flag، نمونه‌های غیرتعاملی و فرمان‌های مختص ارائه‌دهنده)، به openclaw onboard مراجعه کنید.

جادوگر چه می‌کند

حالت محلی (پیش‌فرض) شما را در مراحل زیر راهنمایی می‌کند:

راه‌اندازی مدل و احراز هویت (Anthropic، OAuth اشتراک OpenAI Code، xAI، OpenCode، نقاط پایانی سفارشی و دیگر جریان‌های احراز هویت متعلق به ارائه‌دهندگان)
محل فضای کاری و فایل‌های راه‌اندازی اولیه
تنظیمات Gateway (درگاه، اتصال، احراز هویت، Tailscale)
کانال‌ها و ارائه‌دهندگان (Discord، Feishu، Google Chat، iMessage، Mattermost، Microsoft Teams، QQ Bot، Signal، Slack، Telegram، WhatsApp و دیگر کانال‌های همراه یا Plugin)
ارائه‌دهندهٔ جست‌وجوی وب (اختیاری)
نصب دیمن (LaunchAgent، واحد کاربری systemd یا وظیفهٔ زمان‌بندی‌شدهٔ بومی Windows با بازگشت به پوشهٔ Startup)
بررسی سلامت
راه‌اندازی Skills

حالت راه‌دور این دستگاه را برای اتصال به یک Gateway در مکانی دیگر پیکربندی می‌کند. این حالت هیچ‌چیز را روی میزبان راه‌دور نصب یا تغییر نمی‌دهد.

جزئیات جریان محلی

تشخیص پیکربندی موجود

اگر ~/.openclaw/openclaw.json وجود دارد، Keep current values، Review and update یا Reset before setup را انتخاب کنید.
اجرای دوبارهٔ جادوگر چیزی را پاک نمی‌کند، مگر اینکه صراحتاً Reset را انتخاب کنید (یا --reset را ارسال کنید).
مقدار پیش‌فرض --reset در CLI برابر config+creds+sessions است؛ برای حذف فضای کاری نیز از --reset-scope full استفاده کنید.
اگر پیکربندی نامعتبر باشد یا کلیدهای قدیمی داشته باشد، جادوگر متوقف می‌شود و از شما می‌خواهد پیش از ادامه openclaw doctor را اجرا کنید.
بازنشانی، وضعیت را به سطل زباله منتقل می‌کند (هرگز مستقیماً حذف نمی‌کند) و محدوده‌های زیر را ارائه می‌دهد:
- فقط پیکربندی
- پیکربندی + اطلاعات اعتبارسنجی + نشست‌ها
- بازنشانی کامل (فضای کاری را نیز حذف می‌کند)

مدل و احراز هویت

ماتریس کامل گزینه‌ها در گزینه‌های احراز هویت و مدل آمده است.

فضای کاری

پیش‌فرض ~/.openclaw/workspace است (قابل پیکربندی).
فایل‌های فضای کاری لازم برای راه‌اندازی اولیه در نخستین اجرا را ایجاد می‌کند.
در اجرای دوباره، فهرست عامل‌های موجود فضای کاری سراسری ناوگان خود را حفظ می‌کند، مگر اینکه انتقال را صراحتاً تأیید کنید. اجرای دوبارهٔ غیرتعاملی هشدار می‌دهد و مقدار فعلی را حفظ می‌کند.
چیدمان فضای کاری: فضای کاری عامل.

Gateway

برای درگاه، اتصال، حالت احراز هویت و دسترسی از طریق Tailscale درخواست ورودی می‌کند.
توصیه می‌شود احراز هویت با توکن را حتی برای loopback فعال نگه دارید تا کلاینت‌های محلی WS ملزم به احراز هویت باشند.
در حالت توکن، راه‌اندازی تعاملی گزینه‌های زیر را ارائه می‌دهد:
- تولید/ذخیرهٔ توکن متن ساده (پیش‌فرض)
- استفاده از SecretRef (انتخابی)
در حالت گذرواژه، راه‌اندازی تعاملی از ذخیره‌سازی متن ساده یا SecretRef نیز پشتیبانی می‌کند.
مسیر غیرتعاملی SecretRef توکن: --gateway-token-ref-env <ENV_VAR>.
- به یک متغیر محیطی غیرخالی در محیط فرایند راه‌اندازی اولیه نیاز دارد.
- نمی‌توان آن را با --gateway-token ترکیب کرد.
احراز هویت را فقط زمانی غیرفعال کنید که به همهٔ فرایندهای محلی کاملاً اعتماد دارید.
اتصال‌های غیر loopback همچنان به احراز هویت نیاز دارند.

کانال‌ها

WhatsApp: ورود اختیاری با کد QR
Telegram: توکن ربات
Discord: توکن ربات
Google Chat: JSON حساب سرویس + مخاطب Webhook
Mattermost: توکن ربات + نشانی URL پایه
Signal: نصب اختیاری signal-cli + پیکربندی حساب
iMessage: مسیر CLI ‏imsg + دسترسی به پایگاه دادهٔ Messages؛ وقتی Gateway خارج از Mac اجرا می‌شود، از پوشش SSH استفاده کنید
امنیت پیام مستقیم: پیش‌فرض، جفت‌سازی است. نخستین پیام مستقیم یک کد ارسال می‌کند؛ آن را از طریق openclaw pairing approve <channel> <code> تأیید کنید یا از فهرست‌های مجاز استفاده کنید.

جست‌وجوی وب

یک ارائه‌دهنده (Brave، DuckDuckGo، Exa، Firecrawl، Gemini، Grok، Kimi، MiniMax Search، Ollama Web Search، Perplexity، SearXNG، Tavily) را انتخاب کنید یا از این مرحله بگذرید.
با --skip-search از این مرحله بگذرید؛ بعداً با openclaw configure --section web دوباره پیکربندی کنید.

نصب دیمن

macOS:‏ LaunchAgent
- به نشست کاربر واردشده نیاز دارد؛ برای اجرای بدون رابط، از LaunchDaemon سفارشی استفاده کنید (ارائه نمی‌شود).
Linux و Windows از طریق WSL2: واحد کاربری systemd
- جادوگر تلاش می‌کند loginctl enable-linger <user> را اجرا کند تا Gateway پس از خروج کاربر نیز فعال بماند.
- ممکن است برای sudo درخواست کند (/var/lib/systemd/linger را می‌نویسد)؛ ابتدا بدون sudo تلاش می‌کند.
Windows بومی: ابتدا Scheduled Task
- اگر ایجاد وظیفه رد شود، OpenClaw به یک مورد ورود در پوشهٔ Startup مخصوص هر کاربر بازمی‌گردد و Gateway را فوراً راه‌اندازی می‌کند.
- Scheduled Tasks همچنان ترجیح داده می‌شوند، زیرا وضعیت سرپرست بهتری ارائه می‌کنند.
انتخاب محیط اجرا: Node الزامی است، زیرا مخزن متعارف وضعیت زمان اجرای OpenClaw از node:sqlite استفاده می‌کند.

بررسی سلامت

Gateway را در صورت نیاز راه‌اندازی می‌کند و openclaw health را اجرا می‌کند.
openclaw status --deep کاوش زندهٔ سلامت Gateway را، از جمله کاوش کانال‌ها در صورت پشتیبانی، به خروجی وضعیت اضافه می‌کند.

Skills

Skills موجود را می‌خواند و پیش‌نیازها را بررسی می‌کند.
به شما امکان می‌دهد مدیر Node را انتخاب کنید: npm، pnpm یا bun.
وقتی نصب‌کنندهٔ لازم موجود باشد، وابستگی‌های اختیاری Skills همراه و مورد اعتماد را نصب می‌کند.
نصب‌کننده‌های ناموجود Homebrew،‏ uv و Go را نادیده می‌گیرد، سپس Skills تحت‌تأثیر را همراه با راهنمای راه‌اندازی دستی گروه‌بندی می‌کند. پس از نصب پیش‌نیازهای مفقود، openclaw doctor را اجرا کنید.

پایان

خلاصه و مراحل بعدی، شامل گزینه‌های برنامهٔ iOS،‏ Android و macOS.

جزئیات حالت راه‌دور

مواردی که تنظیم می‌کنید:

نشانی URL ‏Gateway راه‌دور (ws://... یا wss://...)
توکن، گذرواژه یا بدون احراز هویت، مطابق با پیکربندی Gateway راه‌دور

کشف (اختیاری)

اگر dns-sd (macOS) یا avahi-browse (Linux) موجود باشد، راه‌اندازی اولیه پیش از بازگشت به ورود دستی URL، جست‌وجوی اعلان‌های Gateway از طریق Bonjour/mDNS را پیشنهاد می‌دهد. در صورت پیکربندی، کشف DNS-SD در شبکهٔ گسترده نیز انجام می‌شود. مستندات: کشف Gateway، Bonjour.

روش اتصال

وقتی یک اعلان انتخاب می‌شود، WebSocket مستقیم یا تونل SSH را انتخاب کنید:

مستقیم: از طریق wss:// متصل می‌شود و از شما می‌خواهد به اثر انگشت TLS کشف‌شده اعتماد کنید (سنجاق‌کردن بر مبنای اعتماد در نخستین استفاده؛ فقط در صورت پذیرش شما سنجاق می‌شود).
تونل SSH: فرمان ssh -N -L 18789:127.0.0.1:18789 <user>@<host> را برای اجرای اولیه چاپ می‌کند، سپس به نقطهٔ پایانی تونل محلی متصل می‌شود.

احراز هویت

توکن (توصیه‌شده)، گذرواژه یا بدون احراز هویت را انتخاب کنید، سپس در صورت تمایل آن را به‌جای متن ساده به‌صورت SecretRef ذخیره کنید.

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

اگر یکی از مراحل راه‌اندازی ارائه‌دهنده در راه‌اندازی اولیهٔ تعاملی ناموفق باشد (برای مثال، گزینهٔ استفادهٔ مجدد از CLI بدون ورود محلی)، جادوگر خطا را نمایش می‌دهد و به‌جای خروج، به انتخابگر ارائه‌دهنده بازمی‌گردد. اجرای صریح --auth-choice همچنان برای خودکارسازی سریعاً ناموفق می‌شود.

کلید API ‏Anthropic

اگر ANTHROPIC_API_KEY موجود باشد از آن استفاده می‌کند؛ در غیر این صورت کلیدی درخواست می‌کند و سپس آن را برای استفادهٔ دیمن ذخیره می‌کند.

CLI ‏Anthropic Claude

مسیر محلی ترجیحی در راه‌اندازی اولیه/پیکربندی تعاملی؛ در صورت وجود، از ورود فعلی Claude CLI دوباره استفاده می‌کند.

اشتراک OpenAI Code ‏(OAuth)

جریان مرورگر؛ code#state را جای‌گذاری کنید.

در یک راه‌اندازی تازه که مدل اصلی ندارد، agents.defaults.model را از طریق محیط اجرای Codex روی openai/gpt-5.6-sol تنظیم می‌کند.

اشتراک OpenAI Code ‏(جفت‌سازی دستگاه)

جریان جفت‌سازی مرورگر با کد دستگاه کوتاه‌عمر.

در یک راه‌اندازی تازه که مدل اصلی ندارد، agents.defaults.model را از طریق محیط اجرای Codex روی openai/gpt-5.6-sol تنظیم می‌کند.

کلید API ‏OpenAI

اگر OPENAI_API_KEY موجود باشد از آن استفاده می‌کند؛ در غیر این صورت کلیدی درخواست می‌کند و سپس اطلاعات اعتبارسنجی را در نمایه‌های احراز هویت ذخیره می‌کند.

در یک راه‌اندازی تازه که مدل اصلی ندارد، agents.defaults.model را روی openai/gpt-5.6 تنظیم می‌کند؛ شناسهٔ مدل خام API مستقیم به ردهٔ Sol نگاشت می‌شود.

افزودن یا احراز هویت مجدد OpenAI، مدل اصلی صریح موجود را، از جمله openai/gpt-5.5، حفظ می‌کند. اگر حساب GPT-5.6 را ارائه نمی‌دهد، openai/gpt-5.5 را صراحتاً انتخاب کنید؛ OpenClaw آن را بی‌سروصدا به نسخه‌ای پایین‌تر تغییر نمی‌دهد.

xAI (Grok) OAuth

ورود از طریق مرورگر برای حساب‌های واجد شرایط SuperGrok یا X Premium. این مسیر پیشنهادی xAI برای بیشتر کاربران است. OpenClaw نمایه احراز هویت حاصل را برای مدل‌های Grok،‏ Grok web_search،‏ x_search و code_execution ذخیره می‌کند.

کد دستگاه xAI (Grok)

ورود از طریق مرورگر، مناسب محیط‌های راه دور، با استفاده از یک کد کوتاه به‌جای فراخوانی برگشتی localhost. از این روش در میزبان‌های SSH،‏ Docker یا VPS استفاده کنید.

کلید API ‏xAI (Grok)

مقدار XAI_API_KEY را درخواست می‌کند و xAI را به‌عنوان ارائه‌دهنده مدل پیکربندی می‌کند. هنگامی از این روش استفاده کنید که به‌جای OAuth اشتراکی، کلید API کنسول xAI را می‌خواهید.

OpenCode

مقدار OPENCODE_API_KEY (یا OPENCODE_ZEN_API_KEY) را درخواست می‌کند و امکان انتخاب کاتالوگ Zen یا Go را می‌دهد (یک کلید API هر دو را پوشش می‌دهد). نشانی راه‌اندازی: opencode.ai/auth.

کلید API (عمومی)

کلید را برای شما ذخیره می‌کند.

Vercel AI Gateway

مقدار AI_GATEWAY_API_KEY را درخواست می‌کند. جزئیات بیشتر: Vercel AI Gateway.

Cloudflare AI Gateway

شناسه حساب، شناسه Gateway و CLOUDFLARE_AI_GATEWAY_API_KEY را درخواست می‌کند. جزئیات بیشتر: Cloudflare AI Gateway.

MiniMax

پیکربندی به‌طور خودکار نوشته می‌شود. مقدار پیش‌فرض میزبانی‌شده MiniMax-M3 است؛ راه‌اندازی با کلید API از minimax/... و راه‌اندازی OAuth از minimax-portal/... استفاده می‌کند. جزئیات بیشتر: MiniMax.

StepFun

پیکربندی برای StepFun استاندارد یا Step Plan روی نقاط پایانی چین یا جهانی به‌طور خودکار نوشته می‌شود. نسخه استاندارد در حال حاضر شامل step-3.5-flash است و Step Plan نیز step-3.5-flash-2603 را شامل می‌شود. جزئیات بیشتر: StepFun.

Synthetic (سازگار با Anthropic)

مقدار SYNTHETIC_API_KEY را درخواست می‌کند. جزئیات بیشتر: Synthetic.

Ollama (مدل‌های باز ابری و محلی)

ابتدا Cloud + Local،‏ Cloud only یا Local only را درخواست می‌کند. Cloud only از OLLAMA_API_KEY همراه با https://ollama.com استفاده می‌کند. حالت‌های مبتنی بر میزبان، نشانی پایه را درخواست می‌کنند (پیش‌فرض http://127.0.0.1:11434)، مدل‌های موجود را شناسایی می‌کنند و مقادیر پیش‌فرض پیشنهاد می‌دهند. Cloud + Local همچنین بررسی می‌کند که آیا آن میزبان Ollama برای دسترسی ابری وارد حساب شده است یا خیر. جزئیات بیشتر: Ollama.

Moonshot و Kimi Coding

پیکربندی‌های Moonshot (Kimi K2) و Kimi Coding به‌طور خودکار نوشته می‌شوند. جزئیات بیشتر: Moonshot AI (Kimi + Kimi Coding).

ارائه‌دهنده سفارشی

با نقاط پایانی سازگار با OpenAI، سازگار با OpenAI Responses و سازگار با Anthropic کار می‌کند.

راه‌اندازی تعاملی از همان گزینه‌های ذخیره‌سازی کلید API در جریان‌های کلید API سایر ارائه‌دهندگان پشتیبانی می‌کند:

اکنون کلید API را جای‌گذاری کنید (متن ساده)
از ارجاع راز استفاده کنید (ارجاع متغیر محیطی یا ارجاع ارائه‌دهنده پیکربندی‌شده، همراه با اعتبارسنجی پیش از اجرا)

راه‌اندازی، پشتیبانی از تصویر را برای شناسه‌های رایج مدل‌های بینایی (GPT-4o/4.1/5.x،‏ Claude 3/4،‏ Gemini،‏ Qwen-VL،‏ LLaVA،‏ Pixtral و موارد مشابه) استنباط می‌کند و فقط زمانی سؤال می‌پرسد که نام مدل ناشناخته باشد.

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

--auth-choice custom-api-key
--custom-base-url
--custom-model-id
--custom-api-key (اختیاری؛ در صورت نبود، از CUSTOM_API_KEY استفاده می‌کند)
--custom-provider-id (اختیاری)
--custom-compatibility <openai|openai-responses|anthropic> (اختیاری؛ پیش‌فرض openai)
--custom-image-input / --custom-text-input (اختیاری؛ قابلیت ورودی استنباط‌شده مدل را بازنویسی می‌کند)

رد کردن

احراز هویت را پیکربندی‌نشده باقی می‌گذارد.

رفتار مدل:

مدل پیش‌فرض را از گزینه‌های شناسایی‌شده انتخاب کنید، یا ارائه‌دهنده و مدل را به‌صورت دستی وارد کنید.
وقتی راه‌اندازی از انتخاب احراز هویت یک ارائه‌دهنده آغاز می‌شود، انتخابگر مدل به‌طور خودکار آن ارائه‌دهنده را ترجیح می‌دهد. برای Volcengine و BytePlus، همین ترجیح با گونه‌های طرح کدنویسی آن‌ها نیز مطابقت دارد (volcengine-plan/*، byteplus-plan/*).
اگر فیلتر ارائه‌دهنده ترجیحی هیچ نتیجه‌ای نداشته باشد، انتخابگر به‌جای نمایش ندادن هیچ مدلی، به کاتالوگ کامل بازمی‌گردد.
ویزارد مدل را بررسی می‌کند و اگر مدل پیکربندی‌شده ناشناخته باشد یا احراز هویت نداشته باشد، هشدار می‌دهد.

مسیرهای اعتبارنامه و نمایه:

نمایه‌های احراز هویت (کلیدهای API + OAuth): ~/.openclaw/agents/<agentId>/agent/auth-profiles.json
درون‌ریزی OAuth قدیمی: ~/.openclaw/credentials/oauth.json

حالت ذخیره‌سازی اعتبارنامه:

رفتار پیش‌فرض راه‌اندازی، کلیدهای API را به‌صورت مقادیر متن ساده در نمایه‌های احراز هویت ماندگار می‌کند.
--secret-input-mode ref به‌جای ذخیره‌سازی کلید به‌صورت متن ساده، حالت ارجاع را فعال می‌کند. در راه‌اندازی تعاملی، می‌توانید یکی از این دو را انتخاب کنید:
- ارجاع متغیر محیطی (برای مثال keyRef: { source: "env", provider: "default", id: "OPENAI_API_KEY" })
- ارجاع ارائه‌دهنده پیکربندی‌شده (file یا exec) همراه با نام مستعار ارائه‌دهنده + شناسه
حالت ارجاع تعاملی پیش از ذخیره‌سازی، یک اعتبارسنجی سریع پیش از اجرا انجام می‌دهد.
- ارجاع‌های متغیر محیطی: نام متغیر و خالی نبودن مقدار آن را در محیط راه‌اندازی فعلی اعتبارسنجی می‌کند.
- ارجاع‌های ارائه‌دهنده: پیکربندی ارائه‌دهنده را اعتبارسنجی و شناسه درخواستی را تفکیک می‌کند.
- اگر اعتبارسنجی پیش از اجرا ناموفق باشد، راه‌اندازی خطا را نمایش می‌دهد و امکان تلاش دوباره را فراهم می‌کند.
در حالت غیرتعاملی، --secret-input-mode ref فقط با متغیر محیطی پشتیبانی می‌شود.
- متغیر محیطی ارائه‌دهنده را در محیط فرایند راه‌اندازی تنظیم کنید.
- پرچم‌های کلید درون‌خطی (برای مثال --openai-api-key) مستلزم تنظیم بودن آن متغیر محیطی هستند؛ در غیر این صورت راه‌اندازی بی‌درنگ ناموفق می‌شود.
- برای ارائه‌دهندگان سفارشی، حالت غیرتعاملی ref مقدار models.providers.<id>.apiKey را به‌صورت { source: "env", provider: "default", id: "CUSTOM_API_KEY" } ذخیره می‌کند.
- در این حالت ارائه‌دهنده سفارشی، --custom-api-key مستلزم تنظیم بودن CUSTOM_API_KEY است؛ در غیر این صورت راه‌اندازی بی‌درنگ ناموفق می‌شود.
اعتبارنامه‌های احراز هویت Gateway در راه‌اندازی تعاملی از گزینه‌های متن ساده و SecretRef پشتیبانی می‌کنند:
- حالت توکن: تولید/ذخیره توکن متن ساده (پیش‌فرض) یا استفاده از SecretRef.
- حالت گذرواژه: متن ساده یا SecretRef.
مسیر SecretRef توکن در حالت غیرتعاملی: --gateway-token-ref-env <ENV_VAR>.
راه‌اندازی‌های متن ساده موجود بدون تغییر به کار خود ادامه می‌دهند.

خروجی‌ها و سازوکارهای داخلی

فیلدهای معمول در ~/.openclaw/openclaw.json:

agents.defaults.workspace
agents.defaults.skipBootstrap هنگامی که --skip-bootstrap ارسال شود
agents.defaults.model / models.providers (اگر Minimax انتخاب شده باشد)
tools.profile (اگر تنظیم نشده باشد، راه‌اندازی محلی به‌طور پیش‌فرض از "coding" استفاده می‌کند؛ مقادیر صریح موجود حفظ می‌شوند)
gateway.* (حالت، اتصال، احراز هویت، Tailscale)
session.dmScope (راه‌اندازی مقادیر صریح را حفظ می‌کند و در غیر این صورت آن را تنظیم‌نشده باقی می‌گذارد؛ بنابراین مقدار پیش‌فرض main همه پیام‌های مستقیم کانال‌ها را در نشست اصلی چرخشی عامل نگه می‌دارد—مقدار پیش‌فرض عامل شخصی. برای صندوق‌های ورودی مشترک یا چندکاربره، از per-channel-peer استفاده کنید؛ openclaw security audit هنگام شناسایی ترافیک پیام مستقیم چندکاربره، جداسازی را توصیه می‌کند)
channels.telegram.botToken،‏ channels.discord.token،‏ channels.matrix.*،‏ channels.signal.*،‏ channels.imessage.*
فهرست‌های مجاز کانال‌ها (Discord،‏ iMessage،‏ Signal،‏ Slack،‏ Telegram،‏ WhatsApp) هنگامی که در اعلان‌ها انتخابشان می‌کنید؛ Discord و Slack همچنین نام‌های واردشده را به شناسه تبدیل می‌کنند
skills.install.nodeManager
- پرچم setup --node-manager مقادیر npm،‏ pnpm یا bun را می‌پذیرد.
- پیکربندی دستی همچنان می‌تواند بعداً skills.install.nodeManager: "yarn" را تنظیم کند.
wizard.lastRunAt
wizard.lastRunVersion
wizard.lastRunCommit
wizard.lastRunCommand
wizard.lastRunMode
wizard.securityAcknowledgedAt

openclaw agents add مقدار agents.entries.* و در صورت نیاز bindings را می‌نویسد.

اعتبارنامه‌های WhatsApp در ~/.openclaw/credentials/whatsapp/<accountId>/ قرار می‌گیرند. نشست‌های فعال و رونوشت‌ها در ~/.openclaw/agents/<agentId>/agent/openclaw-agent.sqlite ذخیره می‌شوند. پوشه ~/.openclaw/agents/<agentId>/sessions/ برای ورودی‌های مهاجرت قدیمی و مصنوعات بایگانی/پشتیبانی استفاده می‌شود.

پیشنهادهای برنامه‌های نصب‌شده

پس از موفقیت بررسی دسترسی مدل، راه‌اندازی تعاملی کلاسیک در macOS بدون درخواست مجوزهای حریم خصوصی macOS، نام برنامه‌ها و شناسه‌های بسته را اسکن می‌کند. سپس کاتالوگ‌های رسمی Plugin و ClawHub را جست‌وجو می‌کند و از مدل پیکربندی‌شده می‌خواهد تطابق‌های نام نادرست را رد و Pluginها یا Skills مرتبط را پیشنهاد کند. تطابق‌های پیشنهادی به‌طور پیش‌فرض انتخاب می‌شوند؛ تطابق‌های اختیاری نیازمند انتخاب صریح هستند.

صفحه نتایج برنامه‌های شناسایی‌شده را فهرست می‌کند و این پیام را نشان می‌دهد: «نام برنامه‌ها با استفاده از مدل پیکربندی‌شده شما و جست‌وجوی ClawHub تطبیق داده شدند.» برای غیرفعال کردن هم این مرحله راه‌اندازی و هم دسترسی Gateway به موجودی برنامه‌های Node، مقدار wizard.appRecommendations را روی false تنظیم کنید. این اسکن در راه‌اندازی سریع یا راه‌اندازی‌های غیر macOS استفاده نمی‌شود.

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

--non-interactive به --accept-risk نیاز دارد (تأیید می‌کند که عامل‌ها قدرتمند هستند و دسترسی کامل به سیستم خطرناک است):

bash

openclaw onboard --non-interactive --accept-risk \  --auth-choice apiKey \  --anthropic-api-key "$ANTHROPIC_API_KEY"

مرجع کامل پرچم‌ها و نمونه‌های ویژه ارائه‌دهندگان: openclaw onboard، خودکارسازی CLI.

RPC ویزارد Gateway

wizard.start
wizard.next
wizard.cancel
wizard.status

کلاینت‌ها (برنامه macOS و رابط کاربری کنترل) می‌توانند مراحل را بدون پیاده‌سازی دوباره منطق راه‌اندازی نمایش دهند.

رفتار راه‌اندازی Signal

دارایی انتشار مناسب را از انتشارهای رسمی GitHub مربوط به signal-cli دانلود می‌کند (ساخت بومی، فقط Linux x86-64)
در پلتفرم‌های دیگر (macOS،‏ Linux غیر x64)، در عوض از طریق Homebrew نصب می‌کند
نصب دارایی انتشار را در ~/.openclaw/tools/signal-cli/<version>/ ذخیره می‌کند
مقدار channels.signal.transport.cliPath را همراه با kind: "managed-native" در پیکربندی می‌نویسد
Windows بومی هنوز پشتیبانی نمی‌شود؛ برای دریافت مسیر نصب Linux، راه‌اندازی را در WSL2 اجرا کنید

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

مرکز راه‌اندازی: راه‌اندازی (CLI)
خودکارسازی و اسکریپت‌ها: خودکارسازی CLI
مرجع فرمان: openclaw onboard

Was this useful?