بناء مهارات OpenClaw المخصصة: دليل المطور

يأتي OpenClaw مزودًا بأكثر من 50 مهارة مجمعة ويستضيف سوق ClawHub أكثر من 5700 خيارًا تم إنشاؤه بواسطة المجتمع. لكن القوة الحقيقية تأتي عندما تقوم ببناء مهارات مصممة خصيصًا لسير العمل لديك. هنا كيف.

ما هي المهارة؟

المهارة هي دليل يعلم OpenClaw كيفية أداء مهمة محددة. يحتوي على ملف واحد على الأقل: SKILL.md — ملف تعليمات باللغة الطبيعية يخبر العميل بما تفعله المهارة، ومتى يستخدمها، وكيف تعمل.

يمكن أن تكون المهارات بسيطة مثل ملف نصي مع مطالبات أو معقدة مثل وحدة Node.js الكاملة مع تكاملات API واستعلامات قاعدة البيانات واستدعاءات الخدمة الخارجية.

هندسة المهارات

تعيش كل مهارة في الدليل الخاص بها مع هذه البنية الأساسية:

my-skill/
  SKILL.md          # Required: natural language instructions
  index.ts          # Optional: code module for complex logic
  package.json      # Optional: dependencies for code modules
  config.json       # Optional: configurable parameters

ملف SKILL.md هو قلب كل مهارة. اكتب تعليمات واضحة باللغة الطبيعية تشرح ما تفعله المهارة، ومتى يجب تفعيلها، وما هي الخطوات التي يجب اتباعها. لا توجد مخططات صارمة - فقط تواصل واضح.

متى يجب بناء المهارات المخصصة

قم ببناء مهارة مخصصة عندما:

• المهارات العامة غير مناسبة — يتضمن سير عملك متطلبات محددة لا تستطيع المهارات المجمعة التعامل معها
• التكامل العميق مطلوب — تحتاج إلى الاتصال بواجهة برمجة تطبيقات داخلية أو قاعدة بيانات أو خدمة معينة
• منطق العمل معقد — سير عمل متعدد الخطوات مع التفرع المشروط أو الموافقات أو تحويلات البيانات
• متطلبات الأمان — أنت بحاجة إلى التحكم في كيفية التعامل مع بيانات الاعتماد وتدفق البيانات

لا تبني عندما تكون المهارات المجمعة قادرة على حل مشكلتك. يتفوق OpenClaw في الجمع بين مهارات متعددة في سير عمل واحد، وتتطلب الحلول المركبة صيانة أقل.

بناء مهارة بسيطة

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

سكيل.MD:

# Daily Sales Summary

## When to use
When the user asks for a sales summary, daily sales report, or revenue update.

## What to do
1. Query the sales database for today's orders
2. Calculate total revenue, order count, and average order value
3. List the top 5 products by revenue
4. Format as a clean summary suitable for messaging apps

تعمل هذه المهارة المخصصة للتعليمات فقط على الاستفادة من قاعدة بيانات OpenClaw المضمنة وقدرات التنسيق. لا يوجد رمز مطلوب.

بناء مهارة متكاملة مع واجهة برمجة التطبيقات

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

تتعامل وحدة التعليمات البرمجية مع مصادقة واجهة برمجة التطبيقات (API)، وتنسيق الطلب، ومعالجة الأخطاء، وتحليل الاستجابة. يخبر ملف SKILL.md الوكيل بموعد استدعاء الكود وكيفية تقديم النتائج للمستخدم.

مهارات الاختبار

قم دائمًا باختبار المهارات في بيئة معزولة قبل نشر الإنتاج:

1. اختبار الوحدة وحدة التعليمات البرمجية بمعزل عن استجابات واجهة برمجة التطبيقات الوهمية
2. اختبار التكامل مع واجهة برمجة التطبيقات الحقيقية في بيئة مرحلية
3. اختبار المحادثة من خلال التفاعل مع المهارة من خلال تطبيق المراسلة الخاص بك
4. اختبار حالة الحافة مع المدخلات المشوهة، وفشل واجهة برمجة التطبيقات، وسيناريوهات المهلة

مراجعة الأمان

يجب مراجعة كل مهارة مخصصة من أجل:

• كشف بيانات الاعتماد — يجب أن تكون مفاتيح واجهة برمجة التطبيقات (API) في متغيرات البيئة، وليس في التعليمات البرمجية أبدًا
• استخراج البيانات — يجب ألا ترسل المهارات البيانات إلى نقاط نهاية غير مصرح بها
• إدخال الأوامر — يجب تنظيف مدخلات المستخدم قبل تنفيذ الصدفة
• الحقن الفوري — يجب أن تكون تعليمات المهارة مقاومة للمدخلات العدائية

النشر إلى ClawHub

إذا كانت مهارتك تحل مشكلة شائعة، ففكر في نشرها على ClawHub. يدعم السوق المهارات المجانية والمدفوعة (10 إلى 200 دولار حسب التعقيد). يقوم الناشرون الأوائل ببناء دخل سلبي كبير من مهارات الجودة.

متى يجب توظيف المحترفين

من السهل بناء مهارات التعليمات البسيطة فقط. لكن المهارات على مستوى الإنتاج مع تكامل واجهة برمجة التطبيقات (API)، ومعالجة الأخطاء، ومراجعة الأمان، والصيانة المستمرة تتطلب انضباطًا هندسيًا. تتعامل خدمة تطوير المهارات المخصصة من ECOSIRE مع دورة الحياة الكاملة: تحليل سير العمل، والهندسة المعمارية، والتطوير، والاختبار، والنشر.

---

• هل تحتاج إلى مهارات OpenClaw المخصصة لعملك؟ استكشف خدمة تطوير المهارات أو اتصل بنا لمناقشة سير عملك.*