Building Custom Skills for OpenClaw: Step-by-Step Tutorial

OpenClaw 50+ बंडल कौशल के साथ आता है और ClawHub बाज़ार 5,700 से अधिक समुदाय-निर्मित विकल्पों की मेजबानी करता है। लेकिन वास्तविक प्रतिस्पर्धात्मक लाभ आपके सटीक वर्कफ़्लो के लिए निर्मित कस्टम कौशल से आता है। चाहे आपको एक मालिकाना एपीआई को एकीकृत करने, एक जटिल व्यावसायिक प्रक्रिया को स्वचालित करने, या एक आंतरिक डेटाबेस से जुड़ने की आवश्यकता हो, कस्टम कौशल इसे संभव बनाते हैं।

यह ट्यूटोरियल संपूर्ण जीवनचक्र - वास्तुकला निर्णयों से लेकर उत्पादन परिनियोजन तक - व्यावहारिक उदाहरणों के साथ चलता है जिन्हें आप अनुकूलित कर सकते हैं।

कौशल वास्तुकला को समझना

OpenClaw में एक कौशल एक स्व-निहित मॉड्यूल है जो एजेंट को एक विशिष्ट कार्य करना सिखाता है। कौशल सरल निर्देश फ़ाइलों से लेकर एपीआई एकीकरण और जटिल तर्क के साथ पूर्ण अनुप्रयोगों तक होते हैं।

कौशल निर्देशिका संरचना

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 फ़ाइल

यह हर कौशल का दिल है. यह एजेंट को बताता है कि कौशल क्या करता है, इसे कब सक्रिय करना है, कैसे निष्पादित करना है, इसे किस डेटा की आवश्यकता है और आउटपुट को कैसे प्रारूपित करना है। इसे स्पष्ट, प्राकृतिक भाषा में लिखें - एलएलएम इन निर्देशों की व्याख्या करता है।

ट्यूटोरियल: सीआरएम लुकअप कौशल का निर्माण

चरण 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: कोड मॉड्यूल जोड़ें

For API integrations, add an index.ts file that handles API authentication, request formatting, error handling, and response parsing.

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 को पुनरारंभ करें। टीम परिनियोजन के लिए, एनपीएम मॉड्यूल या गिट रिपॉजिटरी के रूप में पैकेज कौशल।

उन्नत कौशल पैटर्न

स्टेटफुल कौशल

कुछ कौशल OpenClaw मेमोरी एपीआई का उपयोग करके कई इंटरैक्शन में स्थिति बनाए रखते हैं। बातचीत के दौरों के बीच पढ़ने और लिखने की स्थिति द्वारा अनुमोदन प्रक्रियाओं जैसे बहु-चरणीय वर्कफ़्लो को सक्षम करें।

समग्र कौशल

कौशल जो जटिल वर्कफ़्लो के लिए अन्य कौशलों को सौंपते हैं। एक प्रोसेसऑर्डर कौशल क्रम में सीआरएम-ग्राहक-लुकअप, इन्वेंट्री-चेक और मूल्य निर्धारण-कैलकुलेटर कौशल को लागू कर सकता है, उनके परिणामों को एक ही प्रतिक्रिया में संयोजित कर सकता है।

अनुसूचित कौशल

कौशल जो ऑन-डिमांड के बजाय क्रॉन शेड्यूल पर चलते हैं। स्वचालित दैनिक रिपोर्ट और निगरानी कार्यों के लिए कौशल कॉन्फ़िगरेशन में शेड्यूल, टाइमज़ोन और अधिसूचना चैनल कॉन्फ़िगर करें।

कस्टम कौशल के लिए सुरक्षा सर्वोत्तम अभ्यास

• क्रेडेंशियल प्रबंधन -- कभी भी एपीआई कुंजियों को हार्डकोड न करें। बाकी समय में एन्क्रिप्शन के लिए सेंसिटिव: ट्रू के साथ कॉन्फिग सिस्टम का उपयोग करें।
• इनपुट सत्यापन -- उपयोगकर्ता इनपुट को एपीआई या डेटाबेस में भेजने से पहले हमेशा सत्यापित और स्वच्छ करें।
• अनुमति का दायरा -- केवल उन्हीं अनुमतियों का अनुरोध करें जिनकी आपके कौशल को आवश्यकता है। केवल पढ़ने योग्य कौशल के लिए लिखने की पहुंच नहीं होनी चाहिए।
• दर सीमित करना - अनुरोध गणना के साथ बाहरी एपीआई को आकस्मिक बाढ़ से बचाएं।

डिबगिंग कौशल

कौशल निष्पादन का पता लगाने के लिए वर्बोज़ लॉगिंग सक्षम करें। चरण-दर-चरण निष्पादन के लिए OpenClaw कौशल डिबगर का उपयोग करें:

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

अक्सर पूछे जाने वाले प्रश्न

कोई एक कौशल कितना जटिल होना चाहिए?

एकल-जिम्मेदारी सिद्धांत का पालन करें। एक कौशल को एक काम अच्छे से करना चाहिए। जटिल वर्कफ़्लो में समग्र कौशल का उपयोग किया जाना चाहिए जो विशिष्ट लोगों को सौंपा जाए।

क्या मैं कौशल कोड के लिए टाइपस्क्रिप्ट के बजाय पायथन का उपयोग कर सकता हूं?

हाँ। ओपनक्लॉ कौशल कोड मॉड्यूल के लिए टाइपस्क्रिप्ट, पायथन और गो का समर्थन करता है। SKILL.md फ़ाइल और config.json भाषा की परवाह किए बिना समान रहते हैं।

मैं उत्पादन में कौशल का संस्करण और अद्यतन कैसे करूँ?

config.json में सिमेंटिक वर्जनिंग का उपयोग करें। पुराने संस्करणों के साथ नए संस्करण तैनात करें (नीला-हरा परिनियोजन) और ट्रैफ़िक को धीरे-धीरे बदलें। OpenClaw मूल रूप से कौशल संस्करण का समर्थन करता है।

अगले चरण

उद्यम कौशल विकास के लिए, ECOSIRE OpenClaw कस्टम कौशल सेवा वास्तुकला मार्गदर्शन, कोड समीक्षा, सुरक्षा ऑडिटिंग और उत्पादन परिनियोजन सहायता प्रदान करती है।

---

क्या आपको अपने विशिष्ट वर्कफ़्लो के लिए कस्टम कौशल निर्मित करने की आवश्यकता है? कौशल मूल्यांकन के लिए हमारी ओपनक्लॉ सेवाओं का अन्वेषण करें या हमसे संपर्क करें।