डिफ़ॉल्ट AGENTS.md

पहली बार चलाना (अनुशंसित)

OpenClaw एजेंट एक वर्कस्पेस डायरेक्टरी का उपयोग करते हैं। डिफ़ॉल्ट: ~/.openclaw/workspace (agents.defaults.workspace के माध्यम से कॉन्फ़िगर करने योग्य, ~ समर्थित है)।

1. वर्कस्पेस बनाएँ:

mkdir -p ~/.openclaw/workspace

2. डिफ़ॉल्ट वर्कस्पेस टेम्प्लेट इसमें कॉपी करें:

cp docs/reference/templates/AGENTS.md ~/.openclaw/workspace/AGENTS.mdcp docs/reference/templates/SOUL.md ~/.openclaw/workspace/SOUL.mdcp docs/reference/templates/TOOLS.md ~/.openclaw/workspace/TOOLS.md

3. वैकल्पिक: सामान्य टेम्प्लेट के बजाय इस फ़ाइल की निजी-सहायक Skills सूची का उपयोग करें:

cp docs/reference/AGENTS.default.md ~/.openclaw/workspace/AGENTS.md

4. वैकल्पिक: किसी अन्य वर्कस्पेस की ओर इंगित करें:

{  agents: { defaults: { workspace: "~/.openclaw/workspace" } },}

डिफ़ॉल्ट सुरक्षा सेटिंग्स

• डायरेक्टरी की सामग्री या गोपनीय जानकारी चैट में न डालें।
• स्पष्ट रूप से कहे जाने तक विनाशकारी कमांड न चलाएँ।
• कॉन्फ़िगरेशन या शेड्यूलर (crontab, systemd यूनिट, nginx कॉन्फ़िगरेशन, shell 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 के SKILL.md का पालन करें।
• पर्यावरण-विशिष्ट नोट्स TOOLS.md में रखें (Skills के लिए नोट्स)।

बैकअप सुझाव (अनुशंसित)

इस वर्कस्पेस को सहायक की मेमोरी मानें: इसे एक git रेपो बनाएँ (आदर्श रूप से निजी), ताकि AGENTS.md और मेमोरी फ़ाइलों का बैकअप रहे।

cd ~/.openclaw/workspacegit initgit add AGENTS.mdgit commit -m "वर्कस्पेस जोड़ें"# वैकल्पिक: एक निजी रिमोट जोड़ें + पुश करें

OpenClaw क्या करता है

• यह एक मैसेजिंग-चैनल Gateway (WhatsApp, Telegram, Discord, Signal, iMessage, Slack आदि) और एक अंतर्निहित एजेंट चलाता है, ताकि सहायक चैट पढ़/लिख सके, संदर्भ प्राप्त कर सके और होस्ट मशीन के माध्यम से Skills चला सके।
• macOS ऐप अनुमतियाँ (स्क्रीन रिकॉर्डिंग, सूचनाएँ, माइक्रोफ़ोन) प्रबंधित करता है और अपने साथ शामिल बाइनरी के माध्यम से openclaw CLI उपलब्ध कराता है।
• डिफ़ॉल्ट रूप से सीधी चैट एजेंट के main सत्र में समाहित हो जाती हैं; समूहों और चैनलों/रूम को अपनी अलग सत्र कुंजियाँ मिलती हैं। कुंजियों के सटीक प्रारूप के लिए चैनल रूटिंग देखें। Heartbeat पृष्ठभूमि कार्यों को सक्रिय रखते हैं।

मुख्य Skills (Settings → Skills में सक्षम करें)

निजी-सहायक वर्कस्पेस के लिए उदाहरण सूची; अपने सेटअप के अनुकूल Skills चुनें।

• mcporter - बाहरी Skill बैकएंड प्रबंधित करने के लिए टूल सर्वर रनटाइम/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 - macOS-जैसे say अनुभव के साथ ElevenLabs वाणी; डिफ़ॉल्ट रूप से स्पीकर पर स्ट्रीम करता है।
• Sonos CLI - स्क्रिप्ट से Sonos स्पीकर नियंत्रित करें (खोज/स्थिति/प्लेबैक/वॉल्यूम/समूहीकरण)।
• blucli - स्क्रिप्ट से BluOS प्लेयर चलाएँ, समूहित करें और स्वचालित करें।
• OpenHue CLI - दृश्यों और ऑटोमेशन के लिए Philips Hue प्रकाश नियंत्रण।
• OpenAI Whisper - त्वरित श्रुतलेखन और वॉइसमेल प्रतिलेखों के लिए स्थानीय वाणी-से-पाठ।
• Gemini CLI - तेज़ प्रश्नोत्तर के लिए टर्मिनल से Google Gemini मॉडल।
• agent-tools - ऑटोमेशन और सहायक स्क्रिप्ट के लिए उपयोगिता टूलकिट।

उपयोग संबंधी नोट्स

• स्क्रिप्टिंग के लिए openclaw CLI को प्राथमिकता दें; डेस्कटॉप ऐप अनुमतियाँ संभालता है।
• इंस्टॉलेशन Skills टैब से चलाएँ; आवश्यक बाइनरी पहले से मौजूद होने पर इंस्टॉल बटन छिप जाता है।
• Heartbeat सक्षम रखें, ताकि सहायक रिमाइंडर शेड्यूल कर सके, इनबॉक्स की निगरानी कर सके और कैमरा कैप्चर ट्रिगर कर सके।
• Canvas UI मूल ओवरले के साथ फ़ुल-स्क्रीन चलता है। महत्वपूर्ण नियंत्रणों को ऊपर-बाएँ/ऊपर-दाएँ/नीचे के किनारों पर रखने से बचें; सुरक्षित-क्षेत्र इनसेट पर निर्भर रहने के बजाय स्पष्ट लेआउट गटर जोड़ें।
• ब्राउज़र-आधारित सत्यापन के लिए OpenClaw द्वारा प्रबंधित Chrome/Brave/Edge/Chromium प्रोफ़ाइल के साथ openclaw browser CLI (साथ में शामिल browser plugin) का उपयोग करें।
• प्रबंधित करें: 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 जोड़ें।

संबंधित

• एजेंट वर्कस्पेस
• एजेंट रनटाइम
• चैनल रूटिंग