---
read_when:
    - می‌خواهید اعتبارنامه‌ها، دستگاه‌ها یا پیش‌فرض‌های عامل را به‌صورت تعاملی تنظیم کنید
summary: مرجع CLI برای `openclaw configure` (اعلان‌های تعاملی پیکربندی)
title: پیکربندی
x-i18n:
    generated_at: "2026-05-10T19:30:38Z"
    model: gpt-5.5
    provider: openai
    source_hash: aba5320fefb856c208405511619fc1a4314e3f5e3990f221e987a03d692189fb
    source_path: cli/configure.md
    workflow: 16
---

# `openclaw configure`

درخواست تعاملی برای تغییرات هدفمند در یک راه‌اندازی موجود: اعتبارنامه‌ها، دستگاه‌ها، پیش‌فرض‌های عامل، Gateway، کانال‌ها، Pluginها، Skills، و بررسی‌های سلامت.

از `openclaw onboard` برای مسیر کامل و راهنمای اجرای نخست، از `openclaw setup` فقط برای پیکربندی/فضای کاری پایه، و از `openclaw channels add` زمانی استفاده کنید که فقط به راه‌اندازی حساب کانال نیاز دارید.

<Note>
بخش **مدل** شامل یک انتخاب چندگانه برای فهرست مجاز `agents.defaults.models` است (چیزی که در `/model` و انتخاب‌گر مدل نمایش داده می‌شود). گزینه‌های راه‌اندازی محدود به ارائه‌دهنده، مدل‌های انتخاب‌شده خود را به فهرست مجاز موجود ادغام می‌کنند، به‌جای اینکه ارائه‌دهندگان نامرتبطی را که از قبل در پیکربندی هستند جایگزین کنند.

اجرای دوباره احراز هویت ارائه‌دهنده از configure مقدار موجود `agents.defaults.model.primary` را حفظ می‌کند، حتی وقتی مرحله احراز هویت ارائه‌دهنده یک وصله پیکربندی با مدل پیش‌فرض پیشنهادی خودش برگرداند. یعنی افزودن یا احراز هویت دوباره xAI، OpenRouter، یا یک ارائه‌دهنده دیگر باید مدل جدید را در دسترس کند، بدون اینکه جای مدل اصلی فعلی شما را بگیرد. وقتی عمدا می‌خواهید مدل پیش‌فرض را تغییر دهید، از `openclaw models auth login --provider <id> --set-default` یا `openclaw models set <model>` استفاده کنید.
</Note>

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

<Tip>
`openclaw config` بدون زیر‌دستور، همین ویزارد را باز می‌کند. برای ویرایش‌های غیرتعاملی از `openclaw config get|set|unset` استفاده کنید.
</Tip>

برای جست‌وجوی وب، `openclaw configure --section web` به شما امکان می‌دهد یک ارائه‌دهنده را انتخاب کنید
و اعتبارنامه‌های آن را پیکربندی کنید. برخی ارائه‌دهندگان همچنین درخواست‌های پیگیری
ویژه همان ارائه‌دهنده را نمایش می‌دهند:

- **Grok** می‌تواند راه‌اندازی اختیاری `x_search` را با همان `XAI_API_KEY` پیشنهاد کند و
  به شما اجازه دهد یک مدل `x_search` انتخاب کنید.
- **Kimi** می‌تواند منطقه API مربوط به Moonshot (`api.moonshot.ai` در برابر
  `api.moonshot.cn`) و مدل پیش‌فرض جست‌وجوی وب Kimi را بپرسد.

مرتبط:

- مرجع پیکربندی Gateway: [پیکربندی](/fa/gateway/configuration)
- CLI پیکربندی: [پیکربندی](/fa/cli/config)

## گزینه‌ها

- `--section <section>`: فیلتر بخش قابل تکرار

بخش‌های موجود:

- `workspace`
- `model`
- `web`
- `gateway`
- `daemon`
- `channels`
- `plugins`
- `skills`
- `health`

نکات:

- انتخاب محل اجرای Gateway همیشه `gateway.mode` را به‌روزرسانی می‌کند. اگر فقط همین را نیاز دارید، می‌توانید بدون بخش‌های دیگر «ادامه» را انتخاب کنید.
- پس از نوشتن پیکربندی محلی، configure وقتی مسیر راه‌اندازی انتخاب‌شده به Pluginهای قابل دانلود نیاز داشته باشد، آن‌ها را نصب می‌کند. پیکربندی Gateway راه دور بسته‌های Plugin محلی را نصب نمی‌کند.
- سرویس‌های کانال‌محور (Slack/Discord/Matrix/Microsoft Teams) هنگام راه‌اندازی برای فهرست‌های مجاز کانال/اتاق درخواست می‌دهند. می‌توانید نام‌ها یا شناسه‌ها را وارد کنید؛ ویزارد در صورت امکان نام‌ها را به شناسه‌ها تبدیل می‌کند.
- اگر مرحله نصب daemon را اجرا کنید، احراز هویت توکنی به یک توکن نیاز داشته باشد، و `gateway.auth.token` با SecretRef مدیریت شود، configure مقدار SecretRef را اعتبارسنجی می‌کند اما مقادیر توکن متن ساده حل‌شده را در فراداده محیط سرویس supervisor ذخیره نمی‌کند.
- اگر احراز هویت توکنی به یک توکن نیاز داشته باشد و SecretRef توکن پیکربندی‌شده حل نشده باشد، configure نصب daemon را با راهنمایی اصلاحی قابل اقدام مسدود می‌کند.
- اگر هم `gateway.auth.token` و هم `gateway.auth.password` پیکربندی شده باشند و `gateway.auth.mode` تنظیم نشده باشد، configure نصب daemon را تا زمانی که mode صراحتا تنظیم شود مسدود می‌کند.

## مثال‌ها

```bash
openclaw configure
openclaw configure --section web
openclaw configure --section model --section channels
openclaw configure --section gateway --section daemon
```

## مرتبط

- [مرجع CLI](/fa/cli)
- [پیکربندی](/fa/gateway/configuration)