كتابة Skill خاص بك: SKILL.md والنشر على ClawHub
الهدف في سطر واحد: إكمال أول تجربة تطوير مهارات OpenClaw عمليًا — كتابة مهارة hello-world من الصفر، وإنجاز المسار الكامل «إنشاء المجلد ← كتابة SKILL.md ← التحقق من الاستدعاء»، ومعرفة ما يجب تحضيره قبل النشر على ClawHub.
التحضير
- إتمام الدرس السابق «البدء مع Skills: التثبيت والاستخدام والإعداد»، ومعرفة استخدام المهارات الجاهزة.
- تثبيت OpenClaw على الجهاز (Node 24.16.0+ أو 26.1.0+)، وأمر
openclawمتاح. - نافذة طرفية واحدة تكفي، ولا حاجة إلى أي تبعيات إضافية.
نفّذ معي
الخطوة 1: إنشاء مجلد المهارة
توضع المهارات في مجلد skills/ داخل مساحة العمل، وكل مهارة هي مجلد واحد:
mkdir -p ~/.openclaw/workspace/skills/hello-worldيمكنك أيضًا استخدام مجلدات فرعية للتجميع (مثل skills/personal/hello-world)، ويظل اسم المهارة محددًا بواسطة frontmatter في SKILL.md، والاستدعاء يتم عبر /hello-world.
النتيجة المتوقعة: تم إنشاء المجلد skills/hello-world/ بنجاح؛ ويراقب OpenClaw افتراضيًا ملفات SKILL.md في المجلد الجذري للمهارات.
الخطوة 2: كتابة SKILL.md
أنشئ ملف SKILL.md داخل المجلد: يُكتب الـ frontmatter للبيانات الوصفية، ويحتوي المتن على التعليمات الموجهة إلى الـ agent.
---
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 حرفًا — فهو يُعرض على الـ agent ويظهر أيضًا في اكتشاف أوامر الشرطة المائلة.
النتيجة المتوقعة: تم حفظ الملف باسم skills/hello-world/SKILL.md، ويمكن تحليل الـ frontmatter بشكل صحيح.
الخطوة 3: التحقق من التحميل والاختبار
openclaw skills listظهور hello-world في القائمة يعني أنه تم تحميلها. إذا كنت تكمل جلسة قديمة أو كان المراقب معطلًا، فحدّث أولًا:
# 聊天里:归档当前会话,开新会话
/new# 或重启网关
openclaw gateway restartثم اختبر:
openclaw agent --message "give me a greeting"يمكنك أيضًا ذكر طلبك مباشرة في المحادثة، أو استخدام /skill hello-world للاستدعاء الصريح بالاسم.
النتيجة المتوقعة: ينفذ الـ agent الأوامر الموجودة في المهارة ويرد عليك بعبارة Hello from your custom skill!.
التحقق
راجع كل بند:
openclaw skills listيُظهر hello-world./skill hello-worldالاستدعاء الصريح يعطي مخرجات.- بعد تعديل SKILL.md، تحصل الجلسة الجديدة عبر
/newأو إعادة تشغيل البوابة على قائمة مهارات محدّثة.
إذا نجح كل شيء، فهذا يعني أن مهارتك الأولى أصبحت قابلة للاستخدام. المهارة في جوهرها هي «مجلد + SKILL.md»، وبعد نجاح الاختبار يمكنك التفكير في نشرها على ClawHub ليقوم الآخرون بتثبيتها: ثبّت ClawHub CLI المستقل (npm i -g clawhub) وسجّل الدخول عبر clawhub login، ثم انشر باستخدام clawhub skill publish ~/.openclaw/workspace/skills/hello-world؛ وتُعتمد تفاصيل مراجعة السجل وغيرها على وثائق ClawHub الرسمية.
المزالق الشائعة
- عدم تطابق اسم المجلد مع
name: اسم المهارة يُحدد بواسطة الـ frontmatter، واسم المجلد مجرد حاوية؛ لكن عدم تطابقهما يؤدي بسهولة إلى استدعاء خاطئ، والحفاظ على التطابق هو الأسهل. - description طويل جدًا: تجاوز 160 حرفًا يعيق اكتشاف أوامر الشرطة المائلة، فاضغطه في سطر واحد.
- تعديل SKILL.md دون تفعيل: الجلسات القديمة لا تحدّث قائمة المهارات تلقائيًا، افتح جلسة جديدة عبر
/newأو نفّذopenclaw gateway restartثم أعد المحاولة.
الدرس التالي
بعد إنجاز كتابة المهارة يدويًا وتشغيلها، يأتي الدرس التالي «Skill Workshop: دع Claw يتعلم المهارات بنفسه» ليجعل Claw يصوغ المهارات ويتحقق منها ويطوّرها نيابة عنك — وبذلك تكتمل سلسلة «الإنشاء - التحقق - التثبيت - الاستدعاء» في OpenClaw 2.0.