Skip to main content
memory-wiki एक बंडल किया गया Plugin है, जो टिकाऊ ज्ञान को एक नेविगेट करने योग्य विकि में संकलित करता है: निर्धारक पृष्ठ, साक्ष्य सहित संरचित दावे, उद्गम, डैशबोर्ड और मशीन-पठनीय सार-संग्रह। यह Active Memory Plugin को प्रतिस्थापित नहीं करता। पुनःस्मरण, उन्नयन, अनुक्रमण और Dreaming का स्वामित्व कॉन्फ़िगर किए गए मेमोरी बैकएंड (memory-core, QMD, Honcho आदि) के पास ही रहता है। memory-wiki उसके साथ रहता है और ज्ञान को एक अनुरक्षित विकि परत में संकलित करता है। इसके CLI, टूल या रनटाइम एकीकरण का उपयोग करने से पहले Plugin सक्षम करें:
व्यावहारिक नियम:
  • कॉन्फ़िगर किए गए सभी कॉर्पस में एक व्यापक पुनःस्मरण चरण के लिए memory_search
  • जब विकि-विशिष्ट रैंकिंग, उद्गम या पृष्ठ-स्तरीय विश्वास संरचना चाहिए, तब wiki_search / wiki_get
  • एक कॉल में दोनों परतों को समाहित करने के लिए memory_search corpus=all, जब Active Memory Plugin कॉर्पस चयन का समर्थन करता हो
एक सामान्य लोकल-फ़र्स्ट सेटअप: पुनःस्मरण के लिए Active Memory बैकएंड के रूप में QMD और टिकाऊ संश्लेषित पृष्ठों के लिए bridge मोड में memory-wikiकॉन्फ़िगरेशन के अंतर्गत QMD + ब्रिज मोड उदाहरण देखें। यदि ब्रिज मोड शून्य निर्यातित आर्टिफ़ैक्ट रिपोर्ट करता है, तो Active Memory Plugin वर्तमान में सार्वजनिक ब्रिज इनपुट उजागर नहीं कर रहा है। पहले openclaw wiki doctor चलाएँ, फिर पुष्टि करें कि Active Memory Plugin सार्वजनिक आर्टिफ़ैक्ट का समर्थन करता है।

वॉल्ट मोड

  • isolated (डिफ़ॉल्ट): अपना वॉल्ट, अपने स्रोत, Active Memory Plugin पर कोई निर्भरता नहीं। स्व-निहित, चयनित ज्ञान भंडार के लिए इसका उपयोग करें।
  • bridge: सार्वजनिक Plugin SDK सीमाओं के माध्यम से Active Memory Plugin से सार्वजनिक मेमोरी आर्टिफ़ैक्ट और इवेंट लॉग पढ़ता है। निजी Plugin आंतरिक संरचनाओं तक पहुँचे बिना मेमोरी Plugin के निर्यातित आर्टिफ़ैक्ट संकलित करने के लिए इसका उपयोग करें।
  • unsafe-local: स्थानीय निजी पथों के लिए स्पष्ट समान-मशीन निकास मार्ग। जानबूझकर प्रयोगात्मक और गैर-पोर्टेबल; इसका उपयोग केवल तभी करें जब आप विश्वास सीमा समझते हों और विशेष रूप से ऐसी स्थानीय फ़ाइल-सिस्टम पहुँच चाहिए जिसे ब्रिज मोड प्रदान नहीं कर सकता।
वॉल्ट मोड और वॉल्ट कार्यक्षेत्र अलग-अलग विकल्प हैं:
  • vaultMode चुनता है कि विकि इनपुट कहाँ से आते हैं।
  • vault.scope चुनता है कि सभी एजेंट एक वॉल्ट का उपयोग करें या प्रत्येक एजेंट को एक चाइल्ड वॉल्ट मिले।
vault.scope: "global" डिफ़ॉल्ट है और मौजूदा एकल-वॉल्ट व्यवहार को बनाए रखता है। जब एजेंटों को विकि पृष्ठ, संकलित सार-संग्रह, खोज परिणाम या लेखन साझा नहीं करने चाहिए, तब isolated या bridge मोड के साथ vault.scope: "agent" का उपयोग करें। एजेंट कार्यक्षेत्र को unsafe-local मोड के साथ संयोजित नहीं किया जा सकता, क्योंकि वे कॉन्फ़िगर किए गए निजी पथ एजेंट-स्वामित्व वाले इनपुट नहीं हैं। कॉन्फ़िगरेशन सत्यापन इस संयोजन को अस्वीकार करता है। ब्रिज मोड, bridge.* कॉन्फ़िगरेशन टॉगल के अनुसार, इन्हें अनुक्रमित कर सकता है:
  • निर्यातित मेमोरी आर्टिफ़ैक्ट (indexMemoryRoot)
  • दैनिक नोट्स (indexDailyNotes)
  • Dreaming रिपोर्ट (indexDreamReports)
  • मेमोरी इवेंट लॉग (followMemoryEvents)
