एजेंट वर्कस्पेस¶

35. workspace एजेंट का घर है। 36. यह फ़ाइल टूल्स और workspace context के लिए उपयोग की जाने वाली एकमात्र working directory है। 37. इसे निजी रखें और मेमोरी की तरह मानें।

यह ~/.openclaw/ से अलग है, जो विन्यास, क्रेडेंशियल्स और सत्रों को संग्रहीत करता है।

38. Important: workspace डिफ़ॉल्ट cwd है, कोई हार्ड सैंडबॉक्स नहीं। 39. टूल्स relative paths को workspace के विरुद्ध resolve करते हैं, लेकिन absolute paths सैंडबॉक्सिंग सक्षम न होने पर होस्ट के अन्य हिस्सों तक पहुँच सकते हैं। 40. यदि आपको आइसोलेशन चाहिए, तो agents.defaults.sandbox (और/या प्रति-एजेंट सैंडबॉक्स कॉन्फ़िग) का उपयोग करें।
39. जब सैंडबॉक्सिंग सक्षम हो और workspaceAccess "rw" न हो, तो टूल्स ~/.openclaw/sandboxes के अंतर्गत सैंडबॉक्स workspace में काम करते हैं, न कि आपके होस्ट workspace में।

डिफ़ॉल्ट स्थान¶

• डिफ़ॉल्ट: ~/.openclaw/workspace
• यदि OPENCLAW_PROFILE सेट है और "default" नहीं है, तो डिफ़ॉल्ट बदलकर ~/.openclaw/workspace-<profile> हो जाता है।
• ~/.openclaw/openclaw.json में ओवरराइड करें:

{
  agent: {
    workspace: "~/.openclaw/workspace",
  },
}

openclaw onboard, openclaw configure, या openclaw setup वर्कस्पेस बनाएँगे और यदि बूटस्ट्रैप फ़ाइलें अनुपस्थित हों तो उन्हें सीड करेंगे।

यदि आप पहले से वर्कस्पेस फ़ाइलों का स्वयं प्रबंधन करते हैं, तो आप बूटस्ट्रैप फ़ाइल निर्माण अक्षम कर सकते हैं:

{ agent: { skipBootstrap: true } }

अतिरिक्त वर्कस्पेस फ़ोल्डर¶

42. पुराने इंस्टॉल्स ने ~/openclaw बनाया हो सकता है। 43. कई workspace डायरेक्टरीज़ रखना भ्रमित करने वाला auth या state drift पैदा कर सकता है, क्योंकि एक समय में केवल एक workspace सक्रिय होता है।

43. Recommendation: एक ही सक्रिय workspace रखें। 45. यदि आप अतिरिक्त फ़ोल्डर्स का अब उपयोग नहीं करते, तो उन्हें आर्काइव करें या Trash में ले जाएँ (उदाहरण के लिए trash ~/openclaw)।

44. यदि आप जानबूझकर कई workspaces रखते हैं, तो सुनिश्चित करें कि agents.defaults.workspace सक्रिय वाले की ओर इशारा करता हो।

openclaw doctor अतिरिक्त वर्कस्पेस निर्देशिकाएँ मिलने पर चेतावनी देता है।

वर्कस्पेस फ़ाइल मानचित्र (प्रत्येक फ़ाइल का अर्थ)¶

ये वे मानक फ़ाइलें हैं जिनकी OpenClaw वर्कस्पेस के भीतर अपेक्षा करता है:

• AGENTS.md
• एजेंट के लिए परिचालन निर्देश और वह स्मृति का उपयोग कैसे करे।
• हर सत्र की शुरुआत में लोड होती है।

• नियमों, प्राथमिकताओं और “कैसे व्यवहार करना है” जैसे विवरणों के लिए उपयुक्त स्थान।

• SOUL.md

• व्यक्तित्व, टोन और सीमाएँ।

• हर सत्र में लोड होती है।

• USER.md

• उपयोगकर्ता कौन है और उसे कैसे संबोधित करना है।

• हर सत्र में लोड होती है।

• IDENTITY.md

• एजेंट का नाम, वाइब और इमोजी।

• बूटस्ट्रैप रिचुअल के दौरान बनाई/अपडेट की जाती है।

• TOOLS.md

• आपके स्थानीय टूल्स और परंपराओं के बारे में नोट्स।

• टूल उपलब्धता को नियंत्रित नहीं करती; यह केवल मार्गदर्शन है।

• HEARTBEAT.md

• हार्टबीट रन के लिए वैकल्पिक छोटा चेकलिस्ट।

• टोकन खर्च से बचने के लिए इसे संक्षिप्त रखें।

• BOOT.md

• आंतरिक हुक सक्षम होने पर Gateway रीस्टार्ट के समय निष्पादित होने वाली वैकल्पिक स्टार्टअप चेकलिस्ट।

• इसे संक्षिप्त रखें; आउटबाउंड भेजों के लिए संदेश टूल का उपयोग करें।

• BOOTSTRAP.md

• एक‑बार का प्रथम‑रन रिचुअल।
• केवल बिल्कुल नए वर्कस्पेस के लिए बनाई जाती है।

• रिचुअल पूरा होने के बाद इसे हटा दें।

• memory/YYYY-MM-DD.md

• दैनिक स्मृति लॉग (प्रति दिन एक फ़ाइल)।

• सत्र आरंभ पर आज + कल पढ़ने की अनुशंसा।

• MEMORY.md (वैकल्पिक)

• क्यूरेटेड दीर्घकालिक स्मृति।
• केवल मुख्य, निजी सत्र में लोड करें (साझा/समूह संदर्भों में नहीं)।

वर्कफ़्लो और स्वचालित मेमोरी फ़्लश के लिए Memory देखें।

