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

CLI commands

सत्र

openclaw sessions

संग्रहीत बातचीत सत्रों की सूची दिखाएं।

सत्र सूचियां चैनल/प्रदाता सक्रियता जांच नहीं हैं। वे सत्र स्टोर से कायम रखी गई बातचीत पंक्तियां दिखाती हैं। कोई शांत Discord, Slack, Telegram, या अन्य चैनल नया सत्र पंक्ति बनाए बिना सफलतापूर्वक फिर से कनेक्ट हो सकता है, जब तक कोई संदेश संसाधित न हो। जब आपको लाइव चैनल कनेक्टिविटी चाहिए, तो openclaw channels status --probe, openclaw status --deep, या openclaw health --verbose का उपयोग करें।

openclaw sessions और Gateway sessions.list प्रतिक्रियाएं डिफ़ॉल्ट रूप से सीमित होती हैं ताकि बड़े लंबे समय तक रहने वाले स्टोर CLI प्रक्रिया या Gateway इवेंट लूप पर एकाधिकार न कर सकें। CLI डिफ़ॉल्ट रूप से नवीनतम 100 सत्र लौटाता है; छोटे/बड़े विंडो के लिए --limit <n> पास करें या जब आपको जानबूझकर पूरा स्टोर चाहिए तो --limit all पास करें। जब कॉलरों को दिखाना हो कि और पंक्तियां मौजूद हैं, तो JSON प्रतिक्रियाओं में totalCount, limitApplied, और hasMore शामिल होते हैं।

RPC क्लाइंट विस्तृत संयुक्त डिस्कवरी स्रोत बनाए रखते हुए केवल वर्तमान में कॉन्फ़िगरेशन में मौजूद एजेंटों की पंक्तियां लौटाने के लिए configuredAgentsOnly: true पास कर सकते हैं। Control UI डिफ़ॉल्ट रूप से उस मोड का उपयोग करता है, ताकि हटाए गए या केवल-डिस्क एजेंट स्टोर Sessions दृश्य में फिर से प्रकट न हों।

bash
openclaw sessionsopenclaw sessions --agent workopenclaw sessions --all-agentsopenclaw sessions --active 120openclaw sessions --limit 25openclaw sessions --verboseopenclaw sessions --json

दायरा चयन:

  • डिफ़ॉल्ट: कॉन्फ़िगर किया गया डिफ़ॉल्ट एजेंट स्टोर
  • --verbose: विस्तृत लॉगिंग
  • --agent <id>: एक कॉन्फ़िगर किया गया एजेंट स्टोर
  • --all-agents: सभी कॉन्फ़िगर किए गए एजेंट स्टोरों को एकत्र करें
  • --store <path>: स्पष्ट स्टोर पथ (--agent या --all-agents के साथ संयोजित नहीं किया जा सकता)
  • --limit <n|all>: आउटपुट के लिए अधिकतम पंक्तियां (डिफ़ॉल्ट 100; all पूरा आउटपुट पुनर्स्थापित करता है)

संग्रहीत सत्रों के लिए मानव-पठनीय ट्रैजेक्टरी प्रगति को tail करें:

bash
openclaw sessions tailopenclaw sessions tail --followopenclaw sessions tail --session-key "agent:main:telegram:direct:123" --tail 25openclaw sessions --agent work tail --followopenclaw sessions --all-agents tail --follow

openclaw sessions tail हाल के ट्रैजेक्टरी JSONL इवेंट्स को संक्षिप्त प्रगति पंक्तियों के रूप में रेंडर करता है। --session-key के बिना, यह पहले चल रहे सत्रों को tail करता है, फिर नवीनतम संग्रहीत सत्र को। --tail <count> नियंत्रित करता है कि follow मोड से पहले कितने मौजूदा इवेंट प्रिंट हों; डिफ़ॉल्ट 80 है, और 0 वर्तमान अंत से शुरू करता है। --follow चुनी गई ट्रैजेक्टरी फ़ाइलों को देखते रहना जारी रखता है, जिसमें <session>.trajectory-path.json द्वारा संदर्भित स्थानांतरित फ़ाइलें भी शामिल हैं।

प्रगति दृश्य जानबूझकर रूढ़िवादी है: प्रॉम्प्ट टेक्स्ट, टूल आर्ग्युमेंट, और टूल परिणाम बॉडी प्रिंट नहीं की जातीं। टूल कॉल {...redacted...} के साथ टूल नाम दिखाते हैं; टूल परिणाम ok, error, या done जैसी स्थिति दिखाते हैं; मॉडल पूर्णता पंक्तियां प्रदाता/मॉडल और टर्मिनल स्थिति दिखाती हैं।