जब ब्रिज मोड सक्रिय हो और bridge.readMemoryArtifacts सक्षम हो, openclaw wiki status, openclaw wiki doctor और openclaw wiki bridge import चालू Gateway से होकर रूट होते हैं, ताकि उन्हें एजेंट/रनटाइम मेमोरी के समान Active Memory Plugin संदर्भ दिखाई दे। यदि ब्रिज अक्षम हो या आर्टिफ़ैक्ट पठन बंद हो, तो ये कमांड स्थानीय/ऑफ़लाइन व्यवहार बनाए रखते हैं।

वॉल्ट लेआउट

प्रबंधित सामग्री जनरेट किए गए ब्लॉक के भीतर रहती है; मानवीय नोट ब्लॉक पुनर्जनन के दौरान संरक्षित रहते हैं।
  • sources/: आयातित अपरिष्कृत सामग्री और ब्रिज/असुरक्षित-स्थानीय-समर्थित पृष्ठ
  • entities/: टिकाऊ वस्तुएँ, लोग, प्रणालियाँ, परियोजनाएँ, ऑब्जेक्ट
  • concepts/: विचार, अमूर्तताएँ, पैटर्न, नीतियाँ (OKF आयातों का गंतव्य भी)
  • syntheses/: संकलित सारांश और अनुरक्षित समेकित विवरण
  • reports/: जनरेट किए गए डैशबोर्ड

Open Knowledge Format आयात

अनपैक किए गए Open Knowledge Format बंडल को विकि अवधारणा पृष्ठों में आयात करें। यह तब उपयुक्त है जब कोई डेटा कैटलॉग, दस्तावेज़ीकरण क्रॉलर या संवर्धन एजेंट पहले से OKF उत्पन्न करता हो: OKF को पोर्टेबल विनिमय आर्टिफ़ैक्ट के रूप में रखें और memory-wiki को उसे OpenClaw-मूल अवधारणा पृष्ठों और संकलित सार-संग्रहों में बदलने दें।
  • गैर-आरक्षित .md फ़ाइलें अवधारणा दस्तावेज़ हैं
  • प्रत्येक आयातित अवधारणा के लिए गैर-रिक्त type फ्रंटमैटर फ़ील्ड आवश्यक है; अनुपस्थित type एक missing-type चेतावनी उत्पन्न करता है और फ़ाइल छोड़ दी जाती है
  • अज्ञात type मान सामान्य अवधारणाओं के रूप में स्वीकार किए जाते हैं
  • index.md और log.md आरक्षित हैं और कभी अवधारणाओं के रूप में आयात नहीं किए जाते
  • टूटे हुए या बाहरी Markdown लिंक अपरिवर्तित छोड़े जाते हैं
आयातित पृष्ठ concepts/ के अंतर्गत समतल हो जाते हैं, ताकि मौजूदा संकलन, खोज, प्राप्ति और डैशबोर्ड प्रवाह उन्हें दूसरे विकि वृक्ष के बिना देख सकें। प्रत्येक पृष्ठ मूल OKF अवधारणा ID, स्रोत पथ, type, resource, tags, टाइमस्टैम्प और पूर्ण उत्पादक फ्रंटमैटर बनाए रखता है। आंतरिक OKF लिंक जनरेट किए गए विकि अवधारणा पृष्ठों के लिए पुनर्लिखित होते हैं और kind: okf-link सहित संरचित relationships प्रविष्टियाँ भी उत्सर्जित करते हैं।

संरचित दावे और साक्ष्य

पृष्ठों में केवल मुक्त-रूप पाठ नहीं, बल्कि संरचित claims फ्रंटमैटर होता है। प्रत्येक दावे में id, text, status, confidence, evidence[] और updatedAt शामिल हो सकते हैं। प्रत्येक साक्ष्य प्रविष्टि में kind, sourceId, path, lines, weight, confidence, privacyTier, note और updatedAt शामिल हो सकते हैं। इससे विकि निष्क्रिय नोट संग्रह के बजाय विश्वास परत की तरह व्यवहार करता है। दावों को ट्रैक, स्कोर, विवादित और स्रोतों तक वापस ले जाकर समाधान किया जा सकता है।

एजेंट-अभिमुख एंटिटी मेटाडेटा

