OpenClawDocs
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this page

Fundamentals

एजेंट कार्यक्षेत्र

वर्कस्पेस एजेंट का घर है: फ़ाइल टूल और वर्कस्पेस संदर्भ के लिए उपयोग की जाने वाली कार्यशील डायरेक्टरी। इसे निजी रखें और मेमोरी की तरह मानें।

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

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

  • डिफ़ॉल्ट: ~/.openclaw/workspace
  • यदि OPENCLAW_PROFILE सेट है और "default" नहीं है, तो डिफ़ॉल्ट ~/.openclaw/workspace-<profile> हो जाता है।
  • सेट होने पर OPENCLAW_WORKSPACE_DIR ऊपर दिए गए दोनों को ओवरराइड करता है।
  • स्पष्ट वर्कस्पेस के बिना गैर-डिफ़ॉल्ट एजेंट (agents.entries.*) साझा डिफ़ॉल्ट वर्कस्पेस के बजाय <state-dir>/workspace-<agentId> पर समाधान करते हैं।

~/.openclaw/openclaw.json में ओवरराइड करें:

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

प्रति-एजेंट ओवरराइड: agents.entries.*.workspace।

यदि वर्कस्पेस और बूटस्ट्रैप फ़ाइलें मौजूद नहीं हैं, तो openclaw onboard, openclaw configure, या openclaw setup उन्हें बनाते हैं।

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

json5
{ agents: { defaults: { skipBootstrap: true } } }

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

पुराने इंस्टॉलेशन ने संभवतः ~/openclaw बनाया हो। एकाधिक वर्कस्पेस डायरेक्टरियाँ रखने से प्रमाणीकरण या स्थिति में भ्रमित करने वाला अंतर आ सकता है, क्योंकि एक समय में केवल एक वर्कस्पेस सक्रिय रहता है।

वर्कस्पेस फ़ाइल मानचित्र

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

AGENTS.md - संचालन निर्देश

एजेंट के लिए संचालन निर्देश और उसे मेमोरी का उपयोग कैसे करना चाहिए। प्रत्येक सेशन के आरंभ में लोड किया जाता है। नियमों, प्राथमिकताओं और "कैसे व्यवहार करना है" संबंधी विवरणों के लिए उपयुक्त स्थान।

SOUL.md - व्यक्तित्व और लहजा

व्यक्तित्व, लहजा और सीमाएँ। प्रत्येक सेशन में लोड किया जाता है। मार्गदर्शिका: SOUL.md व्यक्तित्व मार्गदर्शिका।

USER.md - उपयोगकर्ता कौन है

उपयोगकर्ता कौन है और उसे कैसे संबोधित करना है। प्रत्येक सेशन में लोड किया जाता है।

IDENTITY.md - नाम, अंदाज़, इमोजी

एजेंट का नाम, अंदाज़ और इमोजी। बूटस्ट्रैप प्रक्रिया के दौरान बनाया/अपडेट किया जाता है।

TOOLS.md - स्थानीय टूल परंपराएँ

आपके स्थानीय टूल और परंपराओं के बारे में टिप्पणियाँ। यह टूल की उपलब्धता नियंत्रित नहीं करता; यह केवल मार्गदर्शन है।

HEARTBEAT.md - Heartbeat चेकलिस्ट

Heartbeat रन के लिए वैकल्पिक छोटी चेकलिस्ट। टोकन की अनावश्यक खपत से बचने के लिए इसे संक्षिप्त रखें।

BOOT.md - स्टार्टअप चेकलिस्ट

वैकल्पिक स्टार्टअप चेकलिस्ट, जो Gateway पुनः आरंभ होने पर स्वचालित रूप से चलती है (जब आंतरिक हुक सक्षम हों)। इसे संक्षिप्त रखें; बाहर संदेश भेजने के लिए संदेश टूल का उपयोग करें।

BOOTSTRAP.md - प्रथम-रन प्रक्रिया

एक बार होने वाली प्रथम-रन प्रक्रिया। केवल बिल्कुल नए वर्कस्पेस के लिए बनाई जाती है। प्रक्रिया पूरी होने के बाद इसे हटा दें।

memory/YYYY-MM-DD.md - दैनिक मेमोरी लॉग

दैनिक मेमोरी लॉग (प्रति दिन एक फ़ाइल)। सेशन आरंभ होने पर आज + कल की फ़ाइल पढ़ने की सलाह दी जाती है।

MEMORY.md - व्यवस्थित दीर्घकालिक मेमोरी (वैकल्पिक)

व्यवस्थित दीर्घकालिक मेमोरी: स्थायी तथ्य, प्राथमिकताएँ, निर्णय और संक्षिप्त सारांश। विस्तृत लॉग memory/YYYY-MM-DD.md में रखें, ताकि मेमोरी टूल प्रत्येक प्रॉम्प्ट में उन्हें प्रविष्ट किए बिना आवश्यकता पड़ने पर प्राप्त कर सकें। MEMORY.md को केवल मुख्य, निजी सेशन में लोड करें (साझा/समूह संदर्भों में नहीं)। कार्यप्रवाह और स्वचालित मेमोरी फ़्लश के लिए मेमोरी देखें।

skills/ - वर्कस्पेस Skills (वैकल्पिक)

वर्कस्पेस-विशिष्ट Skills। नाम टकराने पर उस वर्कस्पेस के लिए सर्वोच्च-प्राथमिकता वाला Skills स्थान, जो प्रोजेक्ट एजेंट Skills, व्यक्तिगत एजेंट Skills, प्रबंधित Skills, बंडल किए गए Skills और skills.load.extraDirs से आगे होता है।

