الانتقال إلى المحتوى الرئيسي

​
إنشاء Skills

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

​
أنشئ أول Skill لك

1

أنشئ دليل Skill

توجد Skills في مساحة العمل الخاصة بك. أنشئ مجلدًا جديدًا:
mkdir -p ~/.openclaw/workspace/skills/hello-world
2

اكتب SKILL.md

أنشئ SKILL.md داخل ذلك الدليل. يحدد frontmatter البيانات الوصفية، بينما يحتوي متن 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!".
3

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

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

حمّل Skill

ابدأ جلسة جديدة حتى يلتقط OpenClaw الـ Skill:
# From chat
/new

# Or restart the gateway
openclaw gateway restart
تحقّق من تحميل الـ Skill:
openclaw skills list
5

اختبرها

أرسل رسالة يفترض أن تؤدي إلى تشغيل الـ Skill:
openclaw agent --message "give me a greeting"
أو ببساطة تحدث مع العامل واطلب تحية.

​
مرجع البيانات الوصفية لـ Skill

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

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

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

​
أماكن وجود Skills

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

​
ذو صلة