एंटिटी पृष्ठों में लोग, टीमें, प्रणालियाँ, परियोजनाएँ या किसी अन्य एंटिटी प्रकार के लिए उपयोग योग्य सामान्य रूटिंग मेटाडेटा होता है:
  • entityType: उदाहरण के लिए person, team, system, project
  • canonicalId: उपनामों और आयातों में स्थिर पहचान कुंजी
  • aliases: नाम, हैंडल या लेबल जो उसी पृष्ठ पर रिज़ॉल्व होते हैं
  • privacyTier: मुक्त-रूप स्ट्रिंग; public को समीक्षा-अनावश्यक माना जाता है, किसी अन्य मान (उदाहरण के लिए local-private, sensitive, confirm-before-use) को reports/privacy-review.md में चिह्नित किया जाता है
  • bestUsedFor / notEnoughFor: संक्षिप्त रूटिंग संकेत
  • lastRefreshedAt: स्रोत-रीफ़्रेश टाइमस्टैम्प, पृष्ठ संपादन समय से अलग
  • personCard: वैकल्पिक व्यक्ति-विशिष्ट रूटिंग कार्ड (हैंडल, सोशल, ईमेल, समयक्षेत्र, लेन, किसके लिए पूछें, किसके लिए न पूछें, विश्वसनीयता, गोपनीयता स्तर)
  • relationships: संबंधित पृष्ठों के लिए टाइप किए गए किनारे (लक्ष्य, प्रकार, भार, विश्वसनीयता, साक्ष्य प्रकार, गोपनीयता स्तर, नोट)
लोगों की विकि के लिए, reports/person-agent-directory.md से शुरू करें, फिर संपर्क विवरण या अनुमानित तथ्यों का उपयोग करने से पहले wiki_get से व्यक्ति पृष्ठ खोलें।

संकलन पाइपलाइन

संकलन विकि पृष्ठों को पढ़ता है, सारांशों को सामान्यीकृत करता है और OpenClaw की साझा SQLite Plugin स्थिति में मशीन-अभिमुख स्नैपशॉट बनाए रखता है। रनटाइम कोड एसिंक्रोनस प्रॉम्प्ट तैयारी के दौरान SQLite लोड करने के लिए जीवनचक्र-स्वामित्व वाले स्वामी स्नैपशॉट का उपयोग करता है; सिंक्रोनस प्रॉम्प्ट संयोजन कभी Markdown को स्क्रैप नहीं करता या कैश फ़ाइलें नहीं पढ़ता। संकलित आउटपुट खोज/प्राप्ति के लिए प्रथम-चरण विकि अनुक्रमण, दावे की ID से स्वामी पृष्ठ तक लुकअप, संक्षिप्त प्रॉम्प्ट पूरक और रिपोर्ट जनरेशन को भी संचालित करता है। स्रोत संपादन और वॉल्ट पुनर्स्थापन अगले संकलन के बाद ही मशीन-अभिमुख बनते हैं। Plugin जीवनचक्र को पुनः आरंभ या रीफ़्रेश करना वॉल्ट के कारणात्मक रूप से श्रृंखलाबद्ध संकलन प्रकाशन की SQLite से तुलना करता है और अधिक नए, रोल-बैक किए गए स्टेट के स्नैपशॉट को अस्वीकार करता है। रोलबैक से पहले शुरू हुआ कंपाइलर पुनर्स्थापित पूर्ववर्ती के विरुद्ध प्रकाशित नहीं कर सकता। प्रॉम्प्ट तैयारी वॉल्ट को पोल नहीं करती या फ़ाइल वॉचर स्थापित नहीं करती। रोलबैक क्वारंटीन के बाद, चालू प्रक्रिया में एक संकलन स्वामी को तुरंत साफ़ कर देता है; अलग कंपाइलर प्रक्रिया के लिए Plugin जीवनचक्र रीफ़्रेश आवश्यक है, ताकि डेमन नए टिकाऊ प्रकाशन की पुष्टि कर सके। संकलित कैश पुनर्निर्माण योग्य हैं: प्रकाशन युगों से पहले की कैश पंक्तियों को मिस माना जाता है और अगले संकलन द्वारा प्रतिस्थापित किया जाता है; उन्हें माइग्रेट नहीं किया जाता।

डैशबोर्ड और स्वास्थ्य रिपोर्ट

जब render.createDashboards सक्षम हो, संकलन reports/ के अंतर्गत डैशबोर्ड बनाए रखता है:

खोज और पुनर्प्राप्ति

दो खोज बैकएंड:
  • shared: उपलब्ध होने पर साझा मेमोरी खोज प्रवाह का उपयोग करें
  • local: विकि में स्थानीय रूप से खोजें
