English简体中文繁體中文日本語EspañolPortuguês (BR)한국어DeutschFrançaisالعربيةItalianoTiếng ViệtNederlandsTürkçeУкраїнськаBahasa IndonesiaPolskiفارسیไทย

First steps

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

Edit source

راه‌اندازی اولیه با CLI روش توصیه‌شده برای تنظیم OpenClaw روی macOS، Linux، یا Windows (از طریق WSL2؛ قویاً توصیه می‌شود) است. این کار یک Gateway محلی یا اتصال به Gateway دوردست، به‌علاوه کانال‌ها، Skills، و پیش‌فرض‌های فضای کاری را در یک جریان راهنمایی‌شده پیکربندی می‌کند.

bash
openclaw onboard

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

bash
openclaw configureopenclaw agents add <name>

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

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

شروع سریع (پیش‌فرض‌ها)

  • Gateway محلی (loopback)
  • پیش‌فرض فضای کاری (یا فضای کاری موجود)
  • پورت Gateway 18789
  • احراز هویت Gateway با توکن (به‌صورت خودکار تولید می‌شود، حتی روی loopback)
  • پیش‌فرض سیاست ابزار برای تنظیمات محلی جدید: tools.profile: "coding" (پروفایل صریح موجود حفظ می‌شود)
  • پیش‌فرض جداسازی DM: راه‌اندازی اولیه محلی وقتی تنظیم نشده باشد session.dmScope: "per-channel-peer" را می‌نویسد. جزئیات: مرجع تنظیم CLI
  • در معرض‌گذاری Tailscale خاموش
  • DMهای Telegram + WhatsApp به‌صورت پیش‌فرض روی فهرست مجاز هستند (برای شماره تلفن خود راهنمایی خواهید شد)

پیشرفته (کنترل کامل)

  • همه گام‌ها را آشکار می‌کند (حالت، فضای کاری، Gateway، کانال‌ها، daemon، Skills).

راه‌اندازی اولیه چه چیزهایی را پیکربندی می‌کند

حالت محلی (پیش‌فرض) شما را از این گام‌ها عبور می‌دهد:

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

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

Was this useful?