Overview
نظرة عامة
استخدم هذه الصفحة لاختيار واجهة الإمكانات المناسبة. الأدوات هي إجراءات قابلة للاستدعاء، وتعلّم Skills الوكلاء كيفية العمل، بينما تضيف Plugins إمكانات وقت التشغيل مثل الأدوات والموفّرين والقنوات والخطافات وحزم Skills.
هذه صفحة نظرة عامة وتوجيه. للاطلاع على سياسة الأدوات والإعدادات الافتراضية وعضوية المجموعات وقيود الموفّرين وحقول التكوين بصورة شاملة، استخدم الأدوات والموفّرين المخصصين.
ابدأ من هنا
بالنسبة إلى معظم الوكلاء، ابدأ بفئات الأدوات المضمّنة، ثم عدّل السياسة فقط عندما ينبغي أن يرى الوكيل أدوات أقل أو يحتاج إلى وصول صريح إلى المضيف.
| إذا كنت بحاجة إلى... | استخدم هذا أولًا | ثم اقرأ |
|---|---|---|
| تمكين وكيل من العمل باستخدام الإمكانات الموجودة | الأدوات المضمّنة | فئات الأدوات |
| التحكم فيما يمكن للوكيل استدعاؤه | سياسة الأدوات | الأدوات والموفّرون المخصصون |
| تعليم وكيل سير عمل | Skills | Skills، وإنشاء Skills، وورشة Skills |
| إضافة تكامل جديد أو واجهة وقت تشغيل | Plugins | Plugins وبناء Plugins |
| تشغيل العمل لاحقًا أو في الخلفية | الأتمتة | نظرة عامة على الأتمتة |
| تنسيق عدة وكلاء أو بيئات تشغيل | الوكلاء الفرعيون | وكلاء ACP وإرسال الوكيل |
| البحث في فهرس كبير لأدوات OpenClaw | البحث عن الأدوات | البحث عن الأدوات |
اختر الأدوات أو Skills أو Plugins
استخدم أداة عندما يحتاج الوكيل إلى تنفيذ إجراء
الأداة هي دالة محددة الأنواع يمكن للوكيل استدعاؤها، مثل exec أو browser
أو web_search أو message أو image_generate. استخدم الأدوات عندما يحتاج الوكيل
إلى قراءة البيانات أو تغيير الملفات أو إرسال الرسائل أو استدعاء موفّر أو
تشغيل نظام آخر. تُرسل الأدوات المرئية إلى النموذج على هيئة
تعريفات دوال منظّمة.
لا يرى النموذج إلا الأدوات التي تجتاز ملف التعريف النشط وسياسة السماح/المنع وقيود الموفّر وحالة بيئة العزل وأذونات القناة وتوفّر Plugin.
استخدم Skill عندما يحتاج الوكيل إلى تعليمات
Skill هي حزمة تعليمات SKILL.md تُحمّل في مطالبة الوكيل. استخدم
Skill عندما يمتلك الوكيل الأدوات التي يحتاج إليها بالفعل، لكنه يحتاج إلى
سير عمل قابل للتكرار أو معايير مراجعة أو تسلسل أوامر أو قيد
تشغيلي.
يمكن أن توجد Skills في مساحة عمل أو دليل Skills مشترك أو جذر Skills مُدار من OpenClaw أو حزمة Plugin.
استخدم Plugin عندما يحتاج OpenClaw إلى إمكانية جديدة
يمكن أن يضيف Plugin أدوات وSkills وقنوات وموفّري نماذج وتحويل النص إلى كلام وصوتًا آنيًا وإنشاء الوسائط والبحث في الويب وجلب محتوى الويب والخطافات وإمكانات أخرى لوقت التشغيل. استخدم Plugin عندما تتضمن الإمكانية شيفرة أو بيانات اعتماد أو خطافات دورة حياة أو بيانات وصفية لبيان أو حزمة قابلة للتثبيت. يمكن تثبيت Plugins الموجودة من ClawHub أو npm أو git أو الأدلة المحلية أو الأرشيفات.
فئات الأدوات المضمّنة
يسرد الجدول أدوات تمثيلية لمساعدتك على التعرّف على الواجهة. وهو ليس مرجع السياسة الكامل. لمعرفة المجموعات الدقيقة والإعدادات الافتراضية ودلالات السماح/المنع، استخدم الأدوات والموفّرين المخصصين.
| الفئة | تُستخدم عندما يحتاج الوكيل إلى... | أدوات تمثيلية | اقرأ بعد ذلك |
|---|---|---|---|
| وقت التشغيل | تشغيل الأوامر أو إدارة العمليات أو استخدام تحليل Python المدعوم من موفّر | exec, process, code_execution |
التنفيذ، تنفيذ الشيفرة |
| الملفات | قراءة ملفات مساحة العمل وتغييرها | read, write, edit, apply_patch |
تطبيق رقعة |
| الويب | البحث في الويب أو البحث في منشورات X أو جلب محتوى صفحات قابل للقراءة | web_search, x_search, web_fetch |
أدوات الويب، جلب محتوى الويب |
| المتصفح | تشغيل جلسة متصفح | browser |
المتصفح |
| المراسلة والقنوات | إرسال ردود أو إجراءات إلى القنوات | message |
إرسال الوكيل |
| الجلسات والوكلاء | فحص الجلسات أو تفويض العمل أو توجيه تشغيل آخر أو الإبلاغ عن الحالة | sessions_*, subagents, agents_list, session_status, get_goal, create_goal, update_goal |
الهدف، الوكلاء الفرعيون، أداة الجلسة |
| الأتمتة | جدولة العمل أو الاستجابة لأحداث الخلفية | cron, heartbeat_respond |
الأتمتة |
| Gateway والعُقد | فحص حالة Gateway أو الأجهزة الهدف المقترنة | gateway, nodes |
تكوين Gateway، العُقد |
| الوسائط | تحليل الوسائط أو إنشاؤها أو نطقها | image, image_generate, music_generate, video_generate, tts |
نظرة عامة على الوسائط |
| فهارس OpenClaw الكبيرة | البحث عن عدد كبير من الأدوات المؤهلة واستدعاؤها دون إرسال كل مخطط إلى النموذج | tool_search_code, tool_search, tool_describe |
البحث عن الأدوات |
الأدوات التي توفّرها 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 عندما تحتاج إلى عقود التنفيذ.
استكشاف أخطاء الأدوات المفقودة وإصلاحها
إذا تعذّر على النموذج رؤية أداة أو استدعاؤها، فابدأ بالسياسة الفعلية للدورة الحالية:
- تحقّق من ملف التعريف النشط و
tools.allowوtools.denyفي الأدوات والموفّرين المخصصين. - تحقّق من القيود الخاصة بالموفّر في الأدوات والموفّرين المخصصين، وتأكّد من أن موفّر النموذج المحدد يدعم بنية الأداة.
- تحقّق من أذونات القناة وحالة بيئة العزل والوصول بصلاحيات مرتفعة باستخدام بيئة العزل مقابل سياسة الأدوات مقابل الصلاحيات المرتفعة والتنفيذ بصلاحيات مرتفعة.
- تحقّق مما إذا كان Plugin المالك مثبّتًا ومفعّلًا في Plugins.
- بالنسبة إلى عمليات التشغيل المفوّضة، تحقّق من القيود الخاصة بكل وكيل في قيود بيئة العزل والأدوات لكل وكيل.
- بالنسبة إلى فهارس OpenClaw الكبيرة، تأكّد مما إذا كان التشغيل يستخدم عرض الأدوات مباشرةً أو البحث عن الأدوات.
ذو صلة
- الأتمتة لـ Cron والمهام وHeartbeat والالتزامات والخطافات والأوامر الدائمة وTaskFlow
- الوكلاء لنموذج الوكيل والجلسات والذاكرة والتنسيق متعدد الوكلاء
- الأدوات والموفّرون المخصصون للمرجع المعتمد لسياسة الأدوات
- Plugins لتثبيت Plugins وإدارتها
- حزمة تطوير Plugin لمرجع مؤلفي Plugins
- Skills لترتيب تحميل Skills والبوابات والتهيئة
- ورشة Skills لإنشاء Skills المُولَّدة والمُراجَعة
- البحث عن الأدوات لاكتشاف دليل أدوات OpenClaw الموجز