तीन कॉर्पस: wiki, memory, all
  • wiki_search / wiki_get संभव होने पर प्रथम चरण के रूप में संकलित सार-संग्रह का उपयोग करते हैं
  • दावा ID वापस स्वामी पृष्ठ पर रिज़ॉल्व होती हैं
  • विवादित/पुराने/नए दावे रैंकिंग को प्रभावित करते हैं
  • उद्गम लेबल परिणामों में बने रहते हैं
खोज मोड (--mode / टूल mode पैरामीटर): जब कोई परिणाम किसी संरचित दावे से मेल खाता है, तो wiki_search अपने विवरण पेलोड में matchedClaimId, matchedClaimStatus, matchedClaimConfidence, evidenceKinds, और evidenceSourceIds लौटाता है। उपलब्ध होने पर टेक्स्ट आउटपुट में संक्षिप्त Claim: और Evidence: पंक्तियाँ शामिल होती हैं।

एजेंट टूल

Plugin एक गैर-अनन्य मेमोरी कॉर्पस पूरक भी पंजीकृत करता है, ताकि सक्रिय मेमोरी Plugin द्वारा कॉर्पस चयन समर्थित होने पर साझा memory_search और memory_get विकी तक पहुँच सकें।

प्रॉम्प्ट और संदर्भ का व्यवहार

जब context.includeCompiledDigestPrompt सक्षम होता है, तो मेमोरी प्रॉम्प्ट अनुभाग Plugin स्थिति से एक संक्षिप्त संकलित स्नैपशॉट जोड़ते हैं: केवल शीर्ष पृष्ठ, केवल शीर्ष दावे, विरोधाभासों की संख्या, प्रश्नों की संख्या, विश्वसनीयता/ताज़गी विशेषक। यह वैकल्पिक है क्योंकि इससे प्रॉम्प्ट का स्वरूप बदलता है; यह मुख्यतः उन संदर्भ इंजनों या प्रॉम्प्ट संयोजन के लिए महत्वपूर्ण है जो मेमोरी पूरकों का स्पष्ट रूप से उपयोग करते हैं।

कॉन्फ़िगरेशन

कॉन्फ़िगरेशन को plugins.entries.memory-wiki.config के अंतर्गत रखें:
मुख्य टॉगल:

प्रति-एजेंट वॉल्ट

प्रत्येक कॉन्फ़िगर किए गए एजेंट को अलग विकी देने के लिए vault.scope को agent पर सेट करें। इस दायरे में, vault.path एक पैरेंट डायरेक्टरी है और OpenClaw सामान्यीकृत एजेंट id जोड़ता है:
यह ~/.openclaw/wiki/support और ~/.openclaw/wiki/marketing में निर्धारित होता है। यदि एजेंट दायरे में vault.path छोड़ा गया है, तो पैरेंट का डिफ़ॉल्ट ~/.openclaw/wiki होता है। इसलिए डिफ़ॉल्ट main एजेंट मौजूदा ~/.openclaw/wiki/main पथ बनाए रखता है। एजेंट टूल, संकलित प्रॉम्प्ट डाइजेस्ट और memory_search / memory_get के माध्यम से उपलब्ध कराया गया विकी पूरक सक्रिय एजेंट संदर्भ से वॉल्ट निर्धारित करते हैं। कई कॉन्फ़िगर किए गए एजेंटों वाले सेटअप में CLI और Gateway कॉल के लिए, openclaw wiki --agent <agentId> ... या Gateway अनुरोध के agentId द्वारा एजेंट स्पष्ट रूप से प्रदान करें। केवल एक एजेंट कॉन्फ़िगर होने पर कोई id न दिए जाने पर वही डिफ़ॉल्ट रहता है। ब्रिज मोड में, एजेंट-दायरे वाले आयात किसी सार्वजनिक मेमोरी कलाकृति को केवल तभी स्वीकार करते हैं जब उसके agentIds में चयनित एजेंट शामिल हो। किसी अन्य एजेंट के स्वामित्व वाली, स्वामित्व मेटाडेटा रहित या अज्ञात स्वामी वाली कलाकृतियाँ छोड़ दी जाती हैं। वैश्विक दायरा मौजूदा साझा-कलाकृति व्यवहार बनाए रखता है।
vault.scope बदलने से मौजूदा वॉल्ट की प्रतिलिपि नहीं बनती या उसका विभाजन नहीं होता। एजेंट दायरे में, स्पष्ट रूप से कॉन्फ़िगर किया गया vault.path एक पैरेंट डायरेक्टरी बन जाता है, इसलिए उत्पादन एजेंटों को स्विच करने से पहले मौजूदा पृष्ठों को सोच-समझकर स्थानांतरित या आयात करें। पहले वॉल्ट का बैकअप लें।प्रति-एजेंट वॉल्ट समान-प्रक्रिया वाली ज्ञान सीमा हैं, ऑपरेटिंग-सिस्टम सुरक्षा सीमा नहीं। होस्ट फ़ाइल सिस्टम की पहुँच वाले Plugin और सैंडबॉक्स-रहित टूल अब भी किसी अन्य एजेंट की डायरेक्टरी पढ़ सकते हैं। जब एजेंट एक-दूसरे पर भरोसा न करते हों, तो सैंडबॉक्सिंग या अलग Gateway प्रोफ़ाइल का उपयोग करें।

