Skip to main content
استخدم هذه الصفحة لاختيار واجهة الإمكانات المناسبة. الأدوات هي إجراءات قابلة للاستدعاء، وتعلّم Skills الوكلاء كيفية العمل، بينما تضيف Plugins إمكانات وقت التشغيل مثل الأدوات والموفّرين والقنوات والخطافات وحزم Skills. هذه صفحة نظرة عامة وتوجيه. للاطلاع على سياسة الأدوات والإعدادات الافتراضية وعضوية المجموعات وقيود الموفّرين وحقول التكوين بصورة شاملة، استخدم الأدوات والموفّرين المخصصين.

ابدأ من هنا

بالنسبة إلى معظم الوكلاء، ابدأ بفئات الأدوات المضمّنة، ثم عدّل السياسة فقط عندما ينبغي أن يرى الوكيل أدوات أقل أو يحتاج إلى وصول صريح إلى المضيف.

اختر الأدوات أو Skills أو Plugins

1

استخدم أداة عندما يحتاج الوكيل إلى تنفيذ إجراء

الأداة هي دالة محددة الأنواع يمكن للوكيل استدعاؤها، مثل exec أو browser أو web_search أو message أو image_generate. استخدم الأدوات عندما يحتاج الوكيل إلى قراءة البيانات أو تغيير الملفات أو إرسال الرسائل أو استدعاء موفّر أو تشغيل نظام آخر. تُرسل الأدوات المرئية إلى النموذج على هيئة تعريفات دوال منظّمة.لا يرى النموذج إلا الأدوات التي تجتاز ملف التعريف النشط وسياسة السماح/المنع وقيود الموفّر وحالة بيئة العزل وأذونات القناة وتوفّر Plugin.
2

استخدم Skill عندما يحتاج الوكيل إلى تعليمات

Skill هي حزمة تعليمات SKILL.md تُحمّل في مطالبة الوكيل. استخدم Skill عندما يمتلك الوكيل الأدوات التي يحتاج إليها بالفعل، لكنه يحتاج إلى سير عمل قابل للتكرار أو معايير مراجعة أو تسلسل أوامر أو قيد تشغيلي.يمكن أن توجد Skills في مساحة عمل أو دليل Skills مشترك أو جذر Skills مُدار من OpenClaw أو حزمة Plugin.Skills | ورشة Skills | إنشاء Skills | تكوين Skills
3

استخدم Plugin عندما يحتاج OpenClaw إلى إمكانية جديدة

يمكن أن يضيف Plugin أدوات وSkills وقنوات وموفّري نماذج وتحويل النص إلى كلام وصوتًا آنيًا وإنشاء الوسائط والبحث في الويب وجلب محتوى الويب والخطافات وإمكانات أخرى لوقت التشغيل. استخدم Plugin عندما تتضمن الإمكانية شيفرة أو بيانات اعتماد أو خطافات دورة حياة أو بيانات وصفية لبيان أو حزمة قابلة للتثبيت. يمكن تثبيت Plugins الموجودة من ClawHub أو npm أو git أو الأدلة المحلية أو الأرشيفات.تثبيت Plugins وتكوينها | بناء Plugins | حزمة تطوير Plugin

فئات الأدوات المضمّنة

يسرد الجدول أدوات تمثيلية لمساعدتك على التعرّف على الواجهة. وهو ليس مرجع السياسة الكامل. لمعرفة المجموعات الدقيقة والإعدادات الافتراضية ودلالات السماح/المنع، استخدم الأدوات والموفّرين المخصصين.
البحث عن الأدوات هو واجهة تجريبية لوكلاء OpenClaw. تستخدم عمليات بيئة تشغيل Codex وضع الشيفرة الأصلي في Codex والبحث الأصلي عن الأدوات والأدوات الديناميكية المؤجلة واستدعاءات الأدوات المتداخلة بدلًا من tools.toolSearch.

الأدوات التي توفّرها Plugins

يمكن لـ Plugins تسجيل أدوات إضافية. يربط مؤلفو Plugins الأدوات عبر api.registerTool(...) وcontracts.tools في البيان؛ استخدم حزمة تطوير Plugin وبيان Plugin للحصول على تفاصيل العقود. تشمل الأدوات الشائعة التي توفّرها Plugins ما يلي:
  • الفروقات لعرض فروقات الملفات وMarkdown
  • عرض عنصر واجهة لعرض SVG وHTML مستقلين مضمنين في محادثة الويب
  • مهمة LLM لخطوات سير العمل التي تقتصر على JSON
  • Lobster لعمليات سير عمل محددة الأنواع ذات موافقات قابلة للاستئناف
  • Tokenjuice لضغط مخرجات أداتي exec وbash كثيرة الضوضاء
  • البحث عن الأدوات لاكتشاف فهارس الأدوات الكبيرة واستدعائها دون وضع كل مخطط في المطالبة
  • Canvas للتحكم في Canvas على العُقد وعرض A2UI

تكوين الوصول والموافقات

تُفرض سياسة الأدوات قبل استدعاء النموذج. إذا أزالت السياسة أداة، فلن يتلقى النموذج مخطط تلك الأداة في هذه الدورة. قد يفقد التشغيل أدوات بسبب التكوين العام أو تكوين كل وكيل أو سياسة القناة أو قيود الموفّر أو قواعد بيئة العزل أو سياسة القناة/وقت التشغيل أو توفّر Plugin.

توسيع الإمكانات

اختر مسار التوسعة وفقًا للمهمة التي تريد من OpenClaw تنفيذها:
  • ثبّت Plugin موجودًا أو أدره باستخدام Plugins.
  • أنشئ تكاملًا أو موفّرًا أو قناة أو أداة أو خطافًا جديدًا باستخدام بناء Plugins.
  • أضف تعليمات وكيل قابلة لإعادة الاستخدام أو اضبطها باستخدام Skills و إنشاء Skills.
  • استخدم حزمة تطوير Plugin و بيان Plugin عندما تحتاج إلى عقود التنفيذ.

استكشاف أخطاء الأدوات المفقودة وإصلاحها

إذا تعذّر على النموذج رؤية أداة أو استدعاؤها، فابدأ بالسياسة الفعلية للدورة الحالية:
  1. تحقّق من ملف التعريف النشط وtools.allow وtools.deny في الأدوات والموفّرين المخصصين.
  2. تحقّق من القيود الخاصة بالموفّر في الأدوات والموفّرين المخصصين، وتأكّد من أن موفّر النموذج المحدد يدعم بنية الأداة.
  3. تحقّق من أذونات القناة وحالة بيئة العزل والوصول بصلاحيات مرتفعة باستخدام بيئة العزل مقابل سياسة الأدوات مقابل الصلاحيات المرتفعة والتنفيذ بصلاحيات مرتفعة.
  4. تحقّق مما إذا كان Plugin المالك مثبّتًا ومفعّلًا في Plugins.
  5. بالنسبة إلى عمليات التشغيل المفوّضة، تحقّق من القيود الخاصة بكل وكيل في قيود بيئة العزل والأدوات لكل وكيل.
  6. بالنسبة إلى فهارس OpenClaw الكبيرة، تأكّد مما إذا كان التشغيل يستخدم عرض الأدوات مباشرةً أو البحث عن الأدوات.

ذو صلة