Advanced setup
OpenClaw एजेंट रनटाइम कार्यप्रवाह
OpenClaw रेपो में एजेंट रनटाइम (src/agents/) के लिए डेवलपर कार्यप्रवाह।
टाइप जाँच और लिंटिंग
- डिफ़ॉल्ट स्थानीय गेट:
pnpm check(टाइप जाँच, लिंट, नीति गार्ड) - बिल्ड गेट: जब परिवर्तन बिल्ड आउटपुट, पैकेजिंग या लेज़ी-लोडिंग/मॉड्यूल सीमाओं को प्रभावित कर सकता हो, तब
pnpm build - पुश से पहले का पूर्ण गेट:
pnpm build && pnpm check && pnpm check:test-types && pnpm test
एजेंट रनटाइम परीक्षण चलाना
एजेंट रनटाइम यूनिट सुइट चलाएँ:
pnpm test \ "src/agents/agent-*.test.ts" \ "src/agents/embedded-agent-*.test.ts" \ "src/agents/agent-hooks/**/*.test.ts"पहला ग्लॉब agent-tools*, agent-settings, और
agent-tool-definition-adapter* सुइट को भी कवर करता है।
लाइव परीक्षण यूनिट कॉन्फ़िगरेशन से बाहर रखे गए हैं; उन्हें लाइव
रैपर के माध्यम से चलाएँ (OPENCLAW_LIVE_TEST=1 सेट करता है और इसके लिए प्रदाता क्रेडेंशियल आवश्यक हैं):
pnpm test:live src/agents/embedded-agent-runner-extraparams.live.test.tsमैन्युअल परीक्षण
- Gateway को डेवलपमेंट मोड में चलाएँ (
OPENCLAW_SKIP_CHANNELS=1के माध्यम से चैनल कनेक्शन छोड़ देता है):pnpm gateway:dev - Gateway के माध्यम से एजेंट का एक टर्न ट्रिगर करें:
pnpm openclaw agent --message "Hello" --thinking low - इंटरैक्टिव डीबगिंग के लिए TUI का उपयोग करें:
pnpm tui
टूल कॉल व्यवहार के लिए, किसी read या exec कार्रवाई का प्रॉम्प्ट दें, ताकि आप
टूल स्ट्रीमिंग और पेलोड प्रबंधन देख सकें।
पूरी तरह रीसेट करना
स्थिति डिफ़ॉल्ट रूप से OpenClaw स्थिति डायरेक्टरी ~/.openclaw में रहती है, या
सेट होने पर $OPENCLAW_STATE_DIR में। उस डायरेक्टरी के सापेक्ष पथ:
| पथ | इसमें संग्रहीत है |
|---|---|
openclaw.json |
कॉन्फ़िगरेशन |
state/openclaw.sqlite |
साझा रनटाइम स्थिति डेटाबेस |
agents/<agentId>/agent/openclaw-agent.sqlite |
प्रत्येक एजेंट के मॉडल प्रमाणीकरण प्रोफ़ाइल (API कुंजियाँ + OAuth) और रनटाइम स्थिति |
credentials/ |
प्रमाणीकरण प्रोफ़ाइल स्टोर के बाहर प्रदाता/चैनल क्रेडेंशियल |
agents/<agentId>/sessions/ |
ट्रांसक्रिप्ट इतिहास और लीगेसी सत्र माइग्रेशन स्रोत |
sessions/ |
लीगेसी एकल-एजेंट सत्र स्टोर (केवल पुराने इंस्टॉलेशन) |
workspace/ |
डिफ़ॉल्ट एजेंट कार्यक्षेत्र (अतिरिक्त एजेंट workspace-<agentId> का उपयोग करते हैं) |
पूर्ण रीसेट के लिए उन पथों को हटाएँ। अधिक सीमित रीसेट:
- केवल सत्र:
agents/<agentId>/agent/openclaw-agent.sqliteको न हटाएँ; सत्र पंक्तियाँ उसमें प्रत्येक एजेंट की अन्य स्थिति के साथ रहती हैं। किसी एक चैट के लिए नया सत्र शुरू करने हेतु/newया/reset, और सत्र रखरखाव के लिएopenclaw sessions cleanupका उपयोग करें। - प्रमाणीकरण बनाए रखें:
agents/<agentId>/agent/openclaw-agent.sqliteऔरcredentials/को यथास्थान रहने दें।
लीगेसी auth-profiles.json फ़ाइलें अब रनटाइम पर नहीं पढ़ी जातीं;
openclaw doctor --fix उन्हें SQLite स्टोर में आयात करता है।
