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

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

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

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

1

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

تعيش 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!".
استخدم hyphen-case بأحرف صغيرة وأرقام وواصلات لاسم المهارة name. أبقِ اسم المجلد وname في frontmatter متطابقين.
3

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

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

حمّل المهارة

ابدأ جلسة جديدة لكي يلتقط OpenClaw المهارة:
# From chat
/new

# Or restart the gateway
openclaw gateway restart
تحقّق من تحميل المهارة:
openclaw skills list
5

اختبرها

أرسل رسالة ينبغي أن تشغّل المهارة:
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الأدنىمجلدات مشتركة مخصصة

ذات صلة