किसी संग्रहीत सत्र के लिए ट्रैजेक्टरी बंडल निर्यात करें:

bash
openclaw sessions export-trajectory --session-key "agent:main:telegram:direct:123" --workspace .openclaw sessions export-trajectory --session-key "agent:main:telegram:direct:123" --output bug-123 --json

यह वह कमांड पथ है जिसका उपयोग /export-trajectory slash command द्वारा मालिक के exec अनुरोध को मंज़ूरी देने के बाद किया जाता है। आउटपुट डायरेक्टरी हमेशा चुने गए workspace के अंतर्गत .openclaw/trajectory-exports/ के अंदर resolve की जाती है।

openclaw sessions --all-agents कॉन्फ़िगर किए गए एजेंट स्टोर पढ़ता है। Gateway और ACP सत्र डिस्कवरी अधिक विस्तृत है: वे डिफ़ॉल्ट agents/ root या टेम्पलेटेड session.store root के अंतर्गत पाए गए केवल-डिस्क स्टोर भी शामिल करते हैं। उन खोजे गए स्टोरों को एजेंट root के अंदर नियमित sessions.json फ़ाइलों पर resolve होना चाहिए; symlinks और root से बाहर के पथ छोड़े जाते हैं।

JSON उदाहरण:

openclaw sessions --all-agents --json:

json
{  "path": null,  "stores": [    { "agentId": "main", "path": "/home/user/.openclaw/agents/main/sessions/sessions.json" },    { "agentId": "work", "path": "/home/user/.openclaw/agents/work/sessions/sessions.json" }  ],  "allAgents": true,  "count": 2,  "totalCount": 2,  "limitApplied": 100,  "hasMore": false,  "activeMinutes": null,  "sessions": [    { "agentId": "main", "key": "agent:main:main", "model": "gpt-5" },    { "agentId": "work", "key": "agent:work:main", "model": "claude-opus-4-6" }  ]}

सफ़ाई रखरखाव

अभी रखरखाव चलाएं (अगले write cycle की प्रतीक्षा करने के बजाय):

bash
openclaw sessions cleanup --dry-runopenclaw sessions cleanup --agent work --dry-runopenclaw sessions cleanup --all-agents --dry-runopenclaw sessions cleanup --enforceopenclaw sessions cleanup --enforce --active-key "agent:main:telegram:direct:123"openclaw sessions cleanup --dry-run --fix-dm-scopeopenclaw sessions cleanup --json

openclaw sessions cleanup कॉन्फ़िगरेशन से session.maintenance सेटिंग्स का उपयोग करता है:

  • दायरा नोट: openclaw sessions cleanup सत्र स्टोर, ट्रांसक्रिप्ट, और ट्रैजेक्टरी sidecars का रखरखाव करता है। यह cron run history को prune नहीं करता, जिसे Cron कॉन्फ़िगरेशन में cron.runLog.keepLines द्वारा प्रबंधित किया जाता है और Cron रखरखाव में समझाया गया है।

  • Cleanup session.maintenance.pruneAfter से पुराने अनसंदर्भित प्राथमिक ट्रांसक्रिप्ट, Compaction चेकपॉइंट, और ट्रैजेक्टरी sidecars को भी prune करता है; sessions.json द्वारा अभी भी संदर्भित फ़ाइलें संरक्षित रहती हैं।

  • Cleanup अल्पकालिक gateway model-run probe cleanup को अलग से modelRunPruned के रूप में रिपोर्ट करता है। यह केवल agent:*:explicit:model-run-<uuid> जैसे आकार वाली सख्त स्पष्ट keys से मेल खाता है। निश्चित retention 24h है, लेकिन यह pressure-gated है: यह केवल तब stale probe rows हटाता है जब session-entry maintenance/cap pressure पहुंच जाता है। जब यह चलता है, model-run cleanup वैश्विक stale cleanup और capping से पहले होता है।

  • --dry-run: बिना लिखे preview करें कि कितनी entries prune/cap होंगी।

    • टेक्स्ट मोड में, dry-run प्रति-सत्र action table (Action, Key, Age, Model, Flags) और session label द्वारा grouped summary प्रिंट करता है, ताकि आप देख सकें कि क्या रखा जाएगा बनाम हटाया जाएगा।

  • --enforce: session.maintenance.mode के warn होने पर भी maintenance लागू करें।

  • --fix-missing: जिन entries की transcript files गायब हैं या header-only/empty हैं, उन्हें हटाएं, भले ही वे सामान्य रूप से अभी age/count out न हों।

  • --fix-dm-scope: जब session.dmScope main हो, तो पहले के per-peer, per-channel-peer, या per-account-channel-peer routing से पीछे छूटी stale peer-keyed direct-DM rows retire करें। पहले --dry-run का उपयोग करें; cleanup लागू करने से वे rows sessions.json से हटती हैं और उनके transcripts deleted archives के रूप में संरक्षित रहते हैं।

  • --active-key <key>: किसी विशिष्ट active key को disk-budget eviction से बचाएं। टिकाऊ external conversation pointers, जैसे group sessions और thread-scoped chat sessions, भी age/count/disk-budget maintenance द्वारा रखे जाते हैं।

  • --agent <id>: एक कॉन्फ़िगर किए गए agent store के लिए cleanup चलाएं।

  • --all-agents: सभी कॉन्फ़िगर किए गए agent stores के लिए cleanup चलाएं।

  • --store <path>: किसी विशिष्ट sessions.json फ़ाइल पर चलाएं।

  • --json: JSON summary प्रिंट करें। --all-agents के साथ, output में प्रति store एक summary शामिल होती है।

