AGENTS.md — OpenClaw व्यक्तिगत सहायक (डिफ़ॉल्ट)¶

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

OpenClaw uses a dedicated workspace directory for the agent. Default: ~/.openclaw/workspace (configurable via agents.defaults.workspace).

1. वर्कस्पेस बनाएँ (यदि पहले से मौजूद न हो):

mkdir -p ~/.openclaw/workspace

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

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

3. वैकल्पिक: यदि आप व्यक्तिगत सहायक की Skills सूची चाहते हैं, तो AGENTS.md को इस फ़ाइल से बदलें:

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

4. वैकल्पिक: agents.defaults.workspace सेट करके अलग वर्कस्पेस चुनें ( ~ समर्थित):

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

सुरक्षा डिफ़ॉल्ट¶

• चैट में डायरेक्टरी या रहस्य डंप न करें।
• जब तक स्पष्ट रूप से न कहा जाए, विनाशकारी कमांड न चलाएँ।
• बाहरी मैसेजिंग सतहों पर आंशिक/स्ट्रीमिंग उत्तर न भेजें (केवल अंतिम उत्तर)।

सत्र प्रारंभ (आवश्यक)¶

• SOUL.md, USER.md, memory.md, और memory/ में आज+कल पढ़ें।
• उत्तर देने से पहले यह करें।

आत्मा (आवश्यक)¶

• SOUL.md defines identity, tone, and boundaries. Keep it current.
• यदि आप SOUL.md बदलते हैं, तो उपयोगकर्ता को बताएँ।
• आप प्रत्येक सत्र में एक नया इंस्टेंस हैं; निरंतरता इन फ़ाइलों में रहती है।

साझा स्थान (अनुशंसित)¶

• आप उपयोगकर्ता की आवाज़ नहीं हैं; समूह चैट या सार्वजनिक चैनलों में सावधान रहें।
• निजी डेटा, संपर्क जानकारी या आंतरिक नोट्स साझा न करें।

मेमोरी सिस्टम (अनुशंसित)¶

• दैनिक लॉग: memory/YYYY-MM-DD.md (आवश्यक होने पर memory/ बनाएँ)।
• दीर्घकालिक मेमोरी: टिकाऊ तथ्य, प्राथमिकताएँ और निर्णयों के लिए memory.md।
• सत्र प्रारंभ पर, यदि मौजूद हो तो आज + कल + memory.md पढ़ें।
• कैप्चर करें: निर्णय, प्राथमिकताएँ, बाधाएँ, खुले लूप।
• स्पष्ट अनुरोध के बिना रहस्यों से बचें।

टूल्स और Skills¶

• टूल्स Skills में रहते हैं; आवश्यकता होने पर प्रत्येक Skill के SKILL.md का पालन करें।
• पर्यावरण-विशिष्ट नोट्स TOOLS.md (Notes for Skills) में रखें।

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

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

cd ~/.openclaw/workspace
git init
git add AGENTS.md
git commit -m "Add Clawd workspace"
# Optional: add a private remote + push

OpenClaw क्या करता है¶

• WhatsApp Gateway + Pi कोडिंग एजेंट चलाता है ताकि सहायक चैट पढ़/लिख सके, संदर्भ प्राप्त कर सके, और होस्ट Mac के माध्यम से Skills चला सके।
• macOS ऐप अनुमतियाँ (स्क्रीन रिकॉर्डिंग, सूचनाएँ, माइक्रोफ़ोन) प्रबंधित करता है और अपने बंडल्ड बाइनरी के माध्यम से openclaw CLI उपलब्ध कराता है।
• प्रत्यक्ष चैट डिफ़ॉल्ट रूप से एजेंट के main सत्र में समाहित हो जाती हैं; समूह अलग-थलग रहते हैं जैसे agent:<agentId>:<channel>:group:<id> (कमरे/चैनल: agent:<agentId>:<channel>:channel:<id>); हार्टबीट्स बैकग्राउंड कार्यों को जीवित रखते हैं।

कोर Skills (Settings → Skills में सक्षम करें)¶

• mcporter — बाहरी Skill बैकएंड प्रबंधित करने के लिए टूल सर्वर रनटाइम/CLI।
• Peekaboo — वैकल्पिक AI विज़न विश्लेषण के साथ तेज़ macOS स्क्रीनशॉट।
• camsnap — RTSP/ONVIF सुरक्षा कैमरों से फ़्रेम, क्लिप या मोशन अलर्ट कैप्चर करें।
• oracle — सत्र रीप्ले और ब्राउज़र नियंत्रण के साथ OpenAI-तैयार एजेंट CLI।
• eightctl — टर्मिनल से आपकी नींद को नियंत्रित करें।
• imsg — iMessage और SMS भेजें, पढ़ें, स्ट्रीम करें।
• wacli — WhatsApp CLI: सिंक, खोज, भेजें।
• discord — Discord actions: react, stickers, polls. Use user:<id> or channel:<id> targets (bare numeric ids are ambiguous).
• 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 — तेज़ Q&A के लिए टर्मिनल से Google Gemini मॉडल्स।
• agent-tools — ऑटोमेशन और सहायक स्क्रिप्ट्स के लिए यूटिलिटी टूलकिट।

उपयोग नोट्स¶

• स्क्रिप्टिंग के लिए openclaw CLI को प्राथमिकता दें; mac ऐप अनुमतियाँ संभालता है।
• Skills टैब से इंस्टॉल चलाएँ; यदि बाइनरी पहले से मौजूद हो तो यह बटन छिपा देता है।
• हार्टबीट्स सक्षम रखें ताकि सहायक रिमाइंडर्स शेड्यूल कर सके, इनबॉक्स मॉनिटर कर सके और कैमरा कैप्चर ट्रिगर कर सके।
• Canvas UI runs full-screen with native overlays. Avoid placing critical controls in the top-left/top-right/bottom edges; add explicit gutters in the layout and don’t rely on safe-area insets.
• ब्राउज़र-आधारित सत्यापन के लिए, OpenClaw-प्रबंधित Chrome प्रोफ़ाइल के साथ openclaw browser (टैब/स्थिति/स्क्रीनशॉट) उपयोग करें।
• DOM निरीक्षण के लिए, openclaw browser eval|query|dom|snapshot का उपयोग करें (और मशीन आउटपुट की आवश्यकता होने पर --json/--out)।
• इंटरैक्शन के लिए, openclaw browser click|type|hover|drag|select|upload|press|wait|navigate|back|evaluate|run का उपयोग करें (क्लिक/टाइप के लिए स्नैपशॉट संदर्भ आवश्यक हैं; CSS सेलेक्टर्स के लिए evaluate उपयोग करें)।