الدرس 24 — دليل OpenClaw Skill Creator: كتابة مهارة عالية الجودة من الصفر ونشرها على ClawHub (2026)

الهدف: استخدام مهارة Skill Creator لإنشاء مهارة عالية الجودة من الصفر ونشرها على ClawHub لتكون متاحة للمستخدمين حول العالم.

ما هو Skill Creator؟

@chindden/skill-creator هو أداة تأليف المهارات على ClawHub (59 ألف تنزيل). هو نفسه مهارة، وبعد تثبيته يُوفّر سير عمل تفاعلي إرشادي يساعدك على إتمام:

• تحديد اسم المهارة ووصف وظيفتها والكلمات المفتاحية المُشغِّلة
• إنشاء ملف SKILL.md وفق المعيار
• إعداد أذونات استدعاء الأدوات (tool use)
• الاختبار والتصحيح
• التعبئة والنشر على ClawHub

كتابة مهارة OpenClaw لا تتطلب معرفة برمجية، Skill Creator يُحوّل وصفك بلغة طبيعية إلى صيغة مُقنّنة.

الخطوة الأولى: تثبيت Skill Creator

/install @chindden/skill-creator

للتحقق:

pnpm openclaw skills list
# يجب أن يظهر skill-creator في القائمة

الخطوة الثانية: بدء سير عمل التأليف

في WebChat أو Telegram أرسل:

/skill-creator

سيبدأ Skill Creator محادثة إرشادية يسألك فيها تسلسلياً:

1. ما المهمة التي تؤديها مهارتك؟ (صفها في جملة واحدة)
2. ما الكلمات المفتاحية التي سيستخدمها المستخدمون لتشغيلها؟ (مثل /weather، /طقس)
3. ما الأدوات التي تحتاج استدعاءها؟ (بحث، متصفح، قراءة/كتابة ملفات، طلبات HTTP...)
4. ما صيغة المخرجات؟ (نص عادي، Markdown، كتلة كود...)

أجب على الإرشادات وسيُنشئ Skill Creator مسودة SKILL.md كاملة في نهاية المحادثة.

الخطوة الثالثة: فهم معيار صيغة SKILL.md

الملف الأساسي في صيغة YAML للمهارة هو SKILL.md، هيكله كالتالي:

---
name: weather-daily
version: 1.0.0
description: تقرير الطقس اليومي، يجلب طقس المدينة المحددة لـ 3 أيام قادمة ويُنسّق المخرجات
triggers:
  - /weather
  - /طقس
  - ساعدني في الاطلاع على الطقس
tools:
  - web_search
  - http_request
outputs:
  - markdown
author: your-github-username
---
 
## تعليمات السلوك
 
عند تشغيل المستخدم لهذه المهارة:
1. استخرج اسم المدينة من مدخلات المستخدم، استخدم "الرياض" افتراضياً
2. استدع `web_search` للبحث عن "{المدينة} توقعات الطقس للأيام الثلاثة القادمة"
3. استخرج بيانات درجة الحرارة والطقس وسرعة الرياح
4. اعرض بتنسيق جدول Markdown يتضمن أعمدة: اليوم / الغد / بعد الغد
5. أضف أسفل الجدول نصيحة اختيار الملابس (لا تتجاوز جملتين)

لإضافة استدعاء أدوات في مهارة OpenClaw، ما عليك سوى إدراج اسم الأداة في حقل tools، وسيُحقن OpenClaw الإذن تلقائياً أثناء التشغيل.

الخطوة الرابعة: تطبيق عملي — كتابة مهارة "تقرير الطقس اليومي" خطوة بخطوة

بعد تشغيل Skill Creator، أجب على الأسئلة الإرشادية كالتالي:

وصف المهمة:
الاستعلام عن طقس أي مدينة للأيام الثلاثة القادمة، عرض درجات الحرارة والطقس
بجدول، مع نصيحة قصيرة لاختيار الملابس.

الكلمات المفتاحية المُشغِّلة:
/weather، /طقس، "ساعدني في الاطلاع على الطقس"، "ما طقس اليوم"

الأدوات المطلوبة:
web_search (استعلام بيانات الطقس)

صيغة المخرجات:
جدول Markdown + نصيحة نصية

بعد إنشاء المسودة من Skill Creator، أكّد المحتوى ونفّذ:

/skill-creator confirm

سيكتب Skill Creator ملف SKILL.md في المجلد المحلي ~/.openclaw/skills/weather-daily/.

الخطوة الخامسة: اختبار المهارة محلياً

بعد كتابة المهارة يمكن اختبارها فوراً:

/weather الرياض

إذا لم تكن المخرجات كما هو متوقع، أرسل أمر التعديل:

/skill-creator edit weather-daily
تعديل: أضف عموداً "احتمال الهطول" إلى الجدول، وغيّر نصيحة الملابس لتكون بالعربية والإنجليزية معاً

سيُحدّث Skill Creator ملف SKILL.md ويُعيد تحميله. الفرق الرئيسي بين تصحيح مهارة مخصصة ومهارة مدمجة في OpenClaw: المهارات المخصصة قابلة للتعديل في أي وقت، المهارات المدمجة تنتظر التحديث الرسمي.

الخطوة السادسة: النشر على ClawHub

خطوات النشر:

1. أنشئ مستودع GitHub، يُنصح بتسميته openclaw-skill-weather

2. أضف clawhub.yaml في جذر المستودع:

name: weather-daily
version: 1.0.0
description: تقرير الطقس اليومي، يدعم أي مدينة، مخرجات بالعربية والإنجليزية
author: your-github-username
homepage: https://github.com/your-github-username/openclaw-skill-weather
skill_file: SKILL.md
tags:
  - weather
  - productivity
  - arabic

3. انسخ SKILL.md إلى جذر المستودع، احفظ وادفع:

git add SKILL.md clawhub.yaml
git commit -m "feat: initial release v1.0.0"
git push origin main

4. قدّم طلب مراجعة على ClawHub:

/skill-creator publish your-github-username/openclaw-skill-weather

تستغرق عملية مراجعة نشر المهارة على ClawHub عادةً 24-72 ساعة، وتشمل: هل تُنفّذ المهارة عمليات ضارة، هل أذونات استدعاء الأدوات متناسبة مع الوظيفة، هل الوصف دقيق.

الخطوة السابعة: تحديثات الإصدار

عند تحديث المهارة، عدّل حقل version في clawhub.yaml وادفع الكود وأعد النشر:

# عدّل clawhub.yaml: version: 1.1.0
git add .
git commit -m "feat: add precipitation column"
git push origin main

سيتلقى المستخدمون الذين ثبّتوا المهارة إشعار التحديث عند إعادة تشغيل OpenClaw.

الأسئلة الشائعة

هل يتطلب كتابة مهارة OpenClaw معرفة برمجية؟

لا. جوهر المهارة هو تعليمات السلوك بلغة طبيعية في SKILL.md، ويرشدك Skill Creator لملء جميع الحقول بأسلوب حواري. استدعاء الأدوات (كالبحث وطلبات HTTP) يكفي إدراج اسم الأداة في قائمة tools دون كتابة أي كود. إذا احتجت منطقاً معقداً لمعالجة البيانات، صفه بلغة طبيعية في تعليمات السلوك وسيُفسّره OpenClaw وينفّذه تلقائياً.

ما متطلبات المراجعة للنشر على ClawHub؟

تتحقق المراجعة من ثلاثة أمور: أولاً، لا تنفّذ المهارة عمليات خطرة (كحذف ملفات النظام أو الوصول لمسارات حساسة)؛ ثانياً، يجب أن تتناسب أذونات الأدوات المطلوبة مع وصف الوظيفة دون طلب أذونات زائدة؛ ثالثاً، يجب أن يصف description وتعليمات السلوك وظيفة المهارة الفعلية بدقة دون تضليل المستخدمين. بعد اجتياز المراجعة تظهر المهارة في نتائج بحث ClawHub.

ما الفرق بين Skill Creator والمهارات المخصصة في الدرس 03؟

مهارات الدرس 03 المخصصة تُعدَّل مباشرةً في حقل custom_skills بملف إعداد OpenClaw، مناسبة للاختصارات الشخصية البسيطة وغير قابلة للتوزيع. مهارات Skill Creator تمتلك صيغة SKILL.md معيارية كاملة، قابلة للنشر على ClawHub لتكون متاحة للمستخدمين حول العالم، وتدعم إدارة الإصدارات والإعلان عن أذونات الأدوات، مناسبة لمن يريد مشاركة سير عمله أو تسويقه.

هل يمكن تحديد المهارة المنشورة كخاصة؟

نعم. حدّد visibility: private في clawhub.yaml ولن تظهر المهارة في نتائج البحث العامة. المهارات الخاصة قابلة للتثبيت فقط عبر رابط مباشر (مثل @your-username/skill-name). المهارات المخصصة للاستخدام الداخلي في الفريق يُنصح بضبطها خاصة لتجنب الكشف عن منطق سير عمل الفريق.

الخطوات التالية

• الدرس 25 — استخدام مهارة API Gateway للاتصال بـ 100+ خدمة خارجية بدون إعداد
• الدرس 03 — فهم المفاهيم الأساسية للمهارات المخصصة