مهارات Clawdbot
قم بتوسيع مساعد Clawdbot AI بالمهارات. تعلم كيفية إنشاء وتثبيت وإدارة المهارات لمساعدك الشخصي بالذكاء الاصطناعي.
نظرة عامة على مهارات Clawdbot
يستخدم Clawdbot مجلدات المهارات المتوافقة مع AgentSkills لتعليم الوكيل كيفية استخدام الأدوات. كل مهارة هي دليل يحتوي على SKILL.md مع بيانات YAML الأمامية والتعليمات.
يقوم Clawdbot بتحميل المهارات المدمجة بالإضافة إلى التجاوزات المحلية الاختيارية، ويقوم بتصفيتها في وقت التحميل بناءً على البيئة والتكوين ووجود الملفات الثنائية.
مواقع المهارات والأولوية
يتم تحميل المهارات من ثلاثة أماكن:
| الموقع | الوصف |
|---|---|
| المهارات المدمجة | تأتي مع التثبيت (حزمة npm أو Clawdbot.app) |
| المهارات المُدارة/المحلية | ~/.clawdbot/skills |
| مهارات مساحة العمل | <workspace>/skills |
الأولوية (من الأعلى إلى الأدنى):
<workspace>/skills~/.clawdbot/skills- المهارات المدمجة
يمكنك تكوين مجلدات مهارات إضافية عبر skills.load.extraDirs في ~/.clawdbot/clawdbot.json.
المهارات الخاصة بالوكيل مقابل المشتركة
في إعدادات الوكلاء المتعددين:
- المهارات الخاصة بالوكيل: موجودة في
<workspace>/skillsلذلك الوكيل فقط - المهارات المشتركة: موجودة في
~/.clawdbot/skillsومرئية لجميع الوكلاء
ClawHub (التثبيت + المزامنة)
ClawHub هو سجل المهارات العام لـ Clawdbot. تصفح على https://clawhub.com.
التدفقات الشائعة:
# تثبيت مهارة في مساحة العمل الخاصة بك
clawhub install <skill-slug>
# تحديث جميع المهارات المثبتة
clawhub update --all
# المزامنة (المسح + نشر التحديثات)
clawhub sync --allبشكل افتراضي، يقوم clawhub بالتثبيت في ./skills تحت دليل العمل الحالي.
تنسيق المهارة
يجب أن يتضمن SKILL.md على الأقل:
---
name: my-skill
description: What this skill does
---
Instructions for the agent...مفاتيح البيانات الأمامية الاختيارية
| المفتاح | الوصف |
|---|---|
homepage | عنوان URL يظهر كـ "موقع الويب" في واجهة المهارات |
user-invocable | true|false (الافتراضي: true) - عرض كأمر شرطة مائلة للمستخدم |
disable-model-invocation | true|false (الافتراضي: false) - استبعاد من موجه النموذج |
command-dispatch | tool - تجاوز النموذج والإرسال مباشرة إلى أداة |
command-tool | اسم الأداة للاستدعاء عندما يكون command-dispatch: tool |
البوابة (مرشحات وقت التحميل)
تصفية المهارات في وقت التحميل باستخدام البيانات الوصفية:
---
name: my-skill
description: My skill description
metadata: {"openclaw": {"requires": {"bins": ["uv"], "env": ["API_KEY"], "config": ["browser.enabled"]}}}
---حقول البوابة
| الحقل | الوصف |
|---|---|
always: true | تضمين المهارة دائمًا |
requires.bins | الملفات الثنائية المطلوبة |
requires.env | متغيرات البيئة المطلوبة |
requires.config | مفاتيح التكوين المطلوبة |
primaryEnv | متغير البيئة الرئيسي للمهارة |
تجاوزات التكوين
تجاوز إعدادات المهارة في ~/.clawdbot/clawdbot.json:
{
"skills": {
"entries": {
"my-skill": {
"enabled": true,
"env": {
"API_KEY": "your-key"
}
}
}
}
}ملاحظات الأمان
- تعامل مع مهارات الطرف الثالث كرمز غير موثوق
- اقرأ المهارات قبل تمكينها
- فضّل التشغيل في بيئة معزولة للمدخلات غير الموثوقة
- احتفظ بالأسرار بعيدًا عن المطالبات والسجلات
الإضافات + المهارات
يمكن للإضافات شحن مهاراتها الخاصة عن طريق إدراج أدلة المهارات في clawdbot.plugin.json. يتم تحميل مهارات الإضافة عند تمكين الإضافة.
مراقب المهارات (التحديث التلقائي)
يراقب Clawdbot أدلة المهارات بحثًا عن التغييرات ويقوم بالتحديث التلقائي عند إضافة المهارات أو تعديلها أو إزالتها.
الخطوات التالية
- أوامر Clawdbot المائلة - مرجع الأوامر
- أدوات Clawdbot - تكوين الأدوات
- بوابة Clawdbot - تكوين البوابة