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.

Skills | ورشة 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`	تطبيق التصحيح
الويب	البحث في الويب، أو البحث في منشورات X، أو جلب محتوى صفحة قابل للقراءة	`web_search`, `x_search`, `web_fetch`	أدوات الويب، جلب الويب
المتصفح	تشغيل جلسة متصفح	`browser`	المتصفح
المراسلة والقنوات	إرسال ردود أو إجراءات قناة	`message`	إرسال الوكيل
الجلسات والوكلاء	فحص الجلسات، أو تفويض العمل، أو توجيه تشغيل آخر، أو الإبلاغ عن الحالة	`sessions_*`, `subagents`, `agents_list`, `session_status`, `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 SDK وبيان Plugin لتفاصيل العقد.

تشمل الأدوات الشائعة المقدمة من Plugins ما يلي:

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

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

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

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

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

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

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

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

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

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