CLI commands
پیکربندی
openclaw configure
اعلان تعاملی برای تغییرات هدفمند در یک راهاندازی موجود: اعتبارنامهها، دستگاهها، پیشفرضهای عامل، Gateway، کانالها، Pluginها، Skills و بررسیهای سلامت.
برای مسیر کامل راهنماییشده در اولین اجرا از openclaw onboard یا openclaw setup استفاده کنید، برای فقط پیکربندی/فضای کاری پایه از openclaw setup --baseline، و وقتی فقط به راهاندازی حساب کانال نیاز دارید از openclaw channels add استفاده کنید.
وقتی configure از یک انتخاب احراز هویت ارائهدهنده شروع میشود، انتخابگرهای مدل پیشفرض و فهرست مجاز بهطور خودکار همان ارائهدهنده را ترجیح میدهند. برای ارائهدهندگان جفتشده مانند Volcengine و BytePlus، همین ترجیح با گونههای coding-plan آنها نیز مطابقت دارد (volcengine-plan/*، byteplus-plan/*). اگر فیلتر ارائهدهنده ترجیحی فهرستی خالی تولید کند، configure بهجای نمایش انتخابگری خالی، به کاتالوگ فیلترنشده برمیگردد.
برای جستوجوی وب، openclaw configure --section web به شما امکان میدهد یک ارائهدهنده انتخاب کنید
و اعتبارنامههای آن را پیکربندی کنید. برخی ارائهدهندگان همچنین اعلانهای پیگیری
ویژه ارائهدهنده را نمایش میدهند:
- Grok میتواند راهاندازی اختیاری
x_searchرا با همان نمایه OAuth مربوط به xAI یا کلید API پیشنهاد کند و اجازه دهد یک مدلx_searchانتخاب کنید. - Kimi میتواند منطقه API مربوط به Moonshot (
api.moonshot.aiدر برابرapi.moonshot.cn) و مدل پیشفرض جستوجوی وب Kimi را بپرسد.
مرتبط:
گزینهها
--section <section>: فیلتر بخش تکرارپذیر
بخشهای موجود:
workspacemodelwebgatewaydaemonchannelspluginsskillshealth
نکتهها:
- جادوگر کامل و بخشهای مرتبط با Gateway میپرسند Gateway کجا اجرا میشود و
gateway.modeرا بهروزرسانی میکنند. فیلترهای بخشی که شاملgateway،daemonیاhealthنیستند مستقیماً به راهاندازی درخواستشده میروند. - پس از نوشتن پیکربندی محلی، 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 configureopenclaw configure --section webopenclaw configure --section model --section channelsopenclaw configure --section gateway --section daemon