एक बेहतरीन Openclaw सेटअप की संरचना

कार्यक्षेत्र फ़ाइलों, कौशलों, चैनलों, अनुमतियों और उन्हें सही तरीके से कॉन्फ़िगर करने की एक संपूर्ण मार्गदर्शिका।

अधिकांश OpenClaw उपयोगकर्ता इसे इंस्टॉल करते हैं, एक चैनल कनेक्ट करते हैं, और कभी भी कार्यक्षेत्र फ़ोल्डर नहीं खोलते हैं।

यह एक गलती है।

आपका कार्यक्षेत्र वह कंट्रोल सेंटर है जो यह तय करता है कि आपका AI सहायक कैसे व्यवहार करता है। इसमें आपकी पहचान, कस्टम कौशल, चैनल कनेक्शन और मेमोरी शामिल होती है। एक बार जब आप समझ जाते हैं कि क्या कहाँ रहता है, तो आप OpenClaw को ठीक उसी तरह कॉन्फ़िगर कर सकते हैं जैसा आपको चाहिए।

यह मार्गदर्शिका एक आदर्श सेटअप की संरचना के बारे में बताती है।

PS: Openclaw तो बस शुरुआत है।

हमारे Build With AI समुदाय के अंदर, हम आपको सिखाएंगे कि कैसे कस्टम एजेंट, ऐप्स और ऑटोमेशन बनाएं जिनका उपयोग आप स्वयं कर सकते हैं या ग्राहकों को बेच सकते हैं। जल्द ही लॉन्च हो रहा है।

यहाँ वेटलिस्ट में शामिल हों: https://return-my-time.kit.com/1bd2720397

-----------------------------------------

दो कॉन्फ़िगरेशन लेयर, एक नहीं

गहराई में जाने से पहले, एक बात जानना ज़रूरी है: OpenClaw दो कॉन्फ़िगरेशन लेयर का उपयोग करता है।

पहली है आपका कार्यक्षेत्र फ़ोल्डर (आमतौर पर ~/clawd/ या जहाँ भी आपने इनिशियलाइज़ किया)। इसमें आपकी व्यक्तिगत कॉन्फ़िगरेशन, कौशल, मेमोरी और सीक्रेट्स होते हैं।

दूसरी है ग्लोबल इंस्टॉलेशन opt/homebrew/lib/node_modules/clawdbot/ (या आपके सिस्टम पर समकक्ष) पर। इसमें मुख्य दस्तावेज़, बिल्ट-इन कौशल और डिफ़ॉल्ट व्यवहार होते हैं।

आपका कार्यक्षेत्र वह जगह है जहाँ आप कस्टमाइज़ करते हैं। ग्लोबल इंस्टॉल वह है जिसे आप अपडेट करते हैं।

AGENTS.md: आपके संचालन निर्देश

यह आपके पूरे सेटअप की सबसे महत्वपूर्ण फ़ाइल है। जब OpenClaw एक सत्र शुरू करता है, तो सबसे पहले वह AGENTS.md को पढ़ता है। वह इसे सीधे सिस्टम प्रॉम्प्ट में लोड करता है और पूरी बातचीत के दौरान इसे ध्यान में रखता है।

सीधे शब्दों में कहें: आप AGENTS.md में जो कुछ भी लिखते हैं, आपका एजेंट उसका पालन करेगा।

यदि आप इसे बताते हैं कि मीटिंग का समय सुझाने से पहले हमेशा अपना कैलेंडर जाँचे, तो यह करेगा। यदि आप कहते हैं "मेरी स्पष्ट अनुमति के बिना कभी ईमेल न भेजें", तो यह हर बार इसका सम्मान करेगा।

AGENTS.md में वास्तव में क्या शामिल करें:

लिखें:

• आपका मुख्य संचालन निर्देश (एजेंट का काम क्या है?)
• प्रमुख उपकरण और उनका उपयोग कैसे करें (ईमेल CLI, कार्य प्रबंधन वर्कफ़्लो)
• कठोर नियम जिन्हें कभी नहीं तोड़ा जाना चाहिए
• महत्वपूर्ण संसाधनों के लिंक (API दस्तावेज़, कौशल स्थान)
• वर्कफ़्लो ट्रिगर (स्वचालित रूप से क्या होना चाहिए)

