Skills
إنشاء Skills
Skills تعلّم الوكيل كيف ومتى يستخدم الأدوات. كل مهارة هي دليل
يحتوي على ملف SKILL.md يتضمن frontmatter بصيغة YAML وتعليمات markdown.
للتعرّف على كيفية تحميل Skills وترتيب أولويتها، راجع Skills.
أنشئ أول مهارة لك
أنشئ دليل المهارة
تعيش Skills في مساحة عملك. أنشئ مجلدًا جديدًا:
mkdir -p ~/.openclaw/workspace/skills/hello-worldاكتب SKILL.md
أنشئ SKILL.md داخل ذلك الدليل. يعرّف frontmatter البيانات الوصفية،
ويحتوي متن 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 المهارة:
# From chat/new # Or restart the gatewayopenclaw gateway restartتحقّق من تحميل المهارة:
openclaw skills listاختبرها
أرسل رسالة ينبغي أن تشغّل المهارة:
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 |
الأدنى | مجلدات مشتركة مخصصة |
ذات صلة
- مرجع Skills — قواعد التحميل والأسبقية والحجب
- إعدادات Skills — مخطط إعدادات
skills.* - ClawHub — سجل المهارات العام
- بناء الإضافات — يمكن للإضافات شحن Skills