पहली बार चलाना (अनुशंसित)
OpenClaw एजेंट एक वर्कस्पेस डायरेक्टरी का उपयोग करते हैं। डिफ़ॉल्ट:~/.openclaw/workspace (agents.defaults.workspace के माध्यम से कॉन्फ़िगर करने योग्य, ~ का समर्थन करता है)।
- वर्कस्पेस बनाएँ:
- डिफ़ॉल्ट वर्कस्पेस टेम्पलेट इसमें कॉपी करें:
- वैकल्पिक: सामान्य टेम्पलेट के बजाय इस फ़ाइल की निजी-सहायक स्किल सूची का उपयोग करें:
- वैकल्पिक: किसी दूसरे वर्कस्पेस की ओर इंगित करें:
सुरक्षा डिफ़ॉल्ट
- डायरेक्टरी की सामग्री या सीक्रेट चैट में न डालें।
- स्पष्ट रूप से कहे जाने तक विनाशकारी कमांड न चलाएँ।
- कॉन्फ़िगरेशन या शेड्यूलर (crontab, systemd यूनिट, nginx कॉन्फ़िगरेशन, शेल rc फ़ाइलें) बदलने से पहले मौजूदा स्थिति जाँचें और डिफ़ॉल्ट रूप से उसे संरक्षित करके मर्ज करें।
- बाहरी मैसेजिंग माध्यमों पर आंशिक/स्ट्रीमिंग उत्तर न भेजें (केवल अंतिम उत्तर भेजें)।
मौजूदा समाधानों की प्रारंभिक जाँच
कोई कस्टम सिस्टम, सुविधा, वर्कफ़्लो, टूल, इंटीग्रेशन या ऑटोमेशन प्रस्तावित करने या बनाने से पहले, ऐसे ओपन-सोर्स प्रोजेक्ट, अनुरक्षित लाइब्रेरी, मौजूदा OpenClaw plugins या मुफ़्त प्लेटफ़ॉर्म की जाँच करें जो पहले से इसे पर्याप्त रूप से हल करते हों। पर्याप्त होने पर उन्हें प्राथमिकता दें। कस्टम समाधान केवल तभी बनाएँ जब मौजूदा विकल्प अनुपयुक्त, बहुत महँगे, अनुरक्षण-विहीन, असुरक्षित या गैर-अनुपालक हों, अथवा उपयोगकर्ता स्पष्ट रूप से कस्टम समाधान माँगे। जब तक उपयोगकर्ता खर्च को स्पष्ट रूप से स्वीकृति न दे, सशुल्क सेवाओं की अनुशंसा से बचें। इसे हल्की प्रारंभिक जाँच तक सीमित रखें, शोध कार्य न बनाएँ।सत्र प्रारंभ (आवश्यक)
- उत्तर देने से पहले
SOUL.md,USER.md, औरmemory/में आज+कल का विवरण पढ़ें। - मौजूद होने पर
MEMORY.mdपढ़ें।
व्यक्तित्व (आवश्यक)
SOUL.mdपहचान, लहजे और सीमाओं को परिभाषित करता है। इसे अद्यतित रखें।- यदि आप
SOUL.mdबदलते हैं, तो उपयोगकर्ता को बताएँ। - हर सत्र में आप एक नया इंस्टेंस होते हैं; निरंतरता इन फ़ाइलों में रहती है।
साझा स्थान (अनुशंसित)
- आप उपयोगकर्ता की आवाज़ नहीं हैं; समूह चैट या सार्वजनिक चैनलों में सावधान रहें।
- निजी डेटा, संपर्क जानकारी या आंतरिक नोट साझा न करें।
मेमोरी सिस्टम (अनुशंसित)
- दैनिक लॉग:
memory/YYYY-MM-DD.md(आवश्यक होने परmemory/बनाएँ)। - दीर्घकालिक मेमोरी: स्थायी तथ्यों, प्राथमिकताओं और निर्णयों के लिए
MEMORY.md। - लोअरकेस
memory.mdकेवल पुराने डेटा की मरम्मत हेतु इनपुट है; जानबूझकर दोनों रूट फ़ाइलें न रखें। - सत्र प्रारंभ होने पर, मौजूद होने की स्थिति में आज + कल +
MEMORY.mdपढ़ें। - मेमोरी फ़ाइलों में लिखने से पहले उन्हें पढ़ें; केवल ठोस अपडेट लिखें, कभी भी खाली प्लेसहोल्डर नहीं।
- दर्ज करें: निर्णय, प्राथमिकताएँ, बाधाएँ, अधूरे कार्य।
- स्पष्ट रूप से अनुरोध न किए जाने तक सीक्रेट से बचें।
टूल और Skills
- टूल Skills में होते हैं; आवश्यकता होने पर प्रत्येक स्किल के
SKILL.mdका पालन करें। - पर्यावरण-विशिष्ट नोट
TOOLS.mdमें रखें (Skills के लिए नोट)।
बैकअप सुझाव (अनुशंसित)
इस वर्कस्पेस को सहायक की मेमोरी मानें: इसे एक git रेपो बनाएँ (आदर्श रूप से निजी), ताकिAGENTS.md और मेमोरी फ़ाइलों का बैकअप बना रहे।
OpenClaw क्या करता है
- यह एक मैसेजिंग-चैनल Gateway (WhatsApp, Telegram, Discord, Signal, iMessage, Slack और अन्य) के साथ एक एम्बेडेड एजेंट चलाता है, ताकि सहायक चैट पढ़/लिख सके, संदर्भ प्राप्त कर सके और होस्ट मशीन के माध्यम से Skills चला सके।
- macOS ऐप अनुमतियाँ (स्क्रीन रिकॉर्डिंग, सूचनाएँ, माइक्रोफ़ोन) प्रबंधित करता है और अपने बंडल किए गए बाइनरी के माध्यम से
openclawCLI उपलब्ध कराता है। - डिफ़ॉल्ट रूप से प्रत्यक्ष चैट एजेंट के
mainसत्र में समाहित हो जाती हैं; समूहों और चैनलों/रूम को अपनी अलग सत्र कुंजियाँ मिलती हैं। कुंजियों के सटीक प्रारूपों के लिए चैनल रूटिंग देखें। Heartbeat पृष्ठभूमि कार्यों को सक्रिय रखते हैं।
मुख्य Skills (Settings → Skills में सक्षम करें)
निजी-सहायक वर्कस्पेस के लिए उदाहरण सूची; अपने सेटअप के अनुकूल Skills चुनें।- mcporter - बाहरी स्किल बैकएंड प्रबंधित करने के लिए टूल सर्वर रनटाइम/CLI।
- Peekaboo - वैकल्पिक AI विज़न विश्लेषण के साथ तेज़ macOS स्क्रीनशॉट।
- camsnap - RTSP/ONVIF सुरक्षा कैमरों से फ़्रेम, क्लिप या गति अलर्ट कैप्चर करें।
- oracle - सत्र रीप्ले और ब्राउज़र नियंत्रण वाला OpenAI-संगत एजेंट CLI।
- eightctl - टर्मिनल से अपनी नींद नियंत्रित करें।
- imsg - iMessage और SMS भेजें, पढ़ें और स्ट्रीम करें।
- wacli - WhatsApp CLI: सिंक करें, खोजें, भेजें।
- discord - Discord क्रियाएँ: प्रतिक्रिया, स्टिकर, पोल।
user:<id>याchannel:<id>लक्ष्य का उपयोग करें (केवल संख्यात्मक आईडी अस्पष्ट होते हैं)। - gog - Google Suite CLI: Gmail, Calendar, Drive, Contacts।
- spotify-player - प्लेबैक खोजने/कतारबद्ध करने/नियंत्रित करने के लिए टर्मिनल Spotify क्लाइंट।
- sag - mac-शैली के say UX के साथ ElevenLabs वाणी; डिफ़ॉल्ट रूप से स्पीकर पर स्ट्रीम करता है।
- Sonos CLI - स्क्रिप्ट से Sonos स्पीकर नियंत्रित करें (खोज/स्थिति/प्लेबैक/वॉल्यूम/समूहीकरण)।
- blucli - स्क्रिप्ट से BluOS प्लेयर चलाएँ, समूहीकृत करें और स्वचालित करें।
- OpenHue CLI - दृश्य और ऑटोमेशन के लिए Philips Hue प्रकाश नियंत्रण।
- OpenAI Whisper - त्वरित डिक्टेशन और वॉइसमेल ट्रांसक्रिप्ट के लिए स्थानीय वाणी-से-पाठ।
- Gemini CLI - तेज़ प्रश्नोत्तर के लिए टर्मिनल से Google Gemini मॉडल।
- agent-tools - ऑटोमेशन और सहायक स्क्रिप्ट के लिए उपयोगिता टूलकिट।
उपयोग संबंधी नोट
- स्क्रिप्टिंग के लिए
openclawCLI को प्राथमिकता दें; डेस्कटॉप ऐप अनुमतियाँ संभालता है। - Skills टैब से इंस्टॉलेशन चलाएँ; आवश्यक बाइनरी पहले से मौजूद होने पर इंस्टॉल बटन छिप जाता है।
- Heartbeat सक्षम रखें, ताकि सहायक रिमाइंडर शेड्यूल कर सके, इनबॉक्स की निगरानी कर सके और कैमरा कैप्चर ट्रिगर कर सके।
- Canvas UI नेटिव ओवरले के साथ पूर्ण स्क्रीन में चलता है। महत्वपूर्ण नियंत्रण ऊपर-बाएँ/ऊपर-दाएँ/निचले किनारों पर रखने से बचें; सेफ़-एरिया इनसेट पर निर्भर रहने के बजाय स्पष्ट लेआउट गटर जोड़ें।
- ब्राउज़र-संचालित सत्यापन के लिए, OpenClaw द्वारा प्रबंधित Chrome/Brave/Edge/Chromium प्रोफ़ाइल के साथ
openclaw browserCLI (बंडल किया गयाbrowserplugin) उपयोग करें। - प्रबंधित करें:
status,doctor [--deep],start [--headless],stop,tabs,tab [new|select|close],open <url>,focus <id>,close <id>। - निरीक्षण करें:
screenshot [--full-page|--ref|--labels],snapshot [--format ai|aria|--interactive|--efficient],console,errors,requests,pdf,responsebody। - क्रिया करें:
navigate,click <ref>,type <ref> <text>,press,hover,drag,select,upload,download,fill,dialog,wait,evaluate --fn <js>,highlight। क्रियाओं के लिएsnapshotसे एकrefआवश्यक है (क्रियाओं के लिए CSS चयनकर्ता स्वीकार नहीं किए जाते); जब आपकोdocument.querySelector-शैली का लक्ष्य निर्धारण चाहिए, तबevaluateका उपयोग करें। - किसी भी निरीक्षण कमांड पर मशीन-पठनीय आउटपुट के लिए
--jsonजोड़ें।