न लिखें:

• पूर्ण दस्तावेज़ीकरण जिसे आप इसके बजाय लिंक कर सकते हैं
• सिद्धांत समझाने वाले लंबे पैराग्राफ
• ऐसी जानकारी जो बार-बार बदलती है

AGENTS.md को 300 लाइनों से कम रखें। इससे लंबी फ़ाइलें बहुत अधिक संदर्भ खाने लगती हैं, और निर्देश पालन वास्तव में कम हो जाता है।

यहाँ एक न्यूनतम लेकिन प्रभावी उदाहरण है:

1# AGENTS.md - Clawdbot कार्यक्षेत्र
2
3## मुख्य संचालन निर्देश
4मेरा सहायक मेरे व्यवसाय के लिए एक सक्रिय मददगार के रूप में काम करता है।
5
6**अनिवार्यता:**
7- मेरी प्लेट से जितना हो सके उतना कम करें
8- सक्रिय रहें - पूछे जाने का इंतज़ार न करें
9
10## प्रमुख उपकरण
11- **ईमेल:** प्रतिदिन इनबॉक्स जाँचें, महत्वपूर्ण आइटम फ़्लैग करें
12- **कैलेंडर:** शेड्यूल करने से पहले कोई विरोध न हो, यह सुनिश्चित करें
13- **कार्य प्रबंधक:** पूर्ण किए गए कार्य को डैशबोर्ड पर सिंक करें
14
15## कठोर नियम
16- स्पष्ट अनुमति के बिना कभी सेवाएँ रीस्टार्ट न करें
17- शेड्यूल करने से पहले हमेशा `date` कमांड से तिथियाँ सत्यापित करें
18- सभी पूर्ण किए गए कार्य को ट्रैकिंग सिस्टम में लॉग करें

यह लगभग 20 लाइनों के मुख्य निर्देश हैं। यह आपके एजेंट को लगातार स्पष्टीकरण के बिना उत्पादक रूप से काम करने के लिए आवश्यक सब कुछ देता है।

SOUL.md: व्यक्तित्व और सीमाएँ

SOUL.md परिभाषित करता है कि आपका एजेंट कौन है और उसे कैसे संवाद करना चाहिए। यह वह जगह है जहाँ व्यक्तित्व रहता है।

1# SOUL.md - व्यक्तित्व और सीमाएँ
2
3- उत्तर संक्षिप्त और सीधे रखें।
4- जब आवश्यक हो तब स्पष्ट करने वाले प्रश्न पूछें।
5- बाहरी मैसेजिंग सतहों पर कभी स्ट्रीमिंग/आंशिक उत्तर न भेजें।

यदि AGENTS.md निर्देश पुस्तिका है, तो SOUL.md व्यक्तित्व प्रोफ़ाइल है। कुछ उपयोगकर्ता यहाँ विस्तृत व्यक्तित्व लिखते हैं। अन्य इसे न्यूनतम रखते हैं। दोनों काम करते हैं, यह इस बात पर निर्भर करता है कि आप कितना व्यक्तित्व अनुकूलन चाहते हैं।

IDENTITY.md और USER.md: कौन कौन है

ये दो फ़ाइलें आपके एजेंट और आपके बीच संबंध स्थापित करती हैं।

IDENTITY.md आपके एजेंट को परिभाषित करता है:

1# IDENTITY.md - एजेंट पहचान
2
3- नाम: [आपके एजेंट का नाम]
4- प्राणी: [वैकल्पिक: मज़ेदार विवरणक]
5- वाइब: चतुर, मददगार, भरोसेमंद, लगातार समस्या-समाधानकर्ता
6- इमोजी: [आपका चुना हुआ इमोजी]

USER.md आपको परिभाषित करता है:

1# USER.md - उपयोगकर्ता प्रोफ़ाइल
2
3- नाम: [आपका नाम]
4- पसंदीदा संबोधन: [उपनाम]
5- समय क्षेत्र: [आपका समय क्षेत्र]
6- फ़ोन: [आपका नंबर]
7- कैलेंडर: [कैलेंडर प्लेटफ़ॉर्म और ईमेल]

