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

​
ابدأ من هنا

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

​
اختر الأدوات أو 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 SDK

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

يسرد الجدول أدوات تمثيلية حتى تتمكن من التعرف على السطح. وهو ليس مرجع السياسة الكامل. للمجموعات الدقيقة، والإعدادات الافتراضية، ودلالات السماح/المنع، استخدم الأدوات والمزوّدون المخصصون.
الفئةاستخدمها عندما يحتاج الوكيل إلى…أدوات تمثيليةاقرأ بعد ذلك
وقت التشغيلتشغيل الأوامر، أو إدارة العمليات، أو استخدام تحليل Python مدعوم من مزوّدexec, process, code_executionExec، تنفيذ الشيفرة
الملفاتقراءة ملفات مساحة العمل وتغييرها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بحث الأدوات
بحث الأدوات هو سطح وكيل OpenClaw تجريبي. تستخدم تشغيلات حزمة Codex وضع الشيفرة الأصلي في Codex، وبحث الأدوات الأصلي، والأدوات الديناميكية المؤجلة، واستدعاءات الأدوات المتداخلة بدلًا من tools.toolSearch.

​
الأدوات المقدمة من Plugins

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

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

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

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

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

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

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

​
ذات صلة