Documentation Index
Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt
Use this file to discover all available pages before exploring further.
models.providers.<id>.localService يتيح لـ OpenClaw بدء خادم نماذج محلي مملوك للمزوّد عند الطلب. هذا إعداد على مستوى المزوّد: عندما ينتمي النموذج المحدد إلى ذلك المزوّد، يفحص OpenClaw الخدمة، ويبدأ العملية إذا كانت نقطة النهاية متوقفة، وينتظر الجاهزية، ثم يرسل طلب النموذج.
استخدمه للخوادم المحلية التي تكون مكلفة إذا بقيت قيد التشغيل طوال اليوم، أو للإعدادات اليدوية التي ينبغي أن يكون اختيار النموذج فيها كافيًا لتشغيل الواجهة الخلفية.
كيف يعمل
- يُحل طلب النموذج إلى مزوّد مهيأ.
- إذا كان لدى ذلك المزوّد
localService، يفحص OpenClawhealthUrl. - إذا نجح الفحص، يستخدم OpenClaw الخادم الموجود.
- إذا فشل الفحص، يبدأ OpenClaw تشغيل
commandمعargs. - يستطلع OpenClaw الجاهزية حتى تنتهي مدة
readyTimeoutMs. - يُرسل طلب النموذج عبر نقل المزوّد المعتاد.
- إذا كان OpenClaw قد بدأ العملية وكانت
idleStopMsموجبة، فستُوقف العملية بعد أن يظل آخر طلب قيد التنفيذ خاملًا لتلك المدة.
شكل الإعداد
الحقول
command: مسار تنفيذي مطلق. لا يُستخدم بحث الصدفة.args: وسائط العملية. لا تُطبّق أي قواعد لتوسيع الصدفة أو الأنابيب أو أنماط glob أو الاقتباس.cwd: دليل العمل الاختياري للعملية.env: متغيرات بيئة اختيارية تُدمج فوق بيئة عملية OpenClaw.healthUrl: عنوان URL للجاهزية. إذا حُذف، يلحق OpenClaw/modelsبـbaseUrl، بحيث يصبحhttp://127.0.0.1:8000/v1هوhttp://127.0.0.1:8000/v1/models.readyTimeoutMs: مهلة جاهزية بدء التشغيل. الافتراضي:120000.idleStopMs: تأخير إيقاف الخمول للعمليات التي يبدأها OpenClaw. القيمة0أو الحذف يبقيان العملية حية حتى يخرج OpenClaw.
مثال Inferrs
Inferrs واجهة خلفية مخصصة متوافقة مع OpenAI عبر/v1، لذلك تعمل واجهة خدمة محلية API نفسها مع إدخال مزوّد inferrs.
command بنتيجة which inferrs على الجهاز الذي يشغّل OpenClaw.
مثال ds4
ملاحظات تشغيلية
- تدير عملية OpenClaw واحدة العملية الفرعية التي بدأتها. أي عملية OpenClaw أخرى ترى عنوان URL للصحة نفسه قيد التشغيل بالفعل ستعيد استخدامه دون تبنيه.
- يُسلسل بدء التشغيل لكل أمر مزوّد ومجموعة وسائط، لذلك لا تؤدي الطلبات المتزامنة إلى إنشاء خوادم مكررة للإعداد نفسه.
- تحتفظ استجابات البث النشطة بإيجار؛ وينتظر إيقاف الخمول حتى تكتمل معالجة جسم الاستجابة.
- استخدم
timeoutSecondsعلى المزوّدين المحليين البطيئين حتى لا تصطدم عمليات البدء الباردة وعمليات التوليد الطويلة بمهلة طلب النموذج الافتراضية. - استخدم
healthUrlصريحًا إذا كان خادمك يعرّض الجاهزية في مكان آخر غير/v1/models.
ذو صلة
النماذج المحلية
إعداد النموذج المحلي، وخيارات المزوّد، وإرشادات السلامة.
Inferrs
شغّل OpenClaw عبر خادم inferrs المحلي المتوافق مع OpenAI.