​

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

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

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",
  },
}

{ agent: { skipBootstrap: true } }

​

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

42. पुराने इंस्टॉल्स ने ~/openclaw बनाया हो सकता है। 43. कई workspace डायरेक्टरीज़ रखना भ्रमित करने वाला auth या state drift पैदा कर सकता है, क्योंकि एक समय में केवल एक workspace सक्रिय होता है।
43. Recommendation: एक ही सक्रिय workspace रखें। 45. यदि आप अतिरिक्त फ़ोल्डर्स का अब उपयोग नहीं करते, तो उन्हें आर्काइव करें या Trash में ले जाएँ (उदाहरण के लिए trash ~/openclaw)।
44. यदि आप जानबूझकर कई workspaces रखते हैं, तो सुनिश्चित करें कि agents.defaults.workspace सक्रिय वाले की ओर इशारा करता हो।

​

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

• AGENTS.md
  • एजेंट के लिए परिचालन निर्देश और वह स्मृति का उपयोग कैसे करे।
  • हर सत्र की शुरुआत में लोड होती है।
  • नियमों, प्राथमिकताओं और “कैसे व्यवहार करना है” जैसे विवरणों के लिए उपयुक्त स्थान।
• SOUL.md
  • व्यक्तित्व, टोन और सीमाएँ।
  • हर सत्र में लोड होती है।
• USER.md
  • उपयोगकर्ता कौन है और उसे कैसे संबोधित करना है।
  • हर सत्र में लोड होती है।
• IDENTITY.md
  • एजेंट का नाम, वाइब और इमोजी।
  • बूटस्ट्रैप रिचुअल के दौरान बनाई/अपडेट की जाती है।
• TOOLS.md
  • आपके स्थानीय टूल्स और परंपराओं के बारे में नोट्स।
  • टूल उपलब्धता को नियंत्रित नहीं करती; यह केवल मार्गदर्शन है।
• HEARTBEAT.md
  • हार्टबीट रन के लिए वैकल्पिक छोटा चेकलिस्ट।
  • टोकन खर्च से बचने के लिए इसे संक्षिप्त रखें।
• BOOT.md
  • आंतरिक हुक सक्षम होने पर Gateway रीस्टार्ट के समय निष्पादित होने वाली वैकल्पिक स्टार्टअप चेकलिस्ट।
  • इसे संक्षिप्त रखें; आउटबाउंड भेजों के लिए संदेश टूल का उपयोग करें।
• BOOTSTRAP.md
  • एक‑बार का प्रथम‑रन रिचुअल।
  • केवल बिल्कुल नए वर्कस्पेस के लिए बनाई जाती है।
  • रिचुअल पूरा होने के बाद इसे हटा दें।
• memory/YYYY-MM-DD.md
  • दैनिक स्मृति लॉग (प्रति दिन एक फ़ाइल)।
  • सत्र आरंभ पर आज + कल पढ़ने की अनुशंसा।
• MEMORY.md (वैकल्पिक)
  • क्यूरेटेड दीर्घकालिक स्मृति।
  • केवल मुख्य, निजी सत्र में लोड करें (साझा/समूह संदर्भों में नहीं)।

• skills/ (वैकल्पिक)
  • वर्कस्पेस‑विशिष्ट Skills।
  • नाम टकराने पर प्रबंधित/बंडल किए गए Skills को ओवरराइड करती हैं।
• openclaw setup मौजूदा फ़ाइलों को ओवरराइट किए बिना गायब डिफ़ॉल्ट्स को फिर से बना सकता है।
  • नोड डिस्प्ले के लिए Canvas UI फ़ाइलें (उदाहरण के लिए canvas/index.html)।

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

​

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

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

​

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

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

​

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. एक निजी रिमोट जोड़ें (शुरुआती‑अनुकूल विकल्प)

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

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

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

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/ के अंतर्गत कुछ भी।
• चैट्स या संवेदनशील अटैचमेंट्स के कच्चे डंप।

.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 वर्कस्पेस का उपयोग कर सकते हैं।