• skills/ (वैकल्पिक)
• वर्कस्पेस‑विशिष्ट Skills।

• नाम टकराने पर प्रबंधित/बंडल किए गए Skills को ओवरराइड करती हैं।

• canvas/ (वैकल्पिक)

• नोड डिस्प्ले के लिए Canvas UI फ़ाइलें (उदाहरण के लिए canvas/index.html)।

47. यदि कोई bootstrap फ़ाइल गायब है, तो OpenClaw सेशन में एक "missing file" मार्कर इंजेक्ट करता है और जारी रखता है। 48. बड़े bootstrap फ़ाइलें इंजेक्ट करते समय ट्रंकेट कर दी जाती हैं; सीमा agents.defaults.bootstrapMaxChars (डिफ़ॉल्ट: 20000) से समायोजित करें।
48. openclaw setup मौजूदा फ़ाइलों को ओवरराइट किए बिना गायब डिफ़ॉल्ट्स को फिर से बना सकता है।

वर्कस्पेस में क्या शामिल नहीं है¶

ये ~/.openclaw/ के अंतर्गत रहते हैं और वर्कस्पेस रिपॉज़िटरी में कमिट नहीं किए जाने चाहिए:

• ~/.openclaw/openclaw.json (विन्यास)
• ~/.openclaw/credentials/ (OAuth टोकन, एपीआई कुंजियाँ)
• ~/.openclaw/agents/<agentId>/sessions/ (सत्र प्रतिलिपियाँ + मेटाडेटा)
• ~/.openclaw/skills/ (प्रबंधित Skills)

यदि आपको सत्रों या विन्यास को माइग्रेट करना हो, तो उन्हें अलग से कॉपी करें और संस्करण नियंत्रण से बाहर रखें।

Git बैकअप (अनुशंसित, निजी)¶

50. workspace को निजी मेमोरी की तरह मानें। 1. इसे एक private git repo में रखें ताकि यह backed up रहे और recover किया जा सके।

ये चरण उस मशीन पर चलाएँ जहाँ Gateway चलता है (वहीं वर्कस्पेस रहता है)।

1. रिपॉज़िटरी प्रारंभ करें¶

2. यदि git इंस्टॉल है, तो बिल्कुल नए workspaces अपने-आप initialize हो जाते हैं। 3. यदि यह workspace पहले से repo नहीं है, तो चलाएँ:

cd ~/.openclaw/workspace
git init
git add AGENTS.md SOUL.md TOOLS.md IDENTITY.md USER.md HEARTBEAT.md memory/
git commit -m "Add agent workspace"

2. एक निजी रिमोट जोड़ें (शुरुआती‑अनुकूल विकल्प)¶

विकल्प A: GitHub वेब UI

1. GitHub पर एक नई निजी रिपॉज़िटरी बनाएँ।
2. README के साथ इनिशियलाइज़ न करें (मर्ज संघर्षों से बचने के लिए)।
3. HTTPS रिमोट URL कॉपी करें।
4. रिमोट जोड़ें और पुश करें:

git branch -M main
git remote add origin <https-url>
git push -u origin main

विकल्प B: GitHub CLI (gh)

gh auth login
gh repo create openclaw-workspace --private --source . --remote origin --push

विकल्प C: GitLab वेब UI

1. GitLab पर एक नई निजी रिपॉज़िटरी बनाएँ।
2. README के साथ इनिशियलाइज़ न करें (मर्ज संघर्षों से बचने के लिए)।
3. HTTPS रिमोट URL कॉपी करें।
4. रिमोट जोड़ें और पुश करें:

git branch -M main
git remote add origin <https-url>
git push -u origin main

3. सतत अपडेट्स¶

git status
git add .
git commit -m "Update memory"
git push

सीक्रेट्स कमिट न करें¶

निजी रिपॉज़िटरी में भी, वर्कस्पेस में सीक्रेट्स संग्रहीत करने से बचें:

• एपीआई कुंजियाँ, OAuth टोकन, पासवर्ड, या निजी क्रेडेंशियल्स।
• ~/.openclaw/ के अंतर्गत कुछ भी।
• चैट्स या संवेदनशील अटैचमेंट्स के कच्चे डंप।

यदि आपको संवेदनशील संदर्भ रखने ही हों, तो प्लेसहोल्डर का उपयोग करें और वास्तविक सीक्रेट कहीं और रखें (पासवर्ड मैनेजर, पर्यावरण चर, या ~/.openclaw/)।

अनुशंसित .gitignore स्टार्टर:

.DS_Store
.env
**/*.key
**/*.pem
**/secrets*

वर्कस्पेस को नई मशीन पर ले जाना¶

1. वांछित पथ पर रिपॉज़िटरी क्लोन करें (डिफ़ॉल्ट ~/.openclaw/workspace)।
2. ~/.openclaw/openclaw.json में agents.defaults.workspace को उस पथ पर सेट करें।
3. अनुपस्थित फ़ाइलों को सीड करने के लिए openclaw setup --workspace <path> चलाएँ।
4. यदि आपको सत्रों की आवश्यकता हो, तो ~/.openclaw/agents/<agentId>/sessions/ को पुरानी मशीन से अलग से कॉपी करें।

उन्नत नोट्स¶

• 4. Multi-agent routing हर agent के लिए अलग-अलग workspaces का उपयोग कर सकता है। 5. Routing configuration के लिए देखें Channel routing।
• यदि agents.defaults.sandbox सक्षम है, तो गैर‑मुख्य सत्र agents.defaults.sandbox.workspaceRoot के अंतर्गत प्रति‑सत्र sandbox वर्कस्पेस का उपयोग कर सकते हैं।