llmster). للاطلاع على وثائق المنتج والإعداد، راجع lmstudio.ai.
البدء السريع
- ثبّت LM Studio (سطح المكتب) أو
llmster(بلا واجهة)، ثم شغّل الخادم المحلي:
- شغّل الخادم
- إذا كانت مصادقة LM Studio مفعّلة، فعيّن
LM_API_TOKEN:
- شغّل الإعداد الأولي واختر
LM Studio:
- في الإعداد الأولي، استخدم مطالبة
Default modelلاختيار نموذج LM Studio.
author/model-name (مثل qwen/qwen3.5-9b). تسبق مراجع نماذج OpenClaw
اسم المزوّد: lmstudio/qwen/qwen3.5-9b. يمكنك العثور على المفتاح الدقيق
لنموذج عبر تشغيل curl http://localhost:1234/api/v1/models والنظر إلى حقل key.
الإعداد الأولي غير التفاعلي
استخدم الإعداد الأولي غير التفاعلي عندما تريد تنفيذ الإعداد عبر سكربت (CI أو التجهيز أو التشغيل التمهيدي عن بُعد):--custom-model-id مفتاح النموذج كما ترجعه LM Studio (مثل qwen/qwen3.5-9b)، من دون
بادئة المزوّد lmstudio/.
لخوادم LM Studio التي تستخدم المصادقة، مرّر --lmstudio-api-key أو عيّن LM_API_TOKEN.
لخوادم LM Studio التي لا تستخدم المصادقة، احذف المفتاح؛ يخزّن OpenClaw علامة محلية غير سرية.
يبقى --custom-api-key مدعومًا للتوافق، لكن يُفضّل استخدام --lmstudio-api-key مع LM Studio.
يكتب هذا models.providers.lmstudio ويعيّن النموذج الافتراضي إلى
lmstudio/<custom-model-id>. عند تقديم مفتاح API، يكتب الإعداد أيضًا
ملف تعريف المصادقة lmstudio:default.
يمكن للإعداد التفاعلي أن يطلب طول سياق تحميل مفضلًا اختياريًا ويطبّقه على نماذج LM Studio المكتشفة التي يحفظها في الإعدادات.
يثق إعداد Plugin الخاص بـ LM Studio بنقطة نهاية LM Studio المضبوطة لطلبات النماذج، بما في ذلك local loopback ومضيفو LAN وtailnet. ما زالت مصادر metadata/link-local تتطلب موافقة صريحة. يمكنك إلغاء الاشتراك بتعيين models.providers.lmstudio.request.allowPrivateNetwork: false.
الإعدادات
توافق استخدام البث
LM Studio متوافق مع استخدام البث. عندما لا يصدر كائنusage على هيئة OpenAI، يستعيد OpenClaw أعداد الرموز من بيانات التعريف بنمط llama.cpp
timings.prompt_n / timings.predicted_n بدلًا من ذلك.
ينطبق سلوك استخدام البث نفسه على الخلفيات المحلية المتوافقة مع OpenAI التالية:
- vLLM
- SGLang
- llama.cpp
- LocalAI
- Jan
- TabbyAPI
- text-generation-webui
توافق التفكير
عندما يبلّغ اكتشاف/api/v1/models في LM Studio عن خيارات استدلال خاصة بالنموذج،
يعرض OpenClaw قيم reasoning_effort المتوافقة مع OpenAI المطابقة
في بيانات توافق النموذج الوصفية. يمكن لإصدارات LM Studio الحالية أن تعلن عن خيارات UI ثنائية
مثل allowed_options: ["off", "on"] مع رفض تلك القيم
على /v1/chat/completions؛ يطبّع OpenClaw شكل الاكتشاف الثنائي هذا إلى
none وminimal وlow وmedium وhigh وxhigh قبل إرسال الطلبات.
تُطبّع إعدادات LM Studio المحفوظة القديمة التي تحتوي على خرائط استدلال off/on
بالطريقة نفسها عند تحميل الكتالوج.
إعدادات صريحة
استكشاف الأخطاء وإصلاحها
لم يتم اكتشاف LM Studio
تأكد من أن LM Studio يعمل. إذا كانت المصادقة مفعّلة، فعيّن أيضًاLM_API_TOKEN:
أخطاء المصادقة (HTTP 401)
إذا أبلغ الإعداد عن HTTP 401، فتحقق من مفتاح API:- تحقق من أن
LM_API_TOKENيطابق المفتاح المضبوط في LM Studio. - لتفاصيل إعداد مصادقة LM Studio، راجع مصادقة LM Studio.
- إذا كان خادمك لا يتطلب مصادقة، فاترك المفتاح فارغًا أثناء الإعداد.
تحميل النموذج عند الحاجة
يدعم LM Studio تحميل النماذج عند الحاجة (JIT)، حيث تُحمّل النماذج عند أول طلب. يحمّل OpenClaw النماذج مسبقًا عبر نقطة نهاية التحميل الأصلية في LM Studio افتراضيًا، مما يساعد عندما يكون JIT معطّلًا. للسماح لسلوكيات JIT وTTL الخامل والإخلاء التلقائي في LM Studio بامتلاك دورة حياة النموذج، عطّل خطوة التحميل المسبق في OpenClaw:مضيف LM Studio على LAN أو tailnet
استخدم العنوان القابل للوصول لمضيف LM Studio، واحتفظ بـ/v1، وتأكد من أن LM Studio مرتبط بما يتجاوز loopback على ذلك الجهاز:
lmstudio تلقائيًا بنقطة النهاية المحلية/الخاصة المضبوطة لطلبات النماذج المحمية. تثق إدخالات المزوّد المخصص/المحلي المتوافقة مع OpenAI أيضًا بمصدر baseUrl المضبوط بدقة، باستثناء مصادر metadata/link-local؛ ما زالت الطلبات إلى منافذ أو وجهات خاصة مختلفة تتطلب models.providers.<id>.request.allowPrivateNetwork: true. عيّن models.providers.<id>.request.allowPrivateNetwork: false لإلغاء الثقة بالمصدر المطابق.