# openclaw configure

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

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

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

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

مرتبط:

• مرجع پیکربندی Gateway: پیکربندی
• CLI پیکربندی: پیکربندی

# گزینه‌ها

• --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 را تا زمانی که حالت به‌صراحت تنظیم شود مسدود می‌کند.

# نمونه‌ها

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

# مرتبط

• مرجع CLI
• پیکربندی