अलग-अलग फ़ाइलें क्यों? क्योंकि वे अलग-अलग उद्देश्यों की पूर्ति करती हैं। IDENTITY.md शायद ही कभी बदलता है जब एक बार सेट हो जाता है। USER.md अपडेट होता है जैसे-जैसे आपकी प्राथमिकताएँ विकसित होती हैं। उन्हें अलग रखने से रखरखाव आसान हो जाता है।

HEARTBEAT.md: निर्धारित जाँच-पड़ताल

यह फ़ाइल नियंत्रित करती है कि आपका एजेंट हार्टबीट पोल के दौरान क्या करता है—निर्धारित क्षण जब सिस्टम जाँचता है कि क्या किसी चीज़ पर ध्यान देने की आवश्यकता है।

1# HEARTBEAT.md
2
3**यदि संदेश में "⚠️ EXECUTION CRON" है:**
4- यह हार्टबीट जाँच नहीं है - यह करने का काम है
5- संदेश में पूर्ण निर्देश पढ़ें
6- सभी आवश्यक चरण निष्पादित करें
7- कभी HEARTBEAT_OK न लौटाएँ
8
9**अन्यथा:**
10- यदि किसी चीज़ पर ध्यान देने की आवश्यकता नहीं है, तो HEARTBEAT_OK लौटाएँ
11- इसे न्यूनतम रखें

हार्टबीट सक्रिय एजेंट बनाने के लिए शक्तिशाली हैं। आपका एजेंट आपका कैलेंडर जाँच सकता है, आपका इनबॉक्स स्कैन कर सकता है, या एक शेड्यूल पर कोई भी स्वचालित वर्कफ़्लो चला सकता है, ये सब हार्टबीट पोल द्वारा ट्रिगर होते हैं।

TOOLS.md: बाहरी उपकरण दस्तावेज़ीकरण

यह फ़ाइल बाहरी उपकरणों और परंपराओं के बारे में आपके नोट्स रखती है। यह परिभाषित नहीं करता कि कौन से उपकरण मौजूद हैं (OpenClaw इसे आंतरिक रूप से संभालता है), लेकिन यह वह जगह है जहाँ आप दस्तावेज़ित करते हैं कि आप उनका उपयोग कैसे करते हैं।

1# TOOLS.md - उपयोगकर्ता उपकरण नोट्स
2
3## ईमेल CLI
4- खाता: [email protected]
5- सामान्य: `cli email search`, `cli calendar create`
6
7## कार्य प्रबंधन API
8- टोकन स्थान: ~/.secrets/task-api-token.txt
9- पेजिनेशन समस्याओं से बचने के लिए हमेशा `limit=100` का उपयोग करें
10- स्थिति रूपांतरण: [अपने विशिष्ट वर्कफ़्लो का दस्तावेज़ीकरण करें]
11
12## वेब स्क्रैपिंग उपकरण (जब साइटें सामान्य अनुरोधों को ब्लॉक करती हैं)
13- स्थान: ~/clawd/.venv/scraper
14- संरक्षित साइटों के लिए स्टील्थ मोड का उपयोग करें

यह आपका व्यक्तिगत संदर्भ मार्गदर्शिका बन जाता है। जब आपके एजेंट को किसी उपकरण का उपयोग करने की आवश्यकता होती है, तो वह आपके विशिष्ट परंपराओं के लिए TOOLS.md की जाँच करता है।

skills/ फ़ोल्डर: पुन: प्रयोज्य वर्कफ़्लो

कौशल वह जगह हैं जहाँ OpenClaw शक्तिशाली हो जाता है। प्रत्येक कौशल एक स्व-निहित वर्कफ़्लो है जिसे आपका एजेंट तब लागू कर सकता है जब कार्य कौशल के विवरण से मेल खाता हो।

प्रत्येक कौशल अपनी स्वयं की उपनिर्देशिका में SKILL.md फ़ाइल के साथ रहता है:

1skills/
2├── meeting-prep/
3│   └── SKILL.md
4├── social-post-writer/
5│   ├── SKILL.md
6│   └── references/
7│       └── templates.md
8└── podcast-show-notes/
9    └── SKILL.md

एक SKILL.md YAML फ्रंटमैटर का उपयोग करके वर्णन करता है कि इसका उपयोग कब करना है:

1---
2name: meeting-prep
3description: स्वचालित कॉल-पूर्व शोध और ब्रीफिंग। उपयोग करें जब उपयोगकर्ता आगामी मीटिंग्स की जाँच करने या मीटिंग प्रीप चलाने के लिए कहे।
4---
5
6# मीटिंग प्रीप कौशल
7
8## कब ट्रिगर करें:
9- उपयोगकर्ता आगामी मीटिंग्स की जाँच करने के लिए कहता है
10- क्रोन के माध्यम से हर 10 मिनट में चलने के लिए शेड्यूल किया गया
11- केवल पहली बार कॉल के लिए ब्रीफ करता है
12
13## प्रक्रिया:
141. अगले 15-45 मिनट में मीटिंग्स के लिए कैलेंडर जाँचें
152. प्रतिभागियों पर शोध करें (LinkedIn, कंपनी वेबसाइट)
163. ब्रीफिंग दस्तावेज़ बनाएँ
174. कैलेंडर ईवेंट में लिंक संलग्न करें

स्थैतिक निर्देशों से मुख्य अंतर: कौशल अपने साथ सहायक फ़ाइलों को बंडल कर सकते हैं। references/templates.md फ़ाइल उदाहरण आउटपुट, सिद्ध प्रारूप, या अतिरिक्त संदर्भ रख सकती है जो केवल तभी लोड होता है जब कौशल सक्रिय हो।

memory/ फ़ोल्डर: स्थायी संदर्भ

यह आपके एजेंट की दीर्घकालिक मेमोरी है। सत्र प्रतिलेख, सीखी गई प्राथमिकताएँ और दैनिक लॉग सभी यहाँ रहते हैं।

1memory/
2├── 2026-03-22.md
3├── 2026-03-21.md
4├── email-style.md
5├── business-context-2026-02.md
6└── workflow-playbook.md

अच्छी प्रथाएँ:

• दैनिक लॉग को memory/YYYY-MM-DD.md पर रखें
• सत्र शुरू होने पर, आपका एजेंट आज + कल पढ़ता है यदि मौजूद हो
• स्थायी तथ्यों, प्राथमिकताओं और निर्णयों को कैप्चर करें
• सीक्रेट्स को संग्रहीत करने से बचें

मेमोरी फ़ाइलें वह हैं जो आपके एजेंट को सत्रों में संदर्भ देती हैं। उनके बिना, हर बातचीत शून्य से शुरू होती है।

.secrets/ फ़ोल्डर: क्रेडेंशियल्स

API टोकन, पासवर्ड और संवेदनशील कॉन्फ़िगरेशन यहाँ रहते हैं। इस फ़ोल्डर को gitignored किया जाना चाहिए और कभी कमिट नहीं किया जाना चाहिए।

1.secrets/
2├── task-api-token.txt
3├── openai-api-key.txt
4├── anthropic-api-key.txt
5└── service-credentials.txt

आपका AGENTS.md या TOOLS.md वास्तविक मानों को उजागर किए बिना इन पथों को संदर्भित कर सकता है।

चैनल कॉन्फ़िगरेशन: जहाँ आप अपने एजेंट से बात करते हैं

OpenClaw कई मैसेजिंग चैनलों का समर्थन करता है: Discord, Telegram, Signal, WhatsApp, और और भी। चैनल कॉन्फ़िगरेशन आपके गेटवे कॉन्फ़िगरेशन में रहता है (clawdbot gateway कमांड के माध्यम से प्रबंधित)।

प्रमुख अवधारणाएँ:

• प्रत्येक चैनल का अपना सत्र व्यवहार होता है
• आप एक साथ कई चैनल सक्रिय रख सकते हैं
• चैनल-विशिष्ट नियम (जैसे "Discord में @mentioned किए जाने तक जवाब न दें") AGENTS.md में जाते हैं

पूरा चित्र

यहाँ बताया गया है कि सब कुछ एक साथ कैसे आता है:

1~/clawd/
2├── AGENTS.md           # संचालन निर्देश (दैनिक उपयोग)
3├── SOUL.md             # व्यक्तित्व और सीमाएँ
4├── IDENTITY.md         # एजेंट पहचान
5├── USER.md             # आपकी प्रोफ़ाइल
6├── HEARTBEAT.md        # निर्धारित जाँच-पड़ताल व्यवहार
7├── TOOLS.md            # बाहरी उपकरण दस्तावेज़ीकरण
8├── BOOTSTRAP.md        # पहली बार चलाने की रस्म (बाद में हटाएँ)
9│
10├── skills/             # कस्टम वर्कफ़्लो
11│   ├── meeting-prep/
12│   ├── podcast-show-notes/
13│   └── social-post-writer/
14│
15├── memory/             # स्थायी संदर्भ
16│   ├── 2026-03-22.md
17│   └── key-context.md
18│
19├── .secrets/           # API कुंजियाँ और क्रेडेंशियल्स (gitignored)
20│   ├── task-api-token.txt
21│   └── anthropic-api-key.txt
22│
23└── output/             # जनरेट की गई फ़ाइलें और निर्यात

शुरू करने के लिए एक व्यावहारिक सेटअप

यदि आप शुरुआत से शुरू कर रहे हैं, तो यहाँ एक प्रगति है जो अच्छी तरह से काम करती है।

चरण 1. openclaw onboard चलाएँ और प्रारंभिक सेटअप पूरा करें। अपना मॉडल प्रदाता चुनें और कम से कम एक चैनल कनेक्ट करें।

चरण 2. अपना कार्यक्षेत्र फ़ोल्डर बनाएँ और अपने मुख्य निर्देशों के साथ AGENTS.md जोड़ें। अपने मुख्य उपयोग मामलों को कवर करते हुए 10-20 लाइनों से शुरू करें।

चरण 3. IDENTITY.md, USER.md और SOUL.md जोड़ें। ये संबंध और व्यक्तित्व स्थापित करते हैं।

चरण 4. एक वर्कफ़्लो के लिए अपना पहला कौशल बनाएँ जिसे आप बार-बार करते हैं। मीटिंग प्रीप, ईमेल ड्राफ्ट या सामग्री निर्माण अच्छे शुरुआती बिंदु हैं।

चरण 5. memory/ को एक दैनिक लॉग टेम्पलेट के साथ सेट करें। आपका एजेंट समय के साथ संदर्भ बनाना शुरू कर देगा।

चरण 6. TOOLS.md जोड़ें जैसे-जैसे आप उपकरण-विशिष्ट पैटर्न खोजते हैं जो दस्तावेज़ित करने योग्य हैं।

यह वास्तव में 95% उपयोग मामलों के लिए आपको बस इतना ही चाहिए। क्रॉन जॉब्स, मल्टी-एजेंट सेटअप और कस्टम चैनल प्लगइन्स जैसी उन्नत सुविधाएँ तब आती हैं जब आपके पास ऑटोमेट करने लायक विशिष्ट वर्कफ़्लो हों।

मुख्य अंतर्दृष्टि

आपका OpenClaw कार्यक्षेत्र वास्तव में अपने AI सहायक को यह बताने के लिए एक प्रोटोकॉल है कि आप कौन हैं, आपको क्या करने की आवश्यकता है, और इसे किन नियमों का पालन करना चाहिए। जितना स्पष्ट रूप से आप इसे परिभाषित करेंगे, उतना ही कम समय आप अपने एजेंट को सही करने में बिताएँगे और उतना ही अधिक समय यह उपयोगी काम करने में बिताएगा।

AGENTS.md आपकी सबसे अधिक लाभप्रद फ़ाइल है। पहले इसे सही करें। बाकी सब कुछ अनुकूलन है।

छोटे से शुरू करें, जैसे-जैसे आप आगे बढ़ें सुधारें, और इसे अपने वर्कफ़्लो में किसी भी अन्य बुनियादी ढाँचे की तरह मानें: कुछ ऐसा जो एक बार ठीक से सेट हो जाने पर हर दिन लाभांश देता है।

PS: Openclaw तो बस शुरुआत है।

हमारे Build With AI समुदाय के अंदर, मैं आपको सिखाऊंगा कि कैसे कस्टम एजेंट, ऐप्स और ऑटोमेशन बनाएं जिनका उपयोग आप स्वयं कर सकते हैं या ग्राहकों को बेच सकते हैं। जल्द ही लॉन्च हो रहा है।

यहाँ वेटलिस्ट में शामिल हों:

https://return-my-time.kit.com/1bd2720397