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ها را اجرا نمی‌کند.

بخش مدل

وقتی configure از یک گزینهٔ احراز هویت ارائه‌دهنده آغاز می‌شود، انتخاب‌گرهای مدل پیش‌فرض و خط‌مشی مدل به‌طور خودکار آن ارائه‌دهنده را ترجیح می‌دهند. برای ارائه‌دهندگان جفت‌شده مانند Volcengine و BytePlus، همین ترجیح گونه‌های طرح کدنویسی آن‌ها (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 را بپرسد.

نکات دیگر

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

مرتبط

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