Skills

إنشاء Skills

Skills تعلّم الوكيل كيف ومتى يستخدم الأدوات. كل مهارة هي دليل يحتوي على ملف SKILL.md يتضمن frontmatter بصيغة YAML وتعليمات markdown.

للتعرّف على كيفية تحميل Skills وترتيب أولويتها، راجع Skills.

أنشئ أول مهارة لك

  • أنشئ دليل المهارة

    تعيش Skills في مساحة عملك. أنشئ مجلدًا جديدًا:

    bash
    mkdir -p ~/.openclaw/workspace/skills/hello-world
  • اكتب SKILL.md

    أنشئ SKILL.md داخل ذلك الدليل. يعرّف frontmatter البيانات الوصفية، ويحتوي متن markdown على تعليمات للوكيل.

    markdown
    ---name: hello-worlddescription: A simple skill that says hello.--- # Hello World Skill When the user asks for a greeting, use the `echo` tool to say"Hello from your custom skill!".

    استخدم hyphen-case بأحرف صغيرة وأرقام وواصلات لاسم المهارة name. أبقِ اسم المجلد وname في frontmatter متطابقين.

  • أضف أدوات (اختياري)

    يمكنك تعريف مخططات أدوات مخصصة في frontmatter أو إرشاد الوكيل إلى استخدام أدوات النظام الحالية (مثل exec أو browser). يمكن أيضًا أن تُشحن Skills داخل الإضافات إلى جانب الأدوات التي توثقها.

  • حمّل المهارة

    ابدأ جلسة جديدة لكي يلتقط OpenClaw المهارة:

    bash
    # From chat/new # Or restart the gatewayopenclaw gateway restart

    تحقّق من تحميل المهارة:

    bash
    openclaw skills list
  • اختبرها

    أرسل رسالة ينبغي أن تشغّل المهارة:

    bash
    openclaw agent --message "give me a greeting"

    أو تحدّث ببساطة مع الوكيل واطلب تحية.

  • مرجع بيانات المهارة الوصفية

    يدعم frontmatter بصيغة YAML هذه الحقول:

    الحقل مطلوب الوصف
    name نعم معرّف فريد يستخدم أحرفًا صغيرة وأرقامًا وواصلات
    description نعم وصف من سطر واحد يظهر للوكيل
    metadata.openclaw.os لا مرشح نظام التشغيل (["darwin"], ["linux"], إلخ)
    metadata.openclaw.requires.bins لا الثنائيات المطلوبة في PATH
    metadata.openclaw.requires.config لا مفاتيح الإعدادات المطلوبة

    أفضل الممارسات

    • كن موجزًا — أرشد النموذج إلى ما يجب فعله، لا إلى كيف يكون ذكاءً اصطناعيًا
    • السلامة أولًا — إذا كانت مهارتك تستخدم exec، فتأكد من أن المطالبات لا تسمح بحقن أوامر عشوائية من إدخال غير موثوق
    • اختبر محليًا — استخدم openclaw agent --message "..." للاختبار قبل المشاركة
    • استخدم ClawHub — تصفح Skills وساهم بها في ClawHub

    أين توجد Skills

    الموقع الأسبقية النطاق
    \<workspace\>/skills/ الأعلى لكل وكيل
    \<workspace\>/.agents/skills/ عالية لكل وكيل في مساحة العمل
    ~/.agents/skills/ متوسطة ملف تعريف وكيل مشترك
    ~/.openclaw/skills/ متوسطة مشتركة (كل الوكلاء)
    مضمّنة (مشحونة مع OpenClaw) منخفضة عام
    skills.load.extraDirs الأدنى مجلدات مشتركة مخصصة

    ذات صلة

    Was this useful?