जब Gateway पहुंच योग्य हो, तो कॉन्फ़िगर किए गए agent stores के लिए non-dry-run cleanup Gateway के माध्यम से भेजा जाता है ताकि वह runtime traffic के समान session-store writer साझा करे। store file की स्पष्ट offline repair के लिए --store <path> का उपयोग करें।

openclaw sessions cleanup --all-agents --dry-run --json:

json
{  "allAgents": true,  "mode": "warn",  "dryRun": true,  "stores": [    {      "agentId": "main",      "storePath": "/home/user/.openclaw/agents/main/sessions/sessions.json",      "beforeCount": 120,      "afterCount": 80,      "missing": 0,      "dmScopeRetired": 0,      "pruned": 40,      "capped": 0    },    {      "agentId": "work",      "storePath": "/home/user/.openclaw/agents/work/sessions/sessions.json",      "beforeCount": 18,      "afterCount": 18,      "missing": 0,      "dmScopeRetired": 0,      "pruned": 0,      "capped": 0    }  ]}

सत्र compact करें

wedged या oversized सत्र के लिए context budget पुनः प्राप्त करें। openclaw sessions compact <key> sessions.compact gateway RPC के चारों ओर first-class wrapper है और इसके लिए running gateway आवश्यक है।

bash
openclaw sessions compact "agent:main:main"openclaw sessions compact "agent:main:main" --max-lines 200openclaw sessions compact "agent:work:main" --agent work --json
  • --max-lines के बिना, gateway LLM transcript को summarize करता है। CLI डिफ़ॉल्ट रूप से client deadline लागू नहीं करता; gateway configured compaction lifecycle का मालिक है।
  • --max-lines <n> के साथ, यह अंतिम n transcript lines तक truncate करता है और prior transcript को .bak sidecar के रूप में archive करता है।
  • --agent <id>: session का मालिक agent; global keys के लिए आवश्यक।
  • --url / --token / --password: gateway connection overrides।
  • --timeout <ms>: milliseconds में वैकल्पिक client-side RPC timeout।
  • --json: raw RPC payload प्रिंट करें।

जब gateway failed compaction रिपोर्ट करता है या unreachable होता है, तो command non-zero exit करता है, ताकि crons और scripts किसी silent no-op को success न समझें।

नोट: openclaw agent --message '/compact ...' compaction path नहीं है। CLI से slash commands authorized-sender check द्वारा reject किए जाते हैं; वह invocation silently no-op करने के बजाय यहां की ओर guidance देते हुए non-zero exit करता है।

sessions.compact RPC

openclaw gateway call sessions.compact --params '<json>' स्वीकार करता है:

Field Type Required Description
key string yes Compact करने के लिए session key (उदाहरण agent:main:main)।
agentId string no Session का मालिक agent id (global keys के लिए)।
maxLines integer ≥ 1 no LLM summarization के बजाय अंतिम N lines तक truncate करें।

LLM-summarize response का उदाहरण:

json
{  "ok": true,  "key": "agent:main:main",  "compacted": true,  "result": { "tokensBefore": 243868, "tokensAfter": 34941 }}

truncate response का उदाहरण (--max-lines 200):

json
{  "ok": true,  "key": "agent:main:main",  "compacted": true,  "archived": "/home/user/.openclaw/agents/main/sessions/transcripts/<id>.jsonl.bak",  "kept": 200}

संबंधित

Was this useful?
On this page

On this page