CLI commands

إعداد

openclaw configure

موجّه تفاعلي لإعداد بيانات الاعتماد والأجهزة وافتراضيات الوكيل.

عندما يبدأ configure من خيار مصادقة مزوّد، يفضّل منتقيا النموذج الافتراضي وقائمة السماح ذلك المزوّد تلقائيًا. بالنسبة إلى المزوّدين المقترنين مثل Volcengine وBytePlus، يطابق التفضيل نفسه أيضًا متغيرات خطة البرمجة الخاصة بهم (volcengine-plan/*، byteplus-plan/*). إذا كان مرشح المزوّد المفضّل سينتج قائمة فارغة، يعود configure إلى الكتالوج غير المفلتر بدلًا من عرض منتقي فارغ.

للبحث على الويب، يتيح لك openclaw configure --section web اختيار مزوّد وتهيئة بيانات اعتماده. يعرض بعض المزوّدين أيضًا موجّهات متابعة خاصة بالمزوّد:

  • يمكن لـ Grok أن يقدّم إعداد x_search اختياريًا باستخدام XAI_API_KEY نفسه وأن يتيح لك اختيار نموذج x_search.
  • يمكن لـ Kimi أن يطلب منطقة Moonshot API (api.moonshot.ai مقابل api.moonshot.cn) ونموذج بحث الويب الافتراضي من Kimi.

ذات صلة:

الخيارات

  • --section <section>: مرشح قسم قابل للتكرار

الأقسام المتاحة:

  • workspace
  • model
  • web
  • gateway
  • daemon
  • channels
  • plugins
  • skills
  • health

ملاحظات:

  • يؤدي اختيار مكان تشغيل Gateway دائمًا إلى تحديث gateway.mode. يمكنك اختيار "متابعة" بدون أقسام أخرى إذا كان ذلك كل ما تحتاجه.
  • بعد كتابة التهيئة المحلية، يثبّت configure الـPlugins القابلة للتنزيل المحددة عندما يتطلبها مسار الإعداد المختار. لا تثبّت تهيئة Gateway البعيد حزم Plugin المحلية.
  • تطلب الخدمات الموجّهة للقنوات (Slack/Discord/Matrix/Microsoft Teams) قوائم سماح للقنوات/الغرف أثناء الإعداد. يمكنك إدخال أسماء أو معرّفات؛ يحلّ المعالج الأسماء إلى معرّفات عندما يكون ذلك ممكنًا.
  • إذا شغّلت خطوة تثبيت الخفي، وكانت مصادقة الرمز تتطلب رمزًا، وكان gateway.auth.token مُدارًا بواسطة SecretRef، فإن configure يتحقق من SecretRef لكنه لا يحفظ قيم الرمز النصية الصريحة المحلولة في بيانات بيئة خدمة المشرف الوصفية.
  • إذا كانت مصادقة الرمز تتطلب رمزًا وكان SecretRef للرمز المهيأ غير محلول، يحظر configure تثبيت الخفي مع إرشادات معالجة قابلة للتنفيذ.
  • إذا كان كل من gateway.auth.token وgateway.auth.password مهيأين وكان gateway.auth.mode غير مضبوط، يحظر configure تثبيت الخفي حتى يتم ضبط الوضع صراحةً.

أمثلة

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

ذات صلة