मुख्य सामग्री पर जाएं
कार्यक्षेत्र एजेंट का घर है। यह फ़ाइल टूल्स और कार्यक्षेत्र संदर्भ के लिए उपयोग की जाने वाली एकमात्र कार्यशील डायरेक्टरी है। इसे निजी रखें और इसे मेमोरी की तरह मानें। यह ~/.openclaw/ से अलग है, जहाँ config, credentials, और sessions संग्रहीत होते हैं।
कार्यक्षेत्र डिफ़ॉल्ट cwd है, कोई कठोर sandbox नहीं। टूल्स सापेक्ष पाथ को कार्यक्षेत्र के विरुद्ध resolve करते हैं, लेकिन यदि sandboxing सक्षम नहीं है तो absolute paths अभी भी host पर कहीं और पहुँच सकते हैं। यदि आपको isolation चाहिए, तो agents.defaults.sandbox (और/या प्रति-एजेंट sandbox config) का उपयोग करें।जब sandboxing सक्षम हो और workspaceAccess "rw" नहीं हो, तो टूल्स आपके host कार्यक्षेत्र में नहीं, बल्कि ~/.openclaw/sandboxes के अंतर्गत sandbox कार्यक्षेत्र के अंदर काम करते हैं।

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

  • डिफ़ॉल्ट: ~/.openclaw/workspace
  • यदि OPENCLAW_PROFILE सेट है और "default" नहीं है, तो डिफ़ॉल्ट ~/.openclaw/workspace-<profile> बन जाता है।
  • ~/.openclaw/openclaw.json में override करें:
{
  agents: {
    defaults: {
      workspace: "~/.openclaw/workspace",
    },
  },
}
openclaw onboard, openclaw configure, या openclaw setup कार्यक्षेत्र बनाएँगे और यदि bootstrap फ़ाइलें अनुपस्थित हैं तो उन्हें seed करेंगे।
Sandbox seed copies केवल नियमित in-workspace फ़ाइलें स्वीकार करती हैं; source workspace के बाहर resolve होने वाले symlink/hardlink aliases अनदेखा कर दिए जाते हैं।
यदि आप पहले से ही कार्यक्षेत्र फ़ाइलें स्वयं manage करते हैं, तो आप bootstrap फ़ाइल निर्माण अक्षम कर सकते हैं: 
{ agents: { defaults: { skipBootstrap: true } } }

​
अतिरिक्त कार्यक्षेत्र फ़ोल्डर

पुराने installs ने ~/openclaw बनाया हो सकता है। कई कार्यक्षेत्र डायरेक्टरी रखना भ्रमित करने वाला auth या state drift पैदा कर सकता है, क्योंकि एक समय में केवल एक कार्यक्षेत्र active होता है।
सिफ़ारिश: एक ही active कार्यक्षेत्र रखें। यदि अब आप अतिरिक्त फ़ोल्डर उपयोग नहीं करते, तो उन्हें archive करें या Trash में ले जाएँ (उदाहरण के लिए trash ~/openclaw)। यदि आप जानबूझकर कई कार्यक्षेत्र रखते हैं, तो सुनिश्चित करें कि agents.defaults.workspace active वाले की ओर point करता है।openclaw doctor अतिरिक्त कार्यक्षेत्र डायरेक्टरी detect करने पर चेतावनी देता है।

​
कार्यक्षेत्र फ़ाइल मानचित्र

ये वे मानक फ़ाइलें हैं जिनकी OpenClaw कार्यक्षेत्र के अंदर अपेक्षा करता है:
एजेंट के लिए संचालन निर्देश और उसे मेमोरी का उपयोग कैसे करना चाहिए। हर session की शुरुआत में loaded होता है। नियमों, प्राथमिकताओं, और “कैसे व्यवहार करें” विवरणों के लिए अच्छी जगह।
Persona, tone, और boundaries। हर session में loaded होता है। Guide: SOUL.md personality guide.
User कौन है और उन्हें कैसे address करना है। हर session में loaded होता है।
एजेंट का name, vibe, और emoji। bootstrap ritual के दौरान बनाया/अपडेट किया जाता है।
आपके स्थानीय tools और conventions के बारे में notes। यह tool availability नियंत्रित नहीं करता; यह केवल guidance है।
Heartbeat runs के लिए वैकल्पिक छोटी checklist। token burn से बचने के लिए इसे छोटा रखें।
वैकल्पिक startup checklist जो gateway restart पर automatic चलती है (जब internal hooks सक्षम हों)। इसे छोटा रखें; outbound sends के लिए message tool का उपयोग करें।
एक बार चलने वाला first-run ritual। केवल बिल्कुल नए कार्यक्षेत्र के लिए बनाया जाता है। ritual पूरा होने के बाद इसे delete कर दें।
दैनिक मेमोरी log (प्रति दिन एक फ़ाइल)। session start पर today + yesterday पढ़ने की सिफ़ारिश की जाती है।
Curated long-term memory: durable facts, preferences, decisions, और short summaries। विस्तृत logs memory/YYYY-MM-DD.md में रखें ताकि memory tools उन्हें हर prompt में inject किए बिना on demand retrieve कर सकें। MEMORY.md को केवल main, private session में load करें (shared/group contexts में नहीं)। workflow और automatic memory flush के लिए Memory देखें।
कार्यक्षेत्र-विशिष्ट Skills। उस कार्यक्षेत्र के लिए सबसे उच्च-precedence skill location। names collide होने पर project agent skills, personal agent skills, managed skills, bundled skills, और skills.load.extraDirs को override करता है।
node displays के लिए Canvas UI files (उदाहरण के लिए canvas/index.html)।
यदि कोई bootstrap फ़ाइल अनुपस्थित है, तो OpenClaw session में “missing file” marker inject करता है और जारी रखता है। बड़ी bootstrap फ़ाइलें inject करते समय truncate की जाती हैं; limits को agents.defaults.bootstrapMaxChars (डिफ़ॉल्ट: 20000) और agents.defaults.bootstrapTotalMaxChars (डिफ़ॉल्ट: 60000) से adjust करें। openclaw setup मौजूदा फ़ाइलों को overwrite किए बिना missing defaults फिर से बना सकता है।