उदाहरण: QMD + ब्रिज मोड

जब रिकॉल के लिए QMD और अनुरक्षित ज्ञान परत के लिए memory-wiki चाहिए, तब इसका उपयोग करें। प्रत्येक परत केंद्रित रहती है: QMD रॉ नोट्स, सत्र निर्यात और अतिरिक्त संग्रहों को खोजने योग्य रखता है, जबकि memory-wiki स्थिर इकाइयों, दावों, डैशबोर्ड और स्रोत पृष्ठों को संकलित करता है।
यह सक्रिय मेमोरी रिकॉल की ज़िम्मेदारी QMD के पास रखता है, memory-wiki को संकलित पृष्ठों और डैशबोर्ड पर केंद्रित रखता है, और प्रॉम्प्ट स्वरूप को तब तक अपरिवर्तित रखता है जब तक संकलित डाइजेस्ट प्रॉम्प्ट जानबूझकर सक्षम न किए जाएँ।

CLI

wiki okf import, wiki apply metadata, wiki unsafe-local import, wiki chatgpt import / wiki chatgpt rollback, और संपूर्ण wiki obsidian उपकमांड सेट सहित पूरे कमांड संदर्भ के लिए CLI: विकी देखें।

Obsidian समर्थन

जब vault.renderMode, obsidian होता है, तो Plugin Obsidian-अनुकूल Markdown लिखता है और स्थिति जाँचने, वॉल्ट में खोजने, पृष्ठ खोलने, कमांड लागू करने और दैनिक नोट पर जाने के लिए वैकल्पिक रूप से आधिकारिक obsidian CLI का उपयोग कर सकता है। यह वैकल्पिक है; Obsidian के बिना भी विकी नेटिव मोड में काम करता है। एजेंट-दायरे वाले वॉल्ट अब भी Obsidian-अनुकूल Markdown का उपयोग कर सकते हैं, लेकिन कॉन्फ़िगरेशन सत्यापन vault.scope: "agent" के साथ obsidian.useOfficialCli: true को अस्वीकार करता है। वर्तमान obsidian.vaultName सेटिंग वैश्विक है और प्रत्येक एजेंट के लिए अलग Obsidian वॉल्ट नहीं चुन सकती। इसके बजाय विकी टूल और CLI संचालन का उपयोग करें, या Obsidian द्वारा संचालित विकी को वैश्विक दायरे में रखें।

अनुशंसित कार्यप्रवाह

1

स्मरण के लिए सक्रिय मेमोरी Plugin बनाए रखें

स्मरण, संवर्धन और Dreaming का स्वामित्व कॉन्फ़िगर किए गए मेमोरी बैकएंड के पास रहता है।
2

memory-wiki सक्षम करें

जब तक आप स्पष्ट रूप से ब्रिज मोड नहीं चाहते, isolated मोड से शुरू करें।
3

जब उद्गम महत्वपूर्ण हो, तब wiki_search / wiki_get का उपयोग करें

जब आपको विकी-विशिष्ट रैंकिंग या पृष्ठ-स्तरीय विश्वास संरचना चाहिए, तो memory_search के बजाय इन्हें प्राथमिकता दें।
4

सीमित संश्लेषण या मेटाडेटा अपडेट के लिए wiki_apply का उपयोग करें

प्रबंधित जनरेट किए गए ब्लॉक को हाथ से संपादित करने से बचें।
5

महत्वपूर्ण बदलावों के बाद wiki_lint चलाएँ

यह विरोधाभासों, अनसुलझे प्रश्नों और उद्गम की कमियों का पता लगाता है।
6

पुरानी/विरोधाभासी सामग्री की दृश्यता के लिए डैशबोर्ड चालू करें

render.createDashboards: true (डिफ़ॉल्ट) सेट करें।

संबंधित दस्तावेज़