CLI commands
پیکربندی کنید
openclaw configure
پرسشهای تعاملی برای اعمال تغییرات هدفمند در یک راهاندازی موجود: اطلاعات احراز هویت، دستگاهها، پیشفرضهای عامل، Gateway، کانالها، Pluginها، Skills و بررسیهای سلامت.
برای فرایند کامل و هدایتشدهٔ اجرای نخست از openclaw onboard یا openclaw setup، فقط برای پیکربندی پایه و فضای کاری از openclaw setup --baseline و هنگامی که تنها به راهاندازی حساب کانال نیاز دارید از openclaw channels add استفاده کنید.
گزینهها
--section <section>: فیلتر تکرارپذیر بخشها. بخشهای موجود:
workspace، model، web، gateway، daemon، channels، plugins، skills، health
openclaw configureopenclaw configure --section webopenclaw configure --section model --section channelsopenclaw configure --section gateway --section daemonانتخاب gateway، daemon یا health (یا اجرای راهنمای کامل بدون --section) دربارهٔ محل اجرای Gateway پرسش میکند و gateway.mode را بهروزرسانی میکند. فیلترهای بخشی که هر سه مورد را نادیده میگیرند، بدون پرسش دربارهٔ حالت Gateway مستقیماً به راهاندازی درخواستی میروند. انتخاب حالت Gateway راهدور، پیکربندی راهدور را مینویسد و بلافاصله خارج میشود؛ مراحل مختص اجرای محلی، مانند نصب Pluginها، اجرا نمیشوند.
بخش مدل
هنگامی که پیکربندی از گزینهٔ احراز هویت یک ارائهدهنده آغاز میشود، انتخابگرهای مدل پیشفرض و فهرست مجاز بهطور خودکار آن ارائهدهنده را ترجیح میدهند. برای ارائهدهندگان جفتشدهای مانند Volcengine و BytePlus، همین ترجیح گونههای طرح برنامهنویسی آنها (volcengine-plan/* و byteplus-plan/*) را نیز تطبیق میدهد. اگر فیلتر ارائهدهندهٔ ترجیحی به فهرستی خالی منجر شود، پیکربندی بهجای نمایش انتخابگری خالی، از کاتالوگ فیلترنشده استفاده میکند.
بخش وب
openclaw configure --section web یک ارائهدهندهٔ جستوجوی وب را انتخاب و اطلاعات احراز هویت آن را پیکربندی میکند. برخی ارائهدهندگان گزینههای تکمیلی مختص خود را نمایش میدهند:
- Grok میتواند راهاندازی اختیاری
x_searchرا با همان نمایهٔ OAuth یا کلید API متعلق به xAI ارائه دهد و امکان انتخاب یک مدلx_searchرا فراهم کند. - Kimi میتواند دربارهٔ منطقهٔ API متعلق به Moonshot (
api.moonshot.aiدر برابرapi.moonshot.cn) و مدل پیشفرض جستوجوی وب Kimi سؤال کند.
نکات دیگر
- پس از نوشتن پیکربندی محلی، اگر مسیر راهاندازی انتخابشده به Pluginهای قابل بارگیری نیاز داشته باشد، پیکربندی آنها را نصب میکند. پیکربندی Gateway راهدور بستههای محلی Plugin را نصب نمیکند.
- سرویسهای مبتنی بر کانال (Slack/Discord/Matrix/Microsoft Teams) هنگام راهاندازی، فهرست مجاز کانالها یا اتاقها را درخواست میکنند. میتوانید نام یا شناسه وارد کنید؛ راهنما در صورت امکان نامها را به شناسه تبدیل میکند.
- اگر مرحلهٔ نصب دیمن را اجرا کنید، احراز هویت توکنی به توکن نیاز دارد. اگر
gateway.auth.tokenبا SecretRef مدیریت شود، پیکربندی SecretRef را اعتبارسنجی میکند، اما مقادیر متن سادهٔ توکنِ حلشده را در فرادادهٔ محیط سرویس ناظر ذخیره نمیکند؛ اگر SecretRef حلنشده باشد، پیکربندی نصب دیمن را مسدود میکند و راهنمای عملی برای رفع مشکل ارائه میدهد. - اگر هم
gateway.auth.tokenو همgateway.auth.passwordپیکربندی شده باشند وgateway.auth.modeتنظیم نشده باشد، پیکربندی تا زمانی که حالت را صریحاً تعیین نکنید، نصب دیمن را مسدود میکند.
