Overview

نظرة عامة

استخدم هذه الصفحة لاختيار سطح Capabilities المناسب. Tools هي إجراءات قابلة للاستدعاء، وSkills تعلّم الوكلاء كيفية العمل، وplugins تضيف قدرات وقت التشغيل مثل الأدوات، والمزوّدين، والقنوات، والخطافات، وSkills المعبّأة.

هذه صفحة نظرة عامة وتوجيه. للحصول على سياسة الأدوات الكاملة، والقيم الافتراضية، وعضوية المجموعات، وقيود المزوّدين، وحقول الإعداد، استخدم الأدوات والمزوّدون المخصصون.

ابدأ هنا

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

إذا كنت تحتاج إلى...	استخدم هذا أولاً	ثم اقرأ
السماح لوكيل بالتصرف باستخدام القدرات الحالية	الأدوات المدمجة	فئات الأدوات
التحكم فيما يمكن للوكيل استدعاؤه	سياسة الأدوات	الأدوات والمزوّدون المخصصون
تعليم وكيل سير عمل	Skills	Skills وإنشاء Skills
إضافة تكامل جديد أو سطح وقت تشغيل	Plugins	Plugins وبناء plugins
تشغيل العمل لاحقاً أو في الخلفية	الأتمتة	نظرة عامة على الأتمتة
تنسيق عدة وكلاء أو مسخّرات	الوكلاء الفرعيون	وكلاء ACP وإرسال الوكيل
البحث في كتالوج أدوات PI كبير	Tool Search	Tool Search

اختر الأدوات، أو Skills، أو plugins

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

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

لا يرى النموذج إلا الأدوات التي تتجاوز الملف التعريفي النشط، وسياسة السماح/الرفض، وقيود المزوّد، وحالة صندوق الرمل، وأذونات القناة، وتوافر plugin.

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

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

يمكن أن تكون Skills في مساحة عمل، أو دليل Skills مشترك، أو جذر Skills مُدار من OpenClaw، أو حزمة plugin.

Skills | إنشاء Skills | إعدادات Skills

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

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

تثبيت plugins وتهيئتها | بناء plugins | Plugin SDK

فئات الأدوات المدمجة

يعرض الجدول أدوات تمثيلية حتى تتمكن من التعرّف إلى السطح. وهو ليس مرجع السياسة الكامل. للمجموعات الدقيقة، والقيم الافتراضية، ودلالات السماح/الرفض، استخدم الأدوات والمزوّدون المخصصون.

الفئة	استخدمها عندما يحتاج الوكيل إلى...	أدوات تمثيلية	اقرأ التالي
وقت التشغيل	تشغيل أوامر، أو إدارة عمليات، أو استخدام تحليل Python مدعوم من مزوّد	`exec`, `process`, `code_execution`	Exec, تنفيذ الكود
الملفات	قراءة ملفات مساحة العمل وتغييرها	`read`, `write`, `edit`, `apply_patch`	Apply patch
الويب	البحث في الويب، أو البحث في منشورات X، أو جلب محتوى صفحة قابل للقراءة	`web_search`, `x_search`, `web_fetch`	أدوات الويب, جلب الويب
المتصفح	تشغيل جلسة متصفح	`browser`	المتصفح
المراسلة والقنوات	إرسال ردود أو إجراءات قناة	`message`	إرسال الوكيل
الجلسات والوكلاء	فحص الجلسات، أو تفويض العمل، أو توجيه تشغيل آخر، أو الإبلاغ عن الحالة	`sessions_*`, `subagents`, `agents_list`, `session_status`	الوكلاء الفرعيون, أداة الجلسة
الأتمتة	جدولة العمل أو الاستجابة لأحداث الخلفية	`cron`, `heartbeat_respond`	الأتمتة
Gateway والعُقد	فحص حالة Gateway أو الأجهزة المستهدفة المقترنة	`gateway`, `nodes`	تكوين Gateway, العُقد
الوسائط	تحليل الوسائط أو توليدها أو نطقها	`image`, `image_generate`, `music_generate`, `video_generate`, `tts`	نظرة عامة على الوسائط
كتالوجات PI الكبيرة	البحث واستدعاء كثير من الأدوات المؤهلة دون إرسال كل مخطط إلى النموذج	`tool_search_code`, `tool_search`, `tool_describe`	Tool Search

الأدوات التي توفرها plugins

يمكن لـ plugins تسجيل أدوات إضافية. يربط مؤلفو Plugin الأدوات عبر api.registerTool(...) وcontracts.tools في البيان؛ استخدم Plugin SDK وبيان Plugin لتفاصيل العقد.

تشمل الأدوات الشائعة التي توفرها plugins:

الفروقات لعرض فروقات الملفات وMarkdown
مهمة LLM لخطوات سير العمل الخاصة بـ JSON فقط
Lobster لسير عمل ذي أنواع مع موافقات قابلة للاستئناف
Tokenjuice لضغط مخرجات أدوات exec وbash المليئة بالضجيج
Tool Search لاكتشاف كتالوجات أدوات كبيرة واستدعائها دون وضع كل مخطط في المطالبة
Canvas للتحكم في Canvas الخاص بالعُقد وعرض A2UI

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

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

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

توسيع القدرات

اختر مسار التوسيع حسب المهمة التي تحتاج إلى أن ينفذها OpenClaw:

ثبّت Plugin حالياً أو أدِره باستخدام Plugins.
ابنِ تكاملاً جديداً، أو مزوّداً، أو قناة، أو أداة، أو خطافاً باستخدام بناء plugins.
أضف تعليمات وكيل قابلة لإعادة الاستخدام أو اضبطها باستخدام Skills و إنشاء Skills.
غلّف مواد سير عمل قابلة لإعادة الاستخدام باستخدام ورشة Skills عندما ينتمي سير العمل إلى حزمة Skills موزعة عبر plugin.
استخدم Plugin SDK وبيان Plugin عندما تحتاج إلى عقود تنفيذ.

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

إذا لم يستطع النموذج رؤية أداة أو استدعاءها، فابدأ بالسياسة الفعالة للدورة الحالية:

تحقق من الملف التعريفي النشط، وtools.allow، وtools.deny في الأدوات والمزوّدون المخصصون.
تحقق من القيود الخاصة بالمزوّدين في الأدوات والمزوّدون المخصصون وتأكّد من أن مزوّد النموذج المحدد يدعم شكل الأداة.
تحقق من أذونات القناة، وحالة صندوق الرمل، والوصول المرتفع باستخدام صندوق الرمل مقابل سياسة الأدوات مقابل الرفع وExec المرتفع.
تحقق مما إذا كان plugin المالك مثبتاً ومفعلاً في Plugins.
بالنسبة للتشغيلات المفوضة، تحقق من القيود لكل وكيل في قيود صندوق الرمل والأدوات لكل وكيل.
بالنسبة إلى كتالوجات PI الكبيرة، تأكّد مما إذا كان التشغيل يستخدم تعريض الأدوات مباشرة أو Tool Search.

ذو صلة

الأتمتة من أجل cron، والمهام، وHeartbeat، والالتزامات، والخطافات، والأوامر الدائمة، وTask Flow
الوكلاء من أجل نموذج الوكيل، والجلسات، والذاكرة، وتنسيق الوكلاء المتعددين
الأدوات والمزوّدون المخصصون لمرجع سياسة الأدوات المعتمد
Plugins لتثبيت plugins وإدارتها
Plugin SDK لمرجع مؤلفي plugins
Skills لترتيب تحميل Skills، والحجب، والإعداد
Tool Search لاكتشاف كتالوج أدوات PI بشكل مضغوط

Was this useful?