CLI commands
मेमोरी
openclaw memory
सिमेंटिक मेमोरी इंडेक्सिंग और खोज प्रबंधित करें।
यह बंडल किए गए memory-core Plugin द्वारा प्रदान किया जाता है। यह कमांड तब उपलब्ध होता है जब
plugins.slots.memory memory-core चुनता है (डिफॉल्ट); अन्य मेमोरी Plugin
अपने स्वयं के CLI नेमस्पेस उपलब्ध कराते हैं।
संबंधित:
- मेमोरी अवधारणा: मेमोरी
- मेमोरी विकी: मेमोरी विकी
- विकी CLI: wiki
- Plugins: Plugins
उदाहरण
openclaw memory statusopenclaw memory status --deepopenclaw memory status --fixopenclaw memory index --forceopenclaw memory search "meeting notes"openclaw memory search --query "deployment" --max-results 20openclaw memory promote --limit 10 --min-score 0.75openclaw memory promote --applyopenclaw memory promote --json --min-recall-count 0 --min-unique-queries 0openclaw memory promote-explain "router vlan"openclaw memory promote-explain "router vlan" --jsonopenclaw memory rem-harnessopenclaw memory rem-harness --jsonopenclaw memory status --jsonopenclaw memory status --deep --indexopenclaw memory status --deep --index --verboseopenclaw memory status --agent mainopenclaw memory index --agent main --verboseविकल्प
memory status और memory index:
--agent <id>: दायरा किसी एक एजेंट तक सीमित करें। इसके बिना, ये कमांड प्रत्येक कॉन्फिगर किए गए एजेंट के लिए चलते हैं; यदि कोई एजेंट सूची कॉन्फिगर नहीं है, तो वे डिफॉल्ट एजेंट पर वापस जाते हैं।--verbose: प्रोब और इंडेक्सिंग के दौरान विस्तृत लॉग उत्सर्जित करें।
memory status:
--deep: लोकल वेक्टर-स्टोर तैयारी, एम्बेडिंग-प्रोवाइडर तैयारी, और सिमेंटिक वेक्टर-सर्च तैयारी की जांच करें। सामान्यmemory statusतेज रहता है और लाइव एम्बेडिंग या प्रोवाइडर डिस्कवरी कार्य नहीं चलाता; अज्ञात वेक्टर-स्टोर या सिमेंटिक-वेक्टर स्थिति का मतलब है कि उस कमांड में उसकी जांच नहीं की गई थी। QMD लेक्सिकलsearchMode: "search"--deepके साथ भी सिमेंटिक वेक्टर प्रोब और एम्बेडिंग रखरखाव छोड़ देता है।--index: यदि स्टोर डर्टी है तो रीइंडेक्स चलाएं (--deepनिहित करता है)।--fix: पुराने रिकॉल लॉक सुधारें और प्रमोशन मेटाडेटा सामान्यीकृत करें।--json: JSON आउटपुट प्रिंट करें।
यदि memory status Dreaming status: blocked दिखाता है, तो प्रबंधित Dreaming Cron सक्षम है लेकिन उसे चलाने वाला Heartbeat डिफॉल्ट एजेंट के लिए फायर नहीं हो रहा है। दो सामान्य कारणों के लिए Dreaming कभी नहीं चलता देखें।
memory index:
--force: पूर्ण रीइंडेक्स को बाध्य करें।
memory search:
- क्वेरी इनपुट: या तो पोजिशनल
[query]या--query <text>पास करें। - यदि दोनों दिए गए हैं, तो
--queryप्राथमिकता लेता है। - यदि कोई भी नहीं दिया गया है, तो कमांड त्रुटि के साथ बाहर निकलता है।
--agent <id>: दायरा किसी एक एजेंट तक सीमित करें (डिफॉल्ट: डिफॉल्ट एजेंट)।--max-results <n>: लौटाए गए परिणामों की संख्या सीमित करें।--min-score <n>: कम-स्कोर वाले मैच फ़िल्टर करें।--json: JSON परिणाम प्रिंट करें।
memory promote:
शॉर्ट-टर्म मेमोरी प्रमोशन का पूर्वावलोकन करें और उन्हें लागू करें।
openclaw memory promote [--apply] [--limit <n>] [--include-promoted]--apply-- प्रमोशन कोMEMORY.mdमें लिखें (डिफॉल्ट: केवल पूर्वावलोकन)।--limit <n>-- दिखाए गए कैंडिडेट की संख्या सीमित करें।--include-promoted-- पिछले चक्रों में पहले से प्रमोट की गई एंट्री शामिल करें।
पूर्ण विकल्प:
- भारित प्रमोशन संकेतों (
frequency,relevance,query diversity,recency,consolidation,conceptual richness) का उपयोग करकेmemory/YYYY-MM-DD.mdसे शॉर्ट-टर्म कैंडिडेट रैंक करता है। - मेमोरी रिकॉल और डेली-इंजेशन पास, दोनों से शॉर्ट-टर्म संकेतों का उपयोग करता है, साथ ही लाइट/REM चरण रीइन्फोर्समेंट संकेत भी।
- जब Dreaming सक्षम होता है, तो
memory-coreएक Cron जॉब अपने-आप प्रबंधित करता है जो बैकग्राउंड में पूरा स्वीप (light -> REM -> deep) चलाता है (मैनुअलopenclaw cron addआवश्यक नहीं)। --agent <id>: दायरा किसी एक एजेंट तक सीमित करें (डिफॉल्ट: डिफॉल्ट एजेंट)।--limit <n>: लौटाने/लागू करने के लिए अधिकतम कैंडिडेट।--min-score <n>: न्यूनतम भारित प्रमोशन स्कोर।--min-recall-count <n>: किसी कैंडिडेट के लिए आवश्यक न्यूनतम रिकॉल काउंट।--min-unique-queries <n>: किसी कैंडिडेट के लिए आवश्यक न्यूनतम विशिष्ट क्वेरी काउंट।--apply: चुने गए कैंडिडेट कोMEMORY.mdमें जोड़ें और उन्हें प्रमोटेड चिह्नित करें।--include-promoted: आउटपुट में पहले से प्रमोट किए गए कैंडिडेट शामिल करें।--json: JSON आउटपुट प्रिंट करें।
memory promote-explain:
किसी विशिष्ट प्रमोशन कैंडिडेट और उसके स्कोर ब्रेकडाउन को समझाएं।
openclaw memory promote-explain <selector> [--agent <id>] [--include-promoted] [--json]<selector>: देखने के लिए कैंडिडेट कुंजी, पाथ फ्रैगमेंट, या स्निपेट फ्रैगमेंट।--agent <id>: दायरा किसी एक एजेंट तक सीमित करें (डिफॉल्ट: डिफॉल्ट एजेंट)।--include-promoted: पहले से प्रमोट किए गए कैंडिडेट शामिल करें।--json: JSON आउटपुट प्रिंट करें।
memory rem-harness:
कुछ भी लिखे बिना REM रिफ्लेक्शन, कैंडिडेट सत्य, और डीप प्रमोशन आउटपुट का पूर्वावलोकन करें।
openclaw memory rem-harness [--agent <id>] [--include-promoted] [--json]--agent <id>: दायरा किसी एक एजेंट तक सीमित करें (डिफॉल्ट: डिफॉल्ट एजेंट)।--include-promoted: पहले से प्रमोट किए गए डीप कैंडिडेट शामिल करें।--json: JSON आउटपुट प्रिंट करें।
Dreaming
Dreaming तीन सहयोगी चरणों वाला बैकग्राउंड मेमोरी कंसॉलिडेशन सिस्टम है:
light (शॉर्ट-टर्म सामग्री को सॉर्ट/स्टेज करना), deep (टिकाऊ
तथ्यों को MEMORY.md में प्रमोट करना), और REM (विचार करना और थीम सतह पर लाना)।
plugins.entries.memory-core.config.dreaming.enabled: trueसे सक्षम करें।- चैट से
/dreaming on|offके साथ टॉगल करें (या/dreaming statusसे जांचें)। सेटिंग बदलने के लिए चैनल कॉलर मालिक होने चाहिए; Gateway क्लाइंट कोoperator.adminचाहिए। केवल-पढ़ने वाली स्थिति और सहायता अधिकृत कमांड भेजने वालों के लिए उपलब्ध रहती हैं। - Dreaming एक प्रबंधित स्वीप शेड्यूल (
dreaming.frequency) पर चलता है और चरणों को क्रम में निष्पादित करता है: light, REM, deep। - केवल deep चरण टिकाऊ मेमोरी को
MEMORY.mdमें लिखता है। - मानव-पठनीय चरण आउटपुट और डायरी एंट्री
DREAMS.md(या मौजूदाdreams.md) में लिखी जाती हैं, वैकल्पिक प्रति-चरण रिपोर्टmemory/dreaming/<phase>/YYYY-MM-DD.mdमें होती हैं। - रैंकिंग भारित संकेतों का उपयोग करती है: रिकॉल फ्रीक्वेंसी, रिट्रीवल प्रासंगिकता, क्वेरी विविधता, समयगत हालियापन, क्रॉस-डे कंसॉलिडेशन, और व्युत्पन्न कॉन्सेप्ट समृद्धि।
- प्रमोशन
MEMORY.mdमें लिखने से पहले लाइव डेली नोट को फिर से पढ़ता है, इसलिए संपादित या हटाए गए शॉर्ट-टर्म स्निपेट पुराने रिकॉल-स्टोर स्नैपशॉट से प्रमोट नहीं होते। - शेड्यूल किए गए और मैनुअल
memory promoteरन वही deep चरण डिफॉल्ट साझा करते हैं, जब तक कि आप CLI थ्रेशोल्ड ओवरराइड पास नहीं करते। - ऑटोमैटिक रन कॉन्फिगर किए गए मेमोरी वर्कस्पेस में फैलते हैं।
डिफॉल्ट शेड्यूलिंग:
- स्वीप कैडेंस:
dreaming.frequency = 0 3 * * * - डीप थ्रेशोल्ड:
minScore=0.8,minRecallCount=3,minUniqueQueries=3,recencyHalfLifeDays=14,maxAgeDays=30
उदाहरण:
{ "plugins": { "entries": { "memory-core": { "config": { "dreaming": { "enabled": true } } } } }}नोट्स:
memory index --verboseप्रति-चरण विवरण (प्रोवाइडर, मॉडल, स्रोत, बैच गतिविधि) प्रिंट करता है।memory statusmemorySearch.extraPathsके जरिए कॉन्फिगर किए गए किसी भी अतिरिक्त पाथ को शामिल करता है।- यदि प्रभावी Active Memory रिमोट API कुंजी फ़ील्ड SecretRefs के रूप में कॉन्फिगर हैं, तो कमांड सक्रिय Gateway स्नैपशॉट से उन मानों को रिज़ॉल्व करता है। यदि Gateway अनुपलब्ध है, तो कमांड तुरंत विफल हो जाता है।
- Gateway संस्करण असंगति नोट: इस कमांड पाथ को ऐसे Gateway की आवश्यकता है जो
secrets.resolveका समर्थन करता हो; पुराने Gateway अज्ञात-मेथड त्रुटि लौटाते हैं। - शेड्यूल किए गए स्वीप कैडेंस को
dreaming.frequencyसे ट्यून करें। डीप प्रमोशन नीति अन्यथा आंतरिक है, सिवायdreaming.phases.deep.maxPromotedSnippetTokensके, जो प्रोवेनेंस दिखाई रखते हुए प्रमोटेड स्निपेट लंबाई सीमित करता है। जब आपको एक-बार के मैनुअल थ्रेशोल्ड ओवरराइड चाहिए हों, तोmemory promoteपर CLI फ्लैग का उपयोग करें। memory rem-harness --path <file-or-dir> --groundedकुछ भी लिखे बिना ऐतिहासिक डेली नोट्स से ग्राउंडेडWhat Happened,Reflections, औरPossible Lasting Updatesका पूर्वावलोकन करता है।memory rem-backfill --path <file-or-dir>UI समीक्षा के लिएDREAMS.mdमें रिवर्सिबल ग्राउंडेड डायरी एंट्री लिखता है।memory rem-backfill --path <file-or-dir> --stage-short-termलाइव शॉर्ट-टर्म प्रमोशन स्टोर में ग्राउंडेड टिकाऊ कैंडिडेट भी सीड करता है ताकि सामान्य deep चरण उन्हें रैंक कर सके।memory rem-backfill --rollbackपहले लिखी गई ग्राउंडेड डायरी एंट्री हटाता है, औरmemory rem-backfill --rollback-short-termपहले स्टेज किए गए ग्राउंडेड शॉर्ट-टर्म कैंडिडेट हटाता है।- पूर्ण चरण विवरण और कॉन्फिगरेशन संदर्भ के लिए Dreaming देखें।