Fundamentals
الميزات التجريبية
الميزات التجريبية في OpenClaw هي واجهات معاينة اختيارية التفعيل. وهي موجودة خلف أعلام صريحة لأنها ما زالت تحتاج إلى تجربة واقعية قبل أن تستحق إعدادًا افتراضيًا مستقرًا أو عقدًا عامًا طويل الأمد.
تعامل معها بطريقة مختلفة عن الإعدادات العادية:
- أبقها معطلة افتراضيًا ما لم تطلب منك الوثيقة ذات الصلة تجربة إحداها.
- توقّع أن يتغير الشكل والسلوك بسرعة أكبر من الإعدادات المستقرة.
- فضّل المسار المستقر أولًا عندما يكون موجودًا بالفعل.
- إذا كنت تنشر OpenClaw على نطاق واسع، فاختبر الأعلام التجريبية في بيئة أصغر قبل تثبيتها ضمن خط أساس مشترك.
الأعلام الموثقة حاليًا
| الواجهة | المفتاح | استخدمه عندما | المزيد |
|---|---|---|---|
| وقت تشغيل النموذج المحلي | agents.defaults.experimental.localModelLean |
يتعثر خلفي محلي أصغر أو أكثر صرامة مع واجهة الأدوات الافتراضية الكاملة في OpenClaw | النماذج المحلية |
| بحث الذاكرة | agents.defaults.memorySearch.experimental.sessionMemory |
تريد أن يفهرس memory_search نسخ الجلسات السابقة وأن تقبل تكلفة التخزين والفهرسة الإضافية |
مرجع إعدادات الذاكرة |
| أداة التخطيط المنظّم | tools.experimental.planTool |
تريد إتاحة أداة update_plan المنظّمة لتتبع العمل متعدد الخطوات في أوقات التشغيل وواجهات المستخدم المتوافقة |
مرجع إعدادات Gateway |
وضع النموذج المحلي الخفيف
agents.defaults.experimental.localModelLean: true هو صمام تخفيف ضغط لإعدادات النماذج المحلية الأضعف. عند تفعيله، يزيل OpenClaw ثلاث أدوات افتراضية، وهي browser وcron وmessage، من واجهة أدوات الوكيل في كل دور. لا يتغير أي شيء آخر.
لماذا هذه الأدوات الثلاث
هذه الأدوات الثلاث لديها أطول الأوصاف وأكثر أشكال المعلمات في وقت تشغيل OpenClaw الافتراضي. في خلفي صغير السياق أو أكثر صرامة ومتوافق مع OpenAI، يكون هذا هو الفرق بين:
- ملاءمة مخططات الأدوات بسلاسة داخل الموجه مقابل مزاحمة سجل المحادثة.
- اختيار النموذج للأداة الصحيحة مقابل إصدار استدعاءات أدوات مشوهة بسبب كثرة المخططات المتشابهة.
- بقاء مهايئ Chat Completions داخل حدود الخرج المنظّم في الخادم مقابل التسبب في خطأ 400 بسبب حجم حمولة استدعاء الأداة.
إزالتها لا تعيد توصيل OpenClaw بصمت، بل تجعل قائمة الأدوات أقصر فقط. ما يزال لدى النموذج أدوات read وwrite وedit وexec وapply_patch وبحث/جلب الويب عند تكوينها، والذاكرة، وأدوات الجلسة/الوكيل المتاحة.
متى تفعّله
فعّل الوضع الخفيف عندما تكون قد أثبتّ بالفعل أن النموذج يستطيع التحدث إلى Gateway لكن أدوار الوكيل الكاملة تتصرف بشكل غير صحيح. سلسلة الإشارات المعتادة هي:
- ينجح
openclaw infer model run --gateway --model <ref> --prompt "Reply with exactly: pong". - يفشل دور وكيل عادي بسبب استدعاءات أدوات مشوهة، أو موجهات زائدة الحجم، أو تجاهل النموذج لأدواته.
- يؤدي تبديل
localModelLean: trueإلى إزالة الفشل.
متى تتركه معطلًا
إذا كان الخلفي لديك يتعامل بسلاسة مع وقت التشغيل الافتراضي الكامل، فاترك هذا معطلًا. الوضع الخفيف حل التفافي، وليس إعدادًا افتراضيًا. وهو موجود لأن بعض الحزم المحلية تحتاج إلى واجهة أدوات أصغر كي تعمل كما ينبغي؛ أما النماذج المستضافة والأجهزة المحلية جيدة الموارد فلا تحتاج إليه.
كما أن الوضع الخفيف لا يحل محل tools.profile أو tools.allow/tools.deny أو مخرج الطوارئ compat.supportsTools: false الخاص بالنموذج. إذا كنت تحتاج إلى واجهة أدوات أضيق ودائمة لوكيل محدد، ففضّل هذه المفاتيح المستقرة على العلم التجريبي.
التفعيل
{
agents: {
defaults: {
experimental: {
localModelLean: true,
},
},
},
}
أعد تشغيل Gateway بعد تغيير العلم، ثم تأكد من قائمة الأدوات المختصرة باستخدام:
openclaw status --deep
يسرد خرج الحالة العميقة أدوات الوكيل النشطة؛ يجب أن تكون browser وcron وmessage غائبة عندما يكون الوضع الخفيف مفعلًا.
التجريبي لا يعني مخفيًا
إذا كانت ميزة ما تجريبية، فيجب أن يقول OpenClaw ذلك بوضوح في الوثائق وفي مسار الإعداد نفسه. وما يجب ألا يفعله هو تمرير سلوك معاينة خفية ضمن مفتاح افتراضي يبدو مستقرًا والتظاهر بأن ذلك طبيعي. هكذا تصبح واجهات الإعدادات فوضوية.