​
कार्यक्षेत्र में क्या नहीं है

ये ~/.openclaw/ के अंतर्गत रहते हैं और कार्यक्षेत्र repo में commit नहीं किए जाने चाहिए:
  • ~/.openclaw/openclaw.json (config)
  • ~/.openclaw/agents/<agentId>/agent/auth-profiles.json (model auth profiles: OAuth + API keys)
  • ~/.openclaw/agents/<agentId>/agent/codex-home/ (per-agent Codex runtime account, config, skills, plugins, और native thread state)
  • ~/.openclaw/credentials/ (channel/provider state plus legacy OAuth import data)
  • ~/.openclaw/agents/<agentId>/sessions/ (session transcripts + metadata)
  • ~/.openclaw/skills/ (managed skills)
यदि आपको sessions या config migrate करने हैं, तो उन्हें अलग से copy करें और version control से बाहर रखें।

​
Git backup (सिफ़ारिश की गई, निजी)

कार्यक्षेत्र को निजी मेमोरी की तरह मानें। इसे private git repo में रखें ताकि इसका backup हो और यह recoverable रहे। इन steps को उस machine पर run करें जहाँ Gateway चलता है (वही जगह है जहाँ कार्यक्षेत्र रहता है)।
1

Repo initialize करें

यदि git installed है, तो बिल्कुल नए कार्यक्षेत्र automatic initialize होते हैं। यदि यह कार्यक्षेत्र पहले से repo नहीं है, तो run करें:
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

Private remote जोड़ें

  1. GitHub पर एक नया private repository बनाएँ।
  2. README से initialize न करें (merge conflicts से बचता है)।
  3. HTTPS remote URL copy करें।
  4. remote add करें और push करें:
git branch -M main
git remote add origin <https-url>
git push -u origin main
3

लगातार updates

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

​
Secrets commit न करें

Private repo में भी, कार्यक्षेत्र में secrets store करने से बचें:
  • API keys, OAuth tokens, passwords, या private credentials.
  • ~/.openclaw/ के अंतर्गत कुछ भी।
  • chats या sensitive attachments के raw dumps।
यदि आपको sensitive references store करने ही हों, तो placeholders का उपयोग करें और real secret कहीं और रखें (password manager, environment variables, या ~/.openclaw/)।
Suggested .gitignore starter: 
.DS_Store
.env
**/*.key
**/*.pem
**/secrets*

​
कार्यक्षेत्र को नई machine पर ले जाना

1

Repo clone करें

Repo को desired path पर clone करें (डिफ़ॉल्ट ~/.openclaw/workspace)।
2

Config update करें

~/.openclaw/openclaw.json में agents.defaults.workspace को उस path पर set करें।
3

Missing files seed करें

किसी भी missing files को seed करने के लिए openclaw setup --workspace <path> run करें।
4

Sessions copy करें (वैकल्पिक)

यदि आपको sessions चाहिए, तो old machine से ~/.openclaw/agents/<agentId>/sessions/ अलग से copy करें।

​
Advanced notes

  • Multi-agent routing प्रति एजेंट अलग-अलग कार्यक्षेत्रों का उपयोग कर सकती है। routing configuration के लिए Channel routing देखें।
  • यदि agents.defaults.sandbox सक्षम है, तो non-main sessions agents.defaults.sandbox.workspaceRoot के अंतर्गत per-session sandbox workspaces का उपयोग कर सकते हैं।
  • Heartbeat - HEARTBEAT.md कार्यक्षेत्र फ़ाइल
  • Sandboxing - sandboxed environments में कार्यक्षेत्र access
  • Session - session storage paths
  • Standing orders - कार्यक्षेत्र फ़ाइलों में persistent instructions