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

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

يستعرض هذا البرنامج التعليمي دورة الحياة الكاملة - بدءًا من قرارات التصميم وحتى نشر الإنتاج - مع أمثلة عملية يمكنك تكييفها.

فهم بنية المهارات

المهارة في OpenClaw عبارة عن وحدة قائمة بذاتها تعلم الوكيل كيفية أداء مهمة محددة. تتراوح المهارات من ملفات التعليمات البسيطة إلى التطبيقات الكاملة مع تكاملات واجهة برمجة التطبيقات (API) والمنطق المعقد.

هيكل دليل المهارات

my-custom-skill/
  SKILL.md            # Required: natural language instructions
  index.ts            # Optional: TypeScript module for logic
  config.json         # Optional: configurable parameters
  package.json        # Optional: npm dependencies
  tests/              # Optional: test files

الملف المطلوب الوحيد هو SKILL.md. كل شيء آخر اختياري ويتم إضافته حسب متطلبات التعقيد.

الملف SKILL.md

هذا هو قلب كل مهارة. فهو يخبر الوكيل بما تفعله المهارة، ومتى يتم تنشيطها، وكيفية تنفيذها، وما هي البيانات التي تحتاجها، وكيفية تنسيق الإخراج. اكتبها بلغة واضحة وطبيعية - يقوم برنامج LLM بتفسير هذه التعليمات.

البرنامج التعليمي: بناء مهارة البحث في إدارة علاقات العملاء (CRM).

الخطوة 1: تحديد تعليمات المهارة

# CRM Customer Lookup

## When to Use
Activate when the user asks about a customer, client, or account.

## Steps
1. Extract the search criteria from the user message
2. Call the CRM API search endpoint
3. If multiple results, present a numbered list
4. If single result, display the full customer profile
5. If no results, suggest alternative search terms

الخطوة 2: إضافة وحدة التعليمات البرمجية

بالنسبة لعمليات تكامل واجهة برمجة التطبيقات (API)، قم بإضافة ملف Index.ts الذي يتعامل مع مصادقة واجهة برمجة التطبيقات (API)، وتنسيق الطلب، ومعالجة الأخطاء، وتحليل الاستجابة.

import { SkillContext, SkillResult } from "@openclaw/sdk";

export async function searchCustomer(
  ctx: SkillContext,
  query: string
): Promise<SkillResult> {
  const apiUrl = ctx.config.get("crm_api_url");
  const apiKey = ctx.config.get("crm_api_key");

  const response = await fetch(
    apiUrl + "/api/customers/search?q=" + encodeURIComponent(query),
    { headers: { Authorization: "Bearer " + apiKey } }
  );

  if (!response.ok) {
    return { success: false, error: "CRM API error: " + response.status };
  }

  const customers = await response.json();
  return {
    success: true,
    data: customers,
    message: "Found " + customers.length + " matching customer(s)."
  };
}

الخطوة 3: تكوين المهارة

قم بإنشاء config.json للمعلمات القابلة للتكوين مع إعلانات النوع، والأعلام المطلوبة، والعلامات الحساسة لبيانات الاعتماد التي يجب تشفيرها في حالة عدم النشاط.

الخطوة 4: كتابة الاختبارات

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

الخطوة 5: نشر المهارة

انسخ دليل المهارات إلى مجلد مهارات OpenClaw، ثم قم بتثبيت التبعيات، وأعد تشغيل OpenClaw. بالنسبة لعمليات نشر الفريق، مهارات الحزمة مثل وحدات npm أو مستودعات Git.

أنماط المهارات المتقدمة

مهارات الدولة

تحافظ بعض المهارات على حالتها عبر تفاعلات متعددة باستخدام واجهة برمجة تطبيقات ذاكرة OpenClaw. قم بتمكين سير العمل متعدد الخطوات مثل عمليات الموافقة من خلال قراءة الحالة وكتابتها بين دورات المحادثة.

المهارات المركبة

المهارات التي تفوض إلى مهارات أخرى لسير العمل المعقد. قد تستدعي مهارة ترتيب العمليات مهارات البحث عن العملاء، وفحص المخزون، وآلة حاسبة التسعير بالتسلسل، ودمج نتائجها في استجابة واحدة.

المهارات المجدولة

المهارات التي تعمل وفقًا لجدول كرون بدلاً من العمل حسب الطلب. قم بتكوين الجدول الزمني والمنطقة الزمنية وقناة الإشعارات في تكوين المهارات للتقارير اليومية الآلية ومهام المراقبة.

أفضل الممارسات الأمنية للمهارات المخصصة

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

مهارات التصحيح

تمكين التسجيل المطول لتتبع تنفيذ المهارات. استخدم مصحح أخطاء مهارات OpenClaw للتنفيذ خطوة بخطوة:

openclaw skill debug my-custom-skill --input "Look up customer Acme Corp"
openclaw skill trace --last

الأسئلة المتداولة

ما مدى التعقيد الذي يجب أن تكون عليه مهارة واحدة؟

اتبع مبدأ المسؤولية الفردية. يجب أن تفعل المهارة شيئًا جيدًا. يجب أن تستخدم مسارات العمل المعقدة المهارات المركبة التي يتم تفويضها إلى المهارات المتخصصة.

هل يمكنني استخدام Python بدلاً من TypeScript لرمز المهارة؟

نعم. يدعم OpenClaw وحدات TypeScript وPython وGo لوحدات كود المهارات. يظل الملف SKILL.md وconfig.json كما هو بغض النظر عن اللغة.

كيف يمكنني إصدار وتحديث المهارات في الإنتاج؟

استخدم الإصدار الدلالي في config.json. انشر الإصدارات الجديدة إلى جانب الإصدارات القديمة (النشر باللون الأزرق والأخضر) وقم بتبديل حركة المرور تدريجيًا. يدعم OpenClaw إصدار المهارات محليًا.

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

لتطوير مهارات المؤسسة، توفر خدمة المهارات المخصصة ECOSIRE OpenClaw إرشادات البنية ومراجعة التعليمات البرمجية وتدقيق الأمان ودعم نشر الإنتاج.

---

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