راه‌اندازی اولیه (CLI)

آماده‌سازی CLI مسیر توصیه‌شده برای راه‌اندازی ترمینالی OpenClaw روی macOS، Linux، یا Windows است. کاربران دسکتاپ Windows همچنین می‌توانند با هاب Windows شروع کنند. این مسیر یک Gateway محلی یا اتصال به Gateway راه‌دور، به‌همراه کانال‌ها، Skills، و پیش‌فرض‌های فضای کاری را در یک جریان راهنمایی‌شده پیکربندی می‌کند.

openclaw onboard

شروع سریع معمولا فقط چند دقیقه طول می‌کشد، اما آماده‌سازی کامل ممکن است زمانی بیشتر طول بکشد که ورود به ارائه‌دهنده، جفت‌سازی کانال، نصب دیمون، دانلودهای شبکه، Skills، یا Pluginهای اختیاری به راه‌اندازی بیشتری نیاز داشته باشند. ویزارد این زمان‌بندی را از ابتدا نشان می‌دهد، و مراحل اختیاری را می‌توان رد کرد و بعدا با openclaw configure دوباره انجام داد.

زبان و منطقه

ویزارد CLI متن ثابت آماده‌سازی را بومی‌سازی می‌کند. زبان و منطقه را از OPENCLAW_LOCALE، سپس LC_ALL، سپس LC_MESSAGES، سپس LANG تشخیص می‌دهد، و در نهایت به انگلیسی برمی‌گردد. زبان‌های پشتیبانی‌شده ویزارد en، zh-CN، و zh-TW هستند.

OPENCLAW_LOCALE=zh-CN openclaw onboard

نام‌ها و شناسه‌های پایدار به‌صورت تحت‌اللفظی باقی می‌مانند: OpenClaw، Gateway، Tailscale، دستورها، کلیدهای پیکربندی، URLها، شناسه‌های ارائه‌دهنده، شناسه‌های مدل، و برچسب‌های Plugin/کانال ترجمه نمی‌شوند.

برای پیکربندی دوباره در آینده:

openclaw configureopenclaw agents add <name>

شروع سریع در برابر پیشرفته

آماده‌سازی با شروع سریع (پیش‌فرض‌ها) در برابر پیشرفته (کنترل کامل) آغاز می‌شود.

آماده‌سازی چه چیزهایی را پیکربندی می‌کند

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