canvas/ - Canvas UI फ़ाइलें (वैकल्पिक)

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

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

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

  • ~/.openclaw/openclaw.json (कॉन्फ़िगरेशन)
  • ~/.openclaw/state/openclaw.sqlite (साझा वर्कस्पेस सेटअप स्थिति और सत्यापन)
  • ~/.openclaw/agents/<agentId>/agent/auth-profiles.json (मॉडल प्रमाणीकरण प्रोफ़ाइल: OAuth + API कुंजियाँ)
  • ~/.openclaw/agents/<agentId>/agent/openclaw-agent.sqlite (सेशन पंक्तियाँ, ट्रांसक्रिप्ट और प्रति-एजेंट रनटाइम स्थिति)
  • ~/.openclaw/agents/<agentId>/agent/codex-home/ (प्रति-एजेंट Codex रनटाइम खाता, कॉन्फ़िगरेशन, Skills, plugins और नेटिव थ्रेड स्थिति)
  • ~/.openclaw/credentials/ (चैनल/प्रदाता स्थिति और विरासती OAuth आयात डेटा)
  • ~/.openclaw/agents/<agentId>/sessions/ (विरासती माइग्रेशन स्रोत और आर्काइव/समर्थन आर्टिफ़ैक्ट)
  • ~/.openclaw/skills/ (प्रबंधित Skills)

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

OpenClaw के पुराने रिलीज़ ने openclaw-workspace-state.json, .openclaw/workspace-state.json, और .attested वर्कस्पेस साइडकार लिखे थे। वर्तमान रनटाइम उस स्थिति के लिए केवल साझा SQLite डेटाबेस का उपयोग करता है। यदि Doctor इनमें से किसी फ़ाइल की रिपोर्ट करता है, तो openclaw doctor --fix चलाएँ; Doctor वैध विरासती स्थिति आयात करता है और डेटाबेस पंक्तियों की पुष्टि करने के बाद ही स्रोत हटाता है।

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

वर्कस्पेस को निजी मेमोरी की तरह मानें। इसका बैकअप लेने और इसे पुनर्प्राप्त करने योग्य बनाने के लिए इसे किसी निजी git रिपॉज़िटरी में रखें।

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

  • रिपॉज़िटरी आरंभ करें

    यदि git इंस्टॉल है, तो बिल्कुल नए वर्कस्पेस स्वचालित रूप से आरंभ किए जाते हैं। यदि यह वर्कस्पेस पहले से रिपॉज़िटरी नहीं है, तो चलाएँ:

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

  • निजी रिमोट जोड़ें

    GitHub वेब UI

    1. GitHub पर नई निजी रिपॉज़िटरी बनाएँ।
    2. README के साथ आरंभ न करें (मर्ज टकराव से बचाता है)।
    3. HTTPS रिमोट URL कॉपी करें।
    4. रिमोट जोड़ें और पुश करें:
    bash
    git branch -M maingit remote add origin <https-url>git push -u origin main

    GitHub CLI (gh)

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

    GitLab वेब UI

    1. GitLab पर नई निजी रिपॉज़िटरी बनाएँ।
    2. README के साथ आरंभ न करें (मर्ज टकराव से बचाता है)।
    3. HTTPS रिमोट URL कॉपी करें।
    4. रिमोट जोड़ें और पुश करें:
    bash
    git branch -M maingit remote add origin <https-url>git push -u origin main

  • निरंतर अपडेट

    bash
    git statusgit add .git commit -m "Update memory"git push

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

    सुझाया गया .gitignore प्रारंभिक खाका:

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

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

  • रिपॉज़िटरी क्लोन करें

    रिपॉज़िटरी को इच्छित पाथ पर क्लोन करें (डिफ़ॉल्ट ~/.openclaw/workspace)।

  • कॉन्फ़िगरेशन अपडेट करें

    ~/.openclaw/openclaw.json में agents.defaults.workspace को उस पाथ पर सेट करें।

  • अनुपस्थित फ़ाइलें सीड करें

    अनुपस्थित फ़ाइलों को सीड करने के लिए openclaw setup --workspace <path> चलाएँ।

  • सेशन कॉपी करें (वैकल्पिक)

    यदि आपको सेशन चाहिए, तो पुरानी मशीन से ~/.openclaw/agents/<agentId>/agent/openclaw-agent.sqlite अलग से कॉपी करें। ~/.openclaw/agents/<agentId>/sessions/ केवल तभी कॉपी करें जब आपको विरासती माइग्रेशन इनपुट या आर्काइव/समर्थन आर्टिफ़ैक्ट भी चाहिए।

    • उन्नत टिप्पणियाँ

    • बहु-एजेंट रूटिंग agents.entries.*.workspace के माध्यम से प्रत्येक एजेंट के लिए अलग वर्कस्पेस का उपयोग कर सकती है। रूटिंग कॉन्फ़िगरेशन के लिए चैनल रूटिंग देखें।
    • यदि agents.defaults.sandbox सक्षम है, तो गैर-मुख्य सेशन agents.defaults.sandbox.workspaceRoot के अंतर्गत प्रति-सेशन सैंडबॉक्स वर्कस्पेस का उपयोग कर सकते हैं।

    संबंधित

    Was this useful?
    On this page

    On this page