【English | 中文】
OpenClaw is an open-source autonomous AI virtual assistant originally developed by Austrian software engineer Peter Steinberger. First released on GitHub as "Clawdbot" in November 2025, later renamed to "Moltbot" and finally "OpenClaw" in January 2026, the project has since grown to over 200K GitHub stars and sparked a global wave of adoption. OpenClaw can be deployed locally on macOS/Windows, calls various AI models and APIs, and receives user instructions via WhatsApp, Telegram, Signal, Discord and other messaging platforms to autonomously handle tasks like scheduling, messaging, file management, and coding.
A key differentiator of OpenClaw is its persistent memory — it stores configuration data and interaction history locally, enabling cross-session continuity. However, the design, security, and scalability of this memory system remain an active frontier for the community.
Awesome-OpenClaw-Memory is a curated collection dedicated to memory systems, architectures, and best practices within the OpenClaw ecosystem. This repository gathers research papers, open-source memory frameworks, and practical implementations relevant to enhancing OpenClaw's memory capabilities.
Whether you're extending OpenClaw's built-in local memory, integrating external frameworks like Mem0 or Zep, or researching agent memory security (e.g., memory poisoning attacks) — this is your one-stop resource.
Our mission is to build the most comprehensive knowledge base for OpenClaw memory systems, serving both researchers exploring agent memory frontiers and practitioners deploying memory-enhanced OpenClaw agents in production. We aim to accelerate the development of OpenClaw's persistent memory capabilities — from local interaction history to scalable, secure, cross-session knowledge management.
This repository focuses on memory mechanisms and system designs that extend or augment OpenClaw's cognitive capabilities, encompassing both theoretical research and engineering practices.
🌀 Included Content (In Scope)
- Memory architecture designs for OpenClaw agents
- OpenClaw-specific memory skills and plugins
- External memory frameworks integrable with OpenClaw (Mem0, Zep, Letta, LangMem, etc.)
- Memory management strategies (writing, retrieval, updating, forgetting, compression)
- Memory security (memory poisoning, integrity checks, sandboxing)
- Multi-agent shared memory in OpenClaw workflows
- Benchmarks and evaluation methods for agent memory
- Best practices and production patterns
🌀 Excluded Content (Out of Scope)
- General LLM pre-training research without agent memory relevance
- Traditional databases or retrieval systems unrelated to AI agents
- Non-agent memory systems without transfer value to OpenClaw
- 2026-03-22 - 🎉 Added OpenViking (17K+ stars, ByteDance/Volcengine context database for AI Agents)
- 2026-03-22 - 🎉 Added mem9 (ContextEngine-native persistent memory by PingCAP/TiDB founder)
- 2026-03-21 - 🎉 Added 5 OpenClaw memory plugins (memory-lancedb-pro, openclaw-supermemory, MemOS-Cloud, graph-memory, openclaw-memory-mem0)
- 2026-03-21 - 🎉 Initial release with 2 OpenClaw papers, 22 open-source memory systems, and the Adam Framework
- Introduction
- Goal of Repository
- Project Scope
- Recent Updates
- Core Concepts
- OpenClaw Related Papers
- Resource
- Make a Contribution
- Star Trends
-
OpenClaw's Built-in Memory: OpenClaw stores configuration data and interaction history locally on the user's device, providing persistent memory across sessions. This local-first design ensures privacy but introduces challenges in scalability, retrieval accuracy, and memory management as interaction history grows.
-
Memory Layers:
- Session Memory: The active context during a single conversation session, including current task state and intermediate reasoning.
- Interaction History: Locally stored records of past conversations and task executions across messaging platforms (WhatsApp, Telegram, Signal, Discord), forming OpenClaw's native long-term memory.
- Configuration Memory: Persistent user preferences, API credentials, skill configurations, and behavioral settings.
-
Memory Challenges for OpenClaw:
- Scalability: As interaction history accumulates over months of use, efficient retrieval becomes critical.
- Cross-platform Consistency: Maintaining coherent memory across multiple messaging platforms.
- Memory Security: Autonomous agents face threats like memory poisoning (injecting malicious persistent data via crafted messages), intent drift (memory-induced behavioral changes), and privacy leakage — as highlighted in the "Taming OpenClaw" paper.
- Memory Enhancement: Integrating external memory frameworks (Mem0, Zep, Letta, etc.) to augment OpenClaw's native local storage with vector search, knowledge graphs, and semantic retrieval.
Systems below are ordered by publication date:
Plugins below are purpose-built for the OpenClaw ecosystem, ordered by star count:
| Plugin | Stars | Description | Tech |
|---|---|---|---|
| OpenViking | Open-source context database for AI Agents by ByteDance/Volcengine — file system paradigm with L0/L1/L2 hierarchical context delivery, VikingDB vector search, self-evolving skills | Python | |
| memory-lancedb-pro | Production-grade LanceDB hybrid retrieval memory — Vector + BM25 search, Cross-Encoder rerank, multi-scope isolation, management CLI | TypeScript | |
| openclaw-supermemory | Supermemory cloud-based auto-recall memory — long-term memory and recall for OpenClaw agents | TypeScript | |
| mem9 | Persistent cloud memory powered by TiDB — ContextEngine lifecycle hooks, per-agent data isolation ("one claw one database"), Memory Space visualization. By Edward Huang (PingCAP/TiDB co-founder) | TypeScript, Go | |
| MemOS-Cloud-OpenClaw-Plugin | Official MemOS Cloud plugin — lifecycle memory with context recall before execution and conversation save after each run | JavaScript | |
| graph-memory | Knowledge graph context engine — extracts structured triples, compresses context 75%, enables cross-session experience reuse | TypeScript | |
| openclaw-memory-mem0 | Self-hosted Mem0 REST API integration — semantic extraction memory for OpenClaw | TypeScript |
- Description: Open-source context database for AI Agents by ByteDance/Volcengine (火山引擎). Designed specifically for OpenClaw and similar agents, with 17K+ GitHub stars.
- Key Features:
- File System Paradigm: Manages agent context (memory, resources, skills) through a unified file system metaphor — hierarchical, browsable, and debuggable.
- L0/L1/L2 Three-Layer Loading: L0 (always loaded core context), L1 (on-demand directory-level context), L2 (deep retrieval from VikingDB vector search) — progressive disclosure instead of monolithic injection.
- Self-Evolving Skills: Automatically distills reusable skills from accumulated memory and interaction patterns.
- Visual Memory Traces: Directory-recursive retrieval turns memory from black-box to white-box.
- Backend: VikingDB (ByteDance vector database), requires Volcengine account
- Links: GitHub | Website
- Description: Persistent cloud memory for OpenClaw agents, powered by TiDB Cloud. Founded by Edward Huang (黄东旭), co-founder of PingCAP/TiDB. The first OpenClaw memory plugin to integrate with the ContextEngine lifecycle API (OpenClaw 3.7+).
- Key Features:
- ContextEngine Hooks:
before_prompt_build(inject memories before each LLM call),before_reset(save session summary),agent_end(capture final response) — participates in the full memory lifecycle, not just post-hoc recall. - "One Claw One Database": Per-agent isolated storage with independent encryption and keys, not row-level tenant isolation.
- Memory Space: Web-based visualization of all persisted memories at mem9.ai — transparent, inspectable memory.
- Multi-Agent Support: Claude Code, OpenCode, and OpenClaw share the same memory pool via stateless plugins + cloud server.
- Self-Hostable: Deploy mnemo-server with your own TiDB/MySQL instance for full data sovereignty.
- ContextEngine Hooks:
- Tools:
memory_store,memory_search,memory_get,memory_update,memory_delete - Install: Tell your OpenClaw:
请阅读 https://mem9.ai/SKILL.md 并按照说明安装和配置 mem9 - Links: GitHub | Website
- Description: 5-layer persistent memory and coherence architecture for local AI assistants built on OpenClaw. Solves AI amnesia (cross-session) and within-session coherence degradation.
- Layers: Vault injection, mid-session memory search, neural graph (7219+ neurons), nightly Gemini reconciliation, coherence monitor with scratchpad dropout detection.
- Validated: 353 sessions, 6619 message turns, 8 months production use on a live business by a non-developer.
- Platform: Windows/macOS/Linux, OpenClaw, local-first, model-agnostic.
- Links: GitHub | Live Demo | Interactive Proof
We welcome contributions from the community! Please submit issues or pull requests.
Issue Template:
Title: [Paper/Project Title]
Type: [Paper / Framework / Skill / Best Practice]
Published: [arXiv / Conference / GitHub]
Summary:
- Innovation:
- Relevance to OpenClaw:
- Significant Result:
Pull Request Guidelines:
- Add new entries to the appropriate section
- Include a brief description for each entry
- Ensure links are valid and accessible
- Follow the existing format and style
This project is licensed under the MIT License.
🦞 Built with ❤️ for the OpenClaw community
