مهارات Clawdbot

قم بتوسيع مساعد Clawdbot AI بالمهارات. تعلم كيفية إنشاء وتثبيت وإدارة المهارات لمساعدك الشخصي بالذكاء الاصطناعي.

نظرة عامة على مهارات Clawdbot

يستخدم Clawdbot مجلدات المهارات المتوافقة مع AgentSkills لتعليم الوكيل كيفية استخدام الأدوات. كل مهارة هي دليل يحتوي على SKILL.md مع بيانات YAML الأمامية والتعليمات.

يقوم Clawdbot بتحميل المهارات المدمجة بالإضافة إلى التجاوزات المحلية الاختيارية، ويقوم بتصفيتها في وقت التحميل بناءً على البيئة والتكوين ووجود الملفات الثنائية.

مواقع المهارات والأولوية

يتم تحميل المهارات من ثلاثة أماكن:

الموقعالوصف
المهارات المدمجةتأتي مع التثبيت (حزمة npm أو Clawdbot.app)
المهارات المُدارة/المحلية~/.clawdbot/skills
مهارات مساحة العمل<workspace>/skills

الأولوية (من الأعلى إلى الأدنى):

  1. <workspace>/skills
  2. ~/.clawdbot/skills
  3. المهارات المدمجة

يمكنك تكوين مجلدات مهارات إضافية عبر 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-invocabletrue|false (الافتراضي: true) - عرض كأمر شرطة مائلة للمستخدم
disable-model-invocationtrue|false (الافتراضي: false) - استبعاد من موجه النموذج
command-dispatchtool - تجاوز النموذج والإرسال مباشرة إلى أداة
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 أدلة المهارات بحثًا عن التغييرات ويقوم بالتحديث التلقائي عند إضافة المهارات أو تعديلها أو إزالتها.

الخطوات التالية