الانتقال إلى المحتوى الرئيسي
تعلّم Skills الوكيل كيف ومتى يستخدم الأدوات. كل skill هو دليل يحتوي على ملف SKILL.md يتضمن YAML frontmatter وتعليمات markdown. يحمّل OpenClaw المهارات من عدة جذور وفق ترتيب أسبقية محدد.

​
أنشئ أول skill لك

1

أنشئ دليل skill

توجد Skills في مجلد skills/ داخل مساحة عملك. أنشئ دليلاً للـ skill الجديدة:
mkdir -p ~/.openclaw/workspace/skills/hello-world
يمكنك تجميع skills في مجلدات فرعية للتنظيم — ستظل الـ skill مسماة بحسب frontmatter في SKILL.md، وليس مسار المجلد:
mkdir -p ~/.openclaw/workspace/skills/personal/hello-world
# skill name is still "hello-world", invoked as /hello-world
2

اكتب SKILL.md

أنشئ SKILL.md داخل الدليل. يعرّف frontmatter البيانات الوصفية؛ ويعطي المتن التعليمات للوكيل.
---
name: hello-world
description: A simple skill that prints a greeting.
---

# Hello World

When the user asks for a greeting, use the `exec` tool to run:

```bash
echo "Hello from your custom skill!"


قواعد التسمية:
- استخدم أحرفًا صغيرة وأرقامًا وواصلات في `name`.
- أبقِ اسم الدليل وقيمة `name` في frontmatter متطابقين.
- يظهر `description` للوكيل وفي اكتشاف أوامر الشرطة المائلة —
  اجعله في سطر واحد وبأقل من 160 حرفًا.

</Step>

<Step title="تحقق من تحميل skill">
```bash
openclaw skills list
يراقب OpenClaw ملفات SKILL.md ضمن جذور skills افتراضيًا. إذا كان المراقب معطلاً أو كنت تتابع جلسة موجودة، فابدأ جلسة جديدة حتى يتلقى الوكيل القائمة المحدّثة:
# From chat — archive current session and start fresh
/new

# Or restart the gateway
openclaw gateway restart
3

اختبرها

أرسل رسالة يفترض أن تشغّل الـ skill:
openclaw agent --message "give me a greeting"
أو افتح محادثة واسأل الوكيل مباشرة. استخدم /skill hello-world لاستدعائها صراحةً بالاسم.

​
مرجع SKILL.md

​
الحقول المطلوبة

الحقلالوصف
nameمعرّف فريد يستخدم أحرفًا صغيرة وأرقامًا وواصلات
descriptionوصف من سطر واحد يظهر للوكيل وفي مخرجات الاكتشاف

​
مفاتيح frontmatter الاختيارية

الحقلالافتراضيالوصف
user-invocabletrueإظهار الـ skill كأمر شرطة مائلة للمستخدم
disable-model-invocationfalseإبقاء الـ skill خارج موجّه نظام الوكيل (وتظل تعمل عبر /skill)
command-dispatch—اضبطها على tool لتوجيه أمر الشرطة المائلة مباشرة إلى أداة، متجاوزًا النموذج
command-tool—اسم الأداة المراد استدعاؤها عند ضبط command-dispatch: tool
command-arg-moderawفي توجيه الأدوات، يمرّر سلسلة الوسيطات الخام إلى الأداة
homepage—عنوان URL يظهر باسم “موقع الويب” في واجهة Skills على macOS
لحقول التقييد (requires.bins وrequires.env وغيرها) راجع Skills — التقييد.

​
استخدام {baseDir}

استخدم {baseDir} في متن الـ skill للإشارة إلى ملفات داخل دليل الـ skill دون ترميز المسارات بشكل ثابت: 
Run the helper script at `{baseDir}/scripts/run.sh`.

​
إضافة تفعيل شرطي

قيّد الـ skill بحيث لا تُحمّل إلا عند توفر اعتمادياتها: 
---
name: gemini-search
description: Search using Gemini CLI.
metadata: { "openclaw": { "requires": { "bins": ["gemini"] }, "primaryEnv": "GEMINI_API_KEY" } }
---
المفتاحالوصف
requires.binsيجب أن توجد كل الملفات التنفيذية على PATH
requires.anyBinsيجب أن يوجد ملف تنفيذي واحد على الأقل على PATH
requires.envيجب أن يوجد كل متغير env في العملية أو الإعدادات
requires.configيجب أن يكون كل مسار openclaw.json ذا قيمة صادقة
osمرشح المنصة: ["darwin"]، ["linux"]، ["win32"]
alwaysاضبطها على true لتجاوز كل القيود وتضمين الـ skill دائمًا
المرجع الكامل: Skills — التقييد.
اربط مفتاح API بإدخال skill في openclaw.json:
{
  skills: {
    entries: {
      "gemini-search": {
        enabled: true,
        apiKey: { source: "env", provider: "default", id: "GEMINI_API_KEY" },
      },
    },
  },
}
يُحقن المفتاح في عملية المضيف لدورة الوكيل تلك فقط. ولا يصل إلى sandbox — راجع متغيرات env في sandbox.

​
الاقتراح عبر Skill Workshop

بالنسبة إلى skills التي يصوغها الوكيل أو عندما تريد مراجعة المشغّل قبل أن تصبح skill نشطة، استخدم مقترحات Skill Workshop بدلاً من كتابة SKILL.md مباشرة. 
# Propose a brand-new skill
openclaw skills workshop propose-create \
  --name "hello-world" \
  --description "A simple skill that prints a greeting." \
  --proposal ./PROPOSAL.md

# Propose an update to an existing skill
openclaw skills workshop propose-update hello-world \
  --proposal ./PROPOSAL.md \
  --description "Updated greeting skill"
استخدم --proposal-dir عندما يتضمن المقترح ملفات دعم: 
openclaw skills workshop propose-create \
  --name "hello-world" \
  --description "A simple skill that prints a greeting." \
  --proposal-dir ./hello-world-proposal/
يجب أن يحتوي الدليل على PROPOSAL.md. يمكن وضع ملفات الدعم في assets/، أو examples/، أو references/، أو scripts/، أو templates/. بعد المراجعة: 
openclaw skills workshop inspect <proposal-id>
openclaw skills workshop apply <proposal-id>
راجع Skill Workshop لدورة حياة المقترح الكاملة.

​
النشر إلى ClawHub

1

تأكد من اكتمال SKILL.md

تأكد من ضبط name وdescription وأي حقول تقييد ضمن metadata.openclaw. أضف عنوان URL في homepage إذا كانت لديك صفحة مشروع.
2

ثبّت skill الخاصة بـ ClawHub

توثّق skill الخاصة بـ ClawHub شكل أمر النشر الحالي والبيانات الوصفية المطلوبة:
openclaw skills install @openclaw/clawhub-publish
3

انشر

clawhub publish
راجع ClawHub — النشر للاطلاع على التدفق الكامل.

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

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

​
ذو صلة

مرجع Skills

ترتيب التحميل، والتقييد، وقوائم السماح، وتنسيق SKILL.md.

Skill Workshop

طابور مقترحات skills التي يصوغها الوكيل.

إعدادات Skills

مخطط إعدادات skills.* الكامل.

ClawHub

تصفح skills وانشرها في السجل العام.

بناء plugins

يمكن أن تشحن plugins مهارات إلى جانب الأدوات التي توثقها.