OpenClaw کے لیے اپنی مرضی کے مطابق مہارتیں بنانا: مرحلہ وار ٹیوٹوریل

OpenClaw 50+ بنڈل مہارتوں کے ساتھ بحری جہاز اور ClawHub مارکیٹ پلیس 5,700 سے زیادہ کمیونٹی کے ذریعے بنائے گئے اختیارات کی میزبانی کرتا ہے۔ لیکن حقیقی مسابقتی فائدہ آپ کے عین کام کے بہاؤ کے لیے تیار کردہ حسب ضرورت مہارتوں سے حاصل ہوتا ہے۔ چاہے آپ کو ایک ملکیتی API کو مربوط کرنے کی ضرورت ہو، ایک پیچیدہ کاروباری عمل کو خودکار کرنا ہو، یا کسی اندرونی ڈیٹا بیس سے جڑنا ہو، حسب ضرورت مہارت اسے ممکن بناتی ہے۔

یہ ٹیوٹوریل مکمل لائف سائیکل سے گزرتا ہے -- فن تعمیر کے فیصلوں سے لے کر پروڈکشن کی تعیناتی تک -- عملی مثالوں کے ساتھ جنہیں آپ ڈھال سکتے ہیں۔

مہارت کے فن تعمیر کو سمجھنا

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: ٹیسٹ لکھیں۔

یونٹ کوڈ ماڈیول کا فرضی API جوابات کے ساتھ ٹیسٹ کریں۔ سٹیجنگ میں حقیقی API کے ساتھ انٹیگریشن ٹیسٹ۔ آپ کی میسجنگ ایپ کے ذریعے گفتگو کا ٹیسٹ۔ خراب ان پٹ، API ناکامیوں، اور ٹائم آؤٹ کے ساتھ ایج کیس ٹیسٹ۔

مرحلہ 5: مہارت کو متعین کریں۔

اسکل ڈائرکٹری کو OpenClaw سکلز فولڈر میں کاپی کریں، انحصار انسٹال کریں، اور OpenClaw کو دوبارہ شروع کریں۔ ٹیم کی تعیناتیوں کے لیے، پیکج کی مہارتیں بطور این پی ایم ماڈیولز یا گٹ ریپوزٹریز۔

اعلی درجے کی مہارت کے پیٹرن

ریاستی ہنر

کچھ مہارتیں OpenClaw میموری API کا استعمال کرتے ہوئے متعدد تعاملات میں حالت کو برقرار رکھتی ہیں۔ بات چیت کے موڑ کے درمیان حالت پڑھ کر اور لکھ کر منظوری کے عمل جیسے ملٹی سٹیپ ورک فلو کو فعال کریں۔

جامع ہنر

وہ ہنر جو پیچیدہ کام کے بہاؤ کے لیے دیگر مہارتوں کو تفویض کرتے ہیں۔ ایک پروسیس آرڈر کی مہارت crm-customer-lookup، inventory-check، اور pricing-calculator کی مہارتوں کو ترتیب میں، ان کے نتائج کو ایک ہی جواب میں یکجا کر سکتی ہے۔

طے شدہ ہنر

وہ ہنر جو آن ڈیمانڈ کے بجائے کرون شیڈول پر چلتے ہیں۔ روزانہ کی خودکار رپورٹوں اور نگرانی کے کاموں کے لیے اسکل کنفیگریشن میں شیڈول، ٹائم زون، اور نوٹیفکیشن چینل کو ترتیب دیں۔

اپنی مرضی کے مطابق مہارتوں کے لیے سیکیورٹی کے بہترین طریقے

• ** اسناد کا انتظام** -- کبھی بھی API کیز کو ہارڈ کوڈ نہ کریں۔ sensitive: true کے ساتھ کنفگ سسٹم کا استعمال کریں آرام میں انکرپشن کے لیے۔
• ان پٹ کی توثیق -- صارف کے ان پٹس کو APIs یا ڈیٹا بیس میں منتقل کرنے سے پہلے ہمیشہ ان کی تصدیق اور صفائی کریں۔
• پرمشن اسکوپنگ -- صرف ان اجازتوں کی درخواست کریں جن کی آپ کی مہارت کی ضرورت ہے۔ صرف پڑھنے کی مہارت کو لکھنے تک رسائی نہیں ہونی چاہیے۔
• شرح کی حد بندی -- درخواست کی گنتی کے ساتھ بیرونی APIs کو حادثاتی سیلاب سے بچائیں۔

ڈیبگنگ کی مہارتیں۔

مہارت کے عمل کو ٹریس کرنے کے لیے وربوز لاگنگ کو فعال کریں۔ مرحلہ وار عمل درآمد کے لیے OpenClaw اسکل ڈیبگر کا استعمال کریں:

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

اکثر پوچھے گئے سوالات

ایک مہارت کتنی پیچیدہ ہونی چاہیے؟

واحد ذمہ داری کے اصول پر عمل کریں۔ مہارت کو ایک کام اچھی طرح سے کرنا چاہئے۔ پیچیدہ کام کے بہاؤ کو جامع مہارتوں کا استعمال کرنا چاہئے جو خصوصی افراد کو تفویض کریں۔

کیا میں اسکل کوڈ کے لیے TypeScript کے بجائے Python استعمال کر سکتا ہوں؟

جی ہاں OpenClaw TypeScript، Python، اور Go for Skill Code ماڈیولز کو سپورٹ کرتا ہے۔ SKILL.md فائل اور config.json زبان سے قطع نظر ایک جیسے ہی رہتے ہیں۔

میں پروڈکشن میں مہارتوں کا ورژن اور اپ ڈیٹ کیسے کروں؟

config.json میں سیمنٹک ورژننگ کا استعمال کریں۔ پرانے ورژن (نیلے سبز کی تعیناتی) کے ساتھ نئے ورژن لگائیں اور ٹریفک کو آہستہ آہستہ تبدیل کریں۔ OpenClaw مقامی طور پر مہارت کے ورژن کی حمایت کرتا ہے۔

اگلے اقدامات

انٹرپرائز اسکل ڈیولپمنٹ کے لیے، ECOSIRE OpenClaw کسٹم سکلز سروس فن تعمیر کی رہنمائی، کوڈ کا جائزہ، سیکیورٹی آڈیٹنگ، اور پروڈکشن ڈیپلائمنٹ سپورٹ فراہم کرتا ہے۔

---

اپنے مخصوص ورک فلو کے لیے اپنی مرضی کے مطابق مہارتوں کی ضرورت ہے؟ ہماری OpenClaw سروسز کو دریافت کریں یا ہم سے رابطہ کریں مہارت کی جانچ کے لیے۔