English简体中文繁體中文日本語EspañolPortuguês (BR)한국어DeutschFrançaisالعربيةItalianoTiếng ViệtNederlandsTürkçeУкраїнськаBahasa IndonesiaPolskiفارسیไทย

Skills

إنشاء Skills

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

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

أنشئ أول skill لك

  • أنشئ دليل skill

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

    mkdir -p ~/.openclaw/workspace/skills/hello-world

  • اكتب SKILL.md

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

    ---
name: hello-world
description: 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 بأحرف صغيرة وأرقام وواصلات لاسم skill name. اجعل اسم المجلد وname في البيانات التمهيدية متطابقين.

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

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

  • حمّل skill

    ابدأ جلسة جديدة حتى يلتقط OpenClaw skill:

    # From chat
/new

# Or restart the gateway
openclaw gateway restart

    تحقّق من تحميل skill:

    openclaw skills list

  • اختبره

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

    openclaw agent --message "give me a greeting"

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

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

    تدعم البيانات التمهيدية YAML هذه الحقول:

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

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

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

    أين توجد Skills

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

    ذو صلة