अपना खुद का Skill लिखें: SKILL.md और ClawHub प्रकाशन
एक वाक्य में लक्ष्य: अपनी पहली OpenClaw स्किल डेवलपमेंट हाथ से पूरी करें—शून्य से एक hello-world स्किल लिखें, «डायरेक्टरी बनाएं → SKILL.md लिखें → कॉल सत्यापित करें» की पूरी श्रृंखला चलाएं, और यह समझें कि ClawHub पर प्रकाशन से पहले क्या तैयारी चाहिए।
तैयारी
- पिछला पाठ «Skills शुरुआत: इंस्टॉल, उपयोग और कॉन्फ़िगरेशन» पूरा करें, तैयार स्किल्स का उपयोग करना जानते हों।
- मशीन पर OpenClaw इंस्टॉल हो (Node 24.16.0+ या 26.1.0+),
openclawकमांड उपलब्ध हो। - एक टर्मिनल विंडो काफ़ी है, अतिरिक्त डिपेंडेंसी की ज़रूरत नहीं।
मेरे साथ करें
चरण 1: स्किल डायरेक्टरी बनाएं
स्किल्स वर्कस्पेस के skills/ फ़ोल्डर में रहती हैं, एक स्किल एक डायरेक्टरी होती है:
mkdir -p ~/.openclaw/workspace/skills/hello-worldसमूह बनाना चाहें तो सबफ़ोल्डर भी बना सकते हैं (जैसे skills/personal/hello-world), स्किल का नाम फिर भी SKILL.md के frontmatter से तय होता है, कॉल करते समय यह /hello-world ही रहता है।
अपेक्षित परिणाम: skills/hello-world/ डायरेक्टरी सफलतापूर्वक बन जाती है; OpenClaw डिफ़ॉल्ट रूप से skills रूट डायरेक्टरी के SKILL.md फ़ाइलों की निगरानी करता है।
चरण 2: SKILL.md लिखें
डायरेक्टरी में नई SKILL.md बनाएं: frontmatter में मेटाडेटा लिखें, मुख्य भाग में agent के लिए निर्देश लिखें।
---
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 केवल लोअरकेस अक्षर, अंक और हाइफ़न; डायरेक्टरी का नाम frontmatter के name से मेल खाए; description एक पंक्ति में रखें, 160 अक्षरों से अधिक न हो—यह agent को दिखाई देता है और स्लैश कमांड डिस्कवरी में भी आता है।
अपेक्षित परिणाम: फ़ाइल skills/hello-world/SKILL.md के रूप में सहेजी जाती है, frontmatter सामान्य रूप से पार्स हो जाता है।
चरण 3: लोडिंग सत्यापित करें और परीक्षण करें
openclaw skills listसूची में hello-world दिखाई दे तो वह लोड हो चुकी है। यदि आपने पुराना सेशन जारी रखा है या मॉनिटर बंद है, पहले रिफ्रेश करें:
# 聊天里:归档当前会话,开新会话
/new# 或重启网关
openclaw gateway restartफिर परीक्षण करें:
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 की «बनाएं-सत्यापित करें-इंस्टॉल करें-कॉल करें» श्रृंखला पूरी हो जाएगी।