---
read_when:
    - اجرای فرایند راه‌اندازی اولیه CLI یا پیکربندی آن
    - راه‌اندازی یک دستگاه جدید
sidebarTitle: 'Onboarding: CLI'
summary: 'راه‌اندازی اولیه CLI: راه‌اندازی هدایت‌شده برای Gateway، فضای کاری، کانال‌ها و Skills'
title: راه‌اندازی اولیه (CLI)
x-i18n:
    generated_at: "2026-05-10T20:08:15Z"
    model: gpt-5.5
    provider: openai
    source_hash: 6d8093f2375240f7a784b22c97c824a49b4d39b9217c0d1c0a1490bb15160700
    source_path: start/wizard.md
    workflow: 16
---

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

```bash
openclaw onboard
```

<Info>
سریع‌ترین گفت‌وگوی اول: Control UI را باز کنید (نیازی به تنظیم کانال نیست). دستور
`openclaw dashboard` را اجرا کنید و در مرورگر گفت‌وگو کنید. مستندات: [داشبورد](/fa/web/dashboard).
</Info>

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

```bash
openclaw configure
openclaw agents add <name>
```

<Note>
`--json` به معنای حالت غیرتعاملی نیست. برای اسکریپت‌ها، از `--non-interactive` استفاده کنید.
</Note>

<Tip>
راه‌اندازی اولیه CLI شامل یک گام جست‌وجوی وب است که در آن می‌توانید ارائه‌دهنده‌ای
مانند Brave، DuckDuckGo، Exa، Firecrawl، Gemini، Grok، Kimi، MiniMax Search،
Ollama Web Search، Perplexity، SearXNG، یا Tavily را انتخاب کنید. برخی ارائه‌دهنده‌ها به
کلید API نیاز دارند، در حالی که برخی دیگر بدون کلید هستند. همچنین می‌توانید این مورد را بعداً با
`openclaw configure --section web` پیکربندی کنید. مستندات: [ابزارهای وب](/fa/tools/web).
</Tip>

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

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

<Tabs>
  <Tab title="شروع سریع (پیش‌فرض‌ها)">
    - Gateway محلی (loopback)
    - پیش‌فرض فضای کاری (یا فضای کاری موجود)
    - پورت Gateway **18789**
    - احراز هویت Gateway با **توکن** (به‌صورت خودکار تولید می‌شود، حتی روی loopback)
    - پیش‌فرض سیاست ابزار برای تنظیمات محلی جدید: `tools.profile: "coding"` (پروفایل صریح موجود حفظ می‌شود)
    - پیش‌فرض جداسازی DM: راه‌اندازی اولیه محلی وقتی تنظیم نشده باشد `session.dmScope: "per-channel-peer"` را می‌نویسد. جزئیات: [مرجع تنظیم CLI](/fa/start/wizard-cli-reference#outputs-and-internals)
    - در معرض‌گذاری Tailscale **خاموش**
    - DMهای Telegram + WhatsApp به‌صورت پیش‌فرض روی **فهرست مجاز** هستند (برای شماره تلفن خود راهنمایی خواهید شد)

  </Tab>
  <Tab title="پیشرفته (کنترل کامل)">
    - همه گام‌ها را آشکار می‌کند (حالت، فضای کاری، Gateway، کانال‌ها، daemon، Skills).

  </Tab>
</Tabs>

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

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

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 <ENV_VAR>`.
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 توصیه‌شده و وابستگی‌های اختیاری را نصب می‌کند.

<Note>
اجرای دوباره راه‌اندازی اولیه هیچ چیزی را پاک **نمی‌کند** مگر اینکه صراحتاً **بازنشانی** را انتخاب کنید (یا `--reset` را ارسال کنید).
CLI `--reset` به‌صورت پیش‌فرض شامل پیکربندی، اعتبارنامه‌ها، و نشست‌ها است؛ برای شامل کردن فضای کاری از `--reset-scope full` استفاده کنید.
اگر پیکربندی نامعتبر باشد یا کلیدهای قدیمی داشته باشد، راه‌اندازی اولیه از شما می‌خواهد ابتدا `openclaw doctor` را اجرا کنید.
</Note>

**حالت دوردست** فقط کلاینت محلی را برای اتصال به یک 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](/fa/start/wizard-cli-reference).
برای نمونه‌های غیرتعاملی، ببینید [اتوماسیون CLI](/fa/start/wizard-cli-automation).
برای مرجع فنی عمیق‌تر، از جمله جزئیات RPC، ببینید
[مرجع راه‌اندازی اولیه](/fa/reference/wizard).

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

- مرجع دستور CLI: [`openclaw onboard`](/fa/cli/onboard)
- نمای کلی راه‌اندازی اولیه: [نمای کلی راه‌اندازی اولیه](/fa/start/onboarding-overview)
- راه‌اندازی اولیه برنامه macOS: [راه‌اندازی اولیه](/fa/start/onboarding)
- آیین نخستین اجرای عامل: [Bootstrap عامل](/fa/start/bootstrapping)