Skip to content

كتابة Skill خاص بك: SKILL.md والنشر على ClawHub ​

الهدف في سطر واحد: إكمال أول تجربة تطوير مهارات OpenClaw عمليًا — كتابة مهارة hello-world من الصفر، وإنجاز المسار الكامل «إنشاء المجلد ← كتابة SKILL.md ← التحقق من الاستدعاء»، ومعرفة ما يجب تحضيره قبل النشر على ClawHub.

التحضير ​

  • إتمام الدرس السابق «البدء مع Skills: التثبيت والاستخدام والإعداد»، ومعرفة استخدام المهارات الجاهزة.
  • تثبيت OpenClaw على الجهاز (Node 24.16.0+ أو 26.1.0+)، وأمر openclaw متاح.
  • نافذة طرفية واحدة تكفي، ولا حاجة إلى أي تبعيات إضافية.

نفّذ معي ​

الخطوة 1: إنشاء مجلد المهارة ​

توضع المهارات في مجلد skills/ داخل مساحة العمل، وكل مهارة هي مجلد واحد:

bash
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.

markdown
---
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: التحقق من التحميل والاختبار ​

bash
openclaw skills list

ظهور hello-world في القائمة يعني أنه تم تحميلها. إذا كنت تكمل جلسة قديمة أو كان المراقب معطلًا، فحدّث أولًا:

bash
# 聊天里:归档当前会话,开新会话
/new
bash
# 或重启网关
openclaw gateway restart

ثم اختبر:

bash
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.

gaodong.aiAboutPrivacyContact

Independent tutorials, not affiliated with any product mentioned. Product names and trademarks belong to their owners. Check official pages for prices and policies.