Skip to main content

​
openclaw configure

مطالبات تفاعلية لإجراء تغييرات محددة على إعداد موجود: بيانات الاعتماد، والأجهزة، والإعدادات الافتراضية للوكيل، وGateway، والقنوات، وplugins، وSkills، وفحوصات السلامة. استخدم openclaw onboard أو openclaw setup لخوض تجربة التشغيل الأول الكاملة والموجّهة، واستخدم openclaw setup --baseline لإعداد التكوين الأساسي ومساحة العمل فقط، واستخدم openclaw channels add عندما لا تحتاج إلا إلى إعداد حساب القناة.
يفتح openclaw config من دون أمر فرعي المعالج نفسه. استخدم openclaw config get|set|unset لإجراء تعديلات غير تفاعلية.

​
الخيارات

--section <section>: عامل تصفية قابل للتكرار للأقسام. الأقسام المتاحة: workspace، model، web، gateway، daemon، channels، plugins، skills، health
يؤدي تحديد gateway أو daemon أو health (أو تشغيل المعالج الكامل من دون --section) إلى المطالبة بتحديد مكان تشغيل Gateway وتحديث gateway.mode. أما عوامل تصفية الأقسام التي تتخطى الأقسام الثلاثة جميعها، فتنتقل مباشرةً إلى الإعداد المطلوب من دون مطالبة بوضع Gateway. يؤدي اختيار وضع Gateway البعيد إلى كتابة التكوين البعيد والخروج فورًا؛ ولا يشغّل خطوات محلية فقط مثل تثبيت plugins.
يتطلب openclaw configure طرفية تفاعلية (يجب أن يكون كل من الإدخال القياسي والإخراج القياسي TTY). وفي غيابها، يطبع أوامر openclaw config get|set|patch|validate غير التفاعلية المكافئة، ثم يخرج بخطأ بدلًا من التشغيل الجزئي.

​
قسم النموذج

يتضمن النموذج اختيارًا متعددًا لقائمة السماح agents.defaults.models (وهي ما يظهر في /model ومنتقي النماذج). تدمج خيارات الإعداد الخاصة بموفّر معيّن النماذج المحددة في قائمة السماح الحالية، بدلًا من استبدال الموفّرين غير المرتبطين الموجودين مسبقًا في التكوين.تحافظ إعادة تشغيل مصادقة الموفّر من خلال الإعداد على قيمة agents.defaults.model.primary الحالية، حتى عندما تُرجع خطوة مصادقة الموفّر رقعة تكوين تتضمن نموذجًا افتراضيًا موصى به خاصًا بها. تؤدي إضافة موفّر أو إعادة مصادقته إلى إتاحة نماذجه من دون الاستحواذ على نموذجك الأساسي الحالي. استخدم openclaw models auth login --provider <id> --set-default أو openclaw models set <model> لتغيير النموذج الافتراضي عمدًا.
عندما يبدأ الإعداد من خيار مصادقة موفّر، يفضّل منتقيا النموذج الافتراضي وقائمة السماح ذلك الموفّر تلقائيًا. وبالنسبة إلى الموفّرين المقترنين مثل Volcengine وBytePlus، تطابق الأفضلية نفسها أيضًا متغيرات خطط البرمجة الخاصة بهما (volcengine-plan/* وbyteplus-plan/*). إذا كان عامل تصفية الموفّر المفضّل سيؤدي إلى قائمة فارغة، يعود الإعداد إلى الكتالوج غير المصفّى بدلًا من عرض منتقٍ فارغ.

​
قسم الويب

يختار openclaw configure --section web موفّرًا للبحث على الويب ويضبط بيانات اعتماده. يعرض بعض الموفّرين خيارات متابعة خاصة بالموفّر:
  • يمكن أن يوفّر Grok إعداد x_search اختياريًا باستخدام ملف تعريف xAI OAuth نفسه أو مفتاح API، ويتيح لك اختيار نموذج x_search.
  • يمكن أن يطلب Kimi منطقة Moonshot API (api.moonshot.ai مقابل api.moonshot.cn) ونموذج Kimi الافتراضي للبحث على الويب.

​
ملاحظات أخرى

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

​
ذو صلة