यह कैसे काम करता है
आपके एजेंट के पास memory से संबंधित तीन फ़ाइलें होती हैं:MEMORY.md— दीर्घकालिक memory। टिकाऊ तथ्य, प्राथमिकताएँ, और निर्णय। हर DM session की शुरुआत में लोड की जाती है।memory/YYYY-MM-DD.md(याmemory/YYYY-MM-DD-<slug>.md) — दैनिक नोट्स। चल रहा context और अवलोकन। आज और कल के नोट्स अपने-आप लोड होते हैं, और/newया/resetपर bundled session-memory hook द्वारा लिखे गए slugged variants अब date-only फ़ाइल के साथ चुने जाते हैं।DREAMS.md(वैकल्पिक) — मानव समीक्षा के लिए Dream Diary और dreaming sweep सारांश, जिनमें grounded historical backfill entries शामिल हैं।
~/.openclaw/workspace)।
क्या कहाँ जाता है
MEMORY.md संक्षिप्त, curated layer है। इसे टिकाऊ तथ्यों,
प्राथमिकताओं, स्थायी निर्णयों, और छोटे सारांशों के लिए उपयोग करें जिन्हें
मुख्य private session की शुरुआत में उपलब्ध होना चाहिए। यह raw transcript,
daily log, या exhaustive archive के लिए नहीं है।
memory/YYYY-MM-DD.md फ़ाइलें working layer हैं। इन्हें विस्तृत दैनिक
नोट्स, अवलोकन, session summaries, और raw context के लिए उपयोग करें जो बाद में
भी उपयोगी हो सकता है। ये फ़ाइलें memory_search और memory_get के लिए indexed होती हैं,
लेकिन हर turn पर normal bootstrap prompt में inject नहीं की जातीं।
समय के साथ, एजेंट से अपेक्षा है कि वह daily notes से उपयोगी सामग्री को
MEMORY.md में distill करे और stale long-term entries हटाए। generated workspace
instructions और Heartbeat flow इसे समय-समय पर कर सकते हैं; आपको हर remembered detail के लिए
MEMORY.md को manually edit करने की आवश्यकता नहीं है।
यदि MEMORY.md bootstrap file budget से आगे बढ़ जाता है, तो OpenClaw फ़ाइल को
डिस्क पर intact रखता है लेकिन model context में injected copy को truncate कर देता है। इसे
एक संकेत मानें कि detailed material को वापस memory/*.md में ले जाएँ, केवल
durable summary को MEMORY.md में रखें, या यदि आप स्पष्ट रूप से अधिक prompt budget खर्च करना
चाहते हैं तो bootstrap limits बढ़ाएँ। raw बनाम injected sizes और truncation status देखने के लिए
/context list, /context detail, या openclaw doctor का उपयोग करें।
Action-sensitive memories
अधिकांश memories को सामान्य Markdown notes के रूप में लिखा जा सकता है। लेकिन कुछ memories यह प्रभावित करती हैं कि एजेंट को बाद में क्या करना चाहिए। उनके लिए, केवल तथ्य ही नहीं, बल्कि यह भी capture करें कि note पर act करना कब सुरक्षित है। जब कोई note इनसे संबंधित हो, तो उस action boundary को capture करें:- approval या permission requirements,
- temporary constraints,
- किसी अन्य session, thread, या व्यक्ति को handoffs,
- expiry conditions,
- safe-to-act timing,
- source या owner authority,
- किसी आकर्षक action से बचने के निर्देश।
- भविष्य के behavior को क्या बदलता है,
- यह कब या किस condition में लागू होती है,
- यह कब expire होती है, या action को क्या unlock करता है,
- एजेंट को क्या करने से बचना चाहिए,
- source या owner कौन है, यदि वह trust या authority को प्रभावित करता है।
Inferred commitments
कुछ भविष्य के follow-ups durable facts नहीं होते। यदि आप कल होने वाले interview का उल्लेख करते हैं, तो उपयोगी memory “interview के बाद check in करें” हो सकती है, न कि “इसेMEMORY.md में हमेशा के लिए store करें।”
Commitments इस case के लिए opt-in, short-lived follow-up memories
हैं। OpenClaw उन्हें hidden background pass में infer करता है, उन्हें
उसी agent और channel तक scope करता है, और due check-ins Heartbeat के माध्यम से deliver करता है।
Explicit reminders अब भी scheduled tasks का उपयोग करते हैं।
Memory tools
एजेंट के पास memory के साथ काम करने के लिए दो tools हैं:memory_search— semantic search का उपयोग करके relevant notes ढूँढता है, तब भी जब wording original से अलग हो।memory_get— किसी specific memory file या line range को पढ़ता है।
memory-core)।
Memory Wiki companion Plugin
यदि आप चाहते हैं कि durable memory केवल raw notes के बजाय maintained knowledge base की तरह behave करे, तो bundledmemory-wiki Plugin का उपयोग करें।
memory-wiki durable knowledge को wiki vault में compile करता है, जिसमें शामिल हैं:
- deterministic page structure
- structured claims और evidence
- contradiction और freshness tracking
- generated dashboards
- agent/runtime consumers के लिए compiled digests
wiki_search,wiki_get,wiki_apply, औरwiki_lintजैसे wiki-native tools
memory-wiki उसके साथ एक provenance-rich
knowledge layer जोड़ता है।
Memory Wiki देखें।
Memory search
जब embedding provider configured होता है, तोmemory_search hybrid
search का उपयोग करता है — vector similarity (semantic meaning) को keyword matching
(IDs और code symbols जैसे exact terms) के साथ जोड़कर। supported provider में से किसी के लिए
API key होने पर यह out of the box काम करता है।
OpenClaw default रूप से OpenAI embeddings का उपयोग करता है। Gemini, Voyage,
Mistral, local, Ollama, Bedrock, GitHub Copilot, या OpenAI-compatible
embeddings उपयोग करने के लिए
agents.defaults.memorySearch.provider को explicitly set करें।Memory backends
Builtin (default)
SQLite-based। keyword search, vector similarity, और
hybrid search के साथ out of the box काम करता है। कोई extra dependencies नहीं।
QMD
reranking, query expansion, और workspace के बाहर directories को index करने की क्षमता वाला
local-first sidecar।
Honcho
user modeling, semantic search, और
multi-agent awareness वाली AI-native cross-session memory। Plugin install।
LanceDB
OpenAI-compatible embeddings, auto-recall,
auto-capture, और local Ollama embedding support के साथ bundled LanceDB-backed memory।
Knowledge wiki layer
Memory Wiki
claims, dashboards, bridge mode, और Obsidian-friendly workflows के साथ durable memory को provenance-rich wiki vault में compile करता है।
Automatic memory flush
Compaction आपकी conversation को summarize करने से पहले, OpenClaw एक silent turn चलाता है जो एजेंट को important context को memory files में save करने की याद दिलाता है। यह default रूप से on है — आपको कुछ भी configure करने की आवश्यकता नहीं है। उस housekeeping turn को local model पर रखने के लिए, exact memory-flush model override set करें:Dreaming
Dreaming memory के लिए optional background consolidation pass है। यह short-term signals collect करता है, candidates को score करता है, और केवल qualified items को long-term memory (MEMORY.md) में promote करता है।
इसे long-term memory को high signal रखने के लिए design किया गया है:
- Opt-in: default रूप से disabled।
- Scheduled: enabled होने पर,
memory-corefull dreaming sweep के लिए एक recurring Cron job auto-manage करता है। - Thresholded: promotions को score, recall frequency, और query diversity gates pass करने होते हैं।
- Reviewable: phase summaries और diary entries मानव समीक्षा के लिए
DREAMS.mdमें लिखी जाती हैं।
Grounded backfill and live promotion
dreaming system में अब दो closely related review lanes हैं:- Live dreaming
memory/.dreams/के अंतर्गत short-term dreaming store से काम करता है और यही normal deep phase उपयोग करता है जब तय करता है कि क्याMEMORY.mdमें graduate हो सकता है। - Grounded backfill historical
memory/YYYY-MM-DD.mdnotes को standalone day files के रूप में पढ़ता है और structured review output कोDREAMS.mdमें लिखता है।
MEMORY.md को manually edit किए।
जब आप उपयोग करते हैं:
DREAMS.mdhuman review surface बना रहता है।- short-term store machine-facing ranking surface बना रहता है।
MEMORY.mdअब भी केवल deep promotion द्वारा लिखा जाता है।
CLI
आगे पढ़ें
- Builtin memory engine: default SQLite backend।
- QMD memory engine: advanced local-first sidecar।
- Honcho memory: AI-native cross-session memory।
- Memory LanceDB: OpenAI-compatible embeddings वाला LanceDB-backed Plugin।
- Memory Wiki: compiled knowledge vault और wiki-native tools।
- Memory search: search pipeline, providers, और tuning।
- Dreaming: short-term recall से long-term memory में background promotion।
- Memory configuration reference: सभी config knobs।
- Compaction: Compaction memory के साथ कैसे interact करता है।