CLI commands
إعداد
openclaw configure
مطالبات تفاعلية لإجراء تغييرات محددة على إعداد موجود: بيانات الاعتماد، والأجهزة، والإعدادات الافتراضية للوكيل، وGateway، والقنوات، وplugins، و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 البعيد إلى كتابة التكوين البعيد والخروج فورًا؛ ولا يشغّل خطوات محلية فقط مثل تثبيت plugins.
قسم النموذج
عندما يبدأ الإعداد من خيار مصادقة موفّر، يفضّل منتقيا النموذج الافتراضي وقائمة السماح ذلك الموفّر تلقائيًا. وبالنسبة إلى الموفّرين المقترنين مثل 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غير معيّنة، يمنع الإعداد تثبيت الخدمة الخفية إلى أن تضبط الوضع صراحةً.