1. مدل/احراز هویت — هر ارائه‌دهنده/جریان احراز هویت پشتیبانی‌شده را انتخاب کنید (کلید API، OAuth، یا احراز هویت دستی مخصوص ارائه‌دهنده)، از جمله ارائه‌دهنده سفارشی (سازگار با OpenAI، سازگار با Anthropic، یا تشخیص خودکار ناشناخته). یک مدل پیش‌فرض انتخاب کنید. نکته امنیتی: اگر این عامل قرار است ابزارها را اجرا کند یا محتوای webhook/hooks را پردازش کند، قوی‌ترین مدل نسل جدید موجود را ترجیح دهید و سیاست ابزار را سخت‌گیرانه نگه دارید. رده‌های ضعیف‌تر/قدیمی‌تر راحت‌تر دچار prompt injection می‌شوند. برای اجراهای غیرتعاملی، --secret-input-mode ref به‌جای مقادیر متنی کلید API، ارجاع‌های مبتنی بر env را در نمایه‌های احراز هویت ذخیره می‌کند. در حالت غیرتعاملی ref، متغیر env ارائه‌دهنده باید تنظیم شده باشد؛ ارسال پرچم‌های کلید inline بدون آن متغیر env سریع شکست می‌خورد. در اجراهای تعاملی، انتخاب حالت ارجاع محرمانه به شما اجازه می‌دهد به یک متغیر محیطی یا یک ref ارائه‌دهنده پیکربندی‌شده (file یا exec) اشاره کنید، همراه با اعتبارسنجی پیش‌بررسی سریع قبل از ذخیره. برای Anthropic، آماده‌سازی/پیکربندی تعاملی Anthropic Claude CLI را به‌عنوان مسیر محلی ترجیحی و کلید API Anthropic را به‌عنوان مسیر تولید توصیه‌شده ارائه می‌دهد. Anthropic setup-token نیز همچنان به‌عنوان مسیر احراز هویت توکنی پشتیبانی‌شده در دسترس است.
2. فضای کاری — محل فایل‌های عامل (پیش‌فرض ~/.openclaw/workspace). فایل‌های bootstrap را seed می‌کند.
3. Gateway — پورت، آدرس bind، حالت احراز هویت، نمایش از طریق Tailscale. در حالت توکن تعاملی، ذخیره‌سازی پیش‌فرض توکن plaintext را انتخاب کنید یا SecretRef را برگزینید. مسیر SecretRef توکن غیرتعاملی: --gateway-token-ref-env <ENV_VAR>.
4. کانال‌ها — کانال‌های چت داخلی و Plugin رسمی مانند iMessage، Discord، Feishu، Google Chat، Mattermost، Microsoft Teams، QQ Bot، Signal، Slack، Telegram، WhatsApp، و موارد بیشتر.
5. دیمون — یک LaunchAgent (macOS)، واحد کاربری systemd (Linux/WSL2)، یا Windows Scheduled Task بومی را با fallback پوشه Startup برای هر کاربر نصب می‌کند. اگر احراز هویت توکنی به توکن نیاز داشته باشد و gateway.auth.token با SecretRef مدیریت شود، نصب دیمون آن را اعتبارسنجی می‌کند اما توکن resolve‌شده را در metadata محیط سرویس supervisor پایدار نمی‌کند. اگر احراز هویت توکنی به توکن نیاز داشته باشد و SecretRef توکن پیکربندی‌شده resolve نشده باشد، نصب دیمون با راهنمایی قابل‌اقدام مسدود می‌شود. اگر هر دو gateway.auth.token و gateway.auth.password پیکربندی شده باشند و gateway.auth.mode تنظیم نشده باشد، نصب دیمون تا زمانی که حالت صریحا تنظیم شود مسدود می‌شود.
6. بررسی سلامت — Gateway را راه‌اندازی می‌کند و اجرای آن را تایید می‌کند.
7. Skills — Skills توصیه‌شده و وابستگی‌های اختیاری را نصب می‌کند.

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

افزودن عامل دیگر

از openclaw agents add <name> برای ایجاد یک عامل جداگانه با فضای کاری، نشست‌ها، و نمایه‌های احراز هویت خودش استفاده کنید. اجرا بدون --workspace آماده‌سازی را راه‌اندازی می‌کند.

آنچه تنظیم می‌کند:

• agents.list[].name
• agents.list[].workspace
• agents.list[].agentDir

نکات:

• فضاهای کاری پیش‌فرض از ~/.openclaw/workspace-<agentId> پیروی می‌کنند.
• برای مسیریابی پیام‌های ورودی، bindings اضافه کنید (آماده‌سازی می‌تواند این کار را انجام دهد).
• پرچم‌های غیرتعاملی: --model، --agent-dir، --bind، --non-interactive.

مرجع کامل

برای جزئیات گام‌به‌گام و خروجی‌های پیکربندی، ببینید مرجع راه‌اندازی CLI. برای نمونه‌های غیرتعاملی، ببینید اتوماسیون CLI. برای مرجع فنی عمیق‌تر، از جمله جزئیات RPC، ببینید مرجع آماده‌سازی.

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

• مرجع دستور CLI: openclaw onboard
• نمای کلی آماده‌سازی: نمای کلی آماده‌سازی
• آماده‌سازی برنامه macOS: آماده‌سازی
• آیین اجرای نخست عامل: Bootstrap عامل