استخدم هذه الصفحة لاختيار سطح Capabilities المناسب. Tools هي إجراءات قابلة للاستدعاء، وSkills تعلّم الوكلاء كيفية العمل، وplugins تضيف قدرات وقت التشغيل مثل الأدوات، والمزوّدين، والقنوات، والخطافات، وSkills المعبّأة. هذه صفحة نظرة عامة وتوجيه. للحصول على سياسة الأدوات الكاملة، والقيم الافتراضية، وعضوية المجموعات، وقيود المزوّدين، وحقول الإعداد، استخدم الأدوات والمزوّدون المخصصون.Documentation Index
Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt
Use this file to discover all available pages before exploring further.
ابدأ هنا
بالنسبة لمعظم الوكلاء، ابدأ بفئات الأدوات المدمجة، ثم عدّل السياسة فقط عندما يجب أن يرى الوكيل أدوات أقل أو يحتاج إلى وصول صريح إلى المضيف.| إذا كنت تحتاج إلى… | استخدم هذا أولاً | ثم اقرأ |
|---|---|---|
| السماح لوكيل بالتصرف باستخدام القدرات الحالية | الأدوات المدمجة | فئات الأدوات |
| التحكم فيما يمكن للوكيل استدعاؤه | سياسة الأدوات | الأدوات والمزوّدون المخصصون |
| تعليم وكيل سير عمل | 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 |
Tool Search هو سطح تجريبي لوكيل PI. تستخدم تشغيلات مسخّر Codex
وضع الكود الأصلي في Codex، والبحث الأصلي عن الأدوات، والأدوات الديناميكية المؤجلة،
واستدعاءات الأدوات المتداخلة بدلاً من
tools.toolSearch.الأدوات التي توفرها 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 بشكل مضغوط