From fa43ea7607956259946a6ab8b3938406e3849b0f Mon Sep 17 00:00:00 2001 From: sunqi Date: Thu, 9 Jul 2026 00:26:14 +0800 Subject: [PATCH 1/6] docs: rewrite README around three usage scenarios with bilingual support - Rewrite README.md around three entry points: self-host, OpenClaw cloud plugin, local plugin - Add Performance block with 10 benchmark scores from 2026-07-02 evaluation report - Add "What MemOS Is For" section and decision table for scenario navigation - Add Chinese README_ZH.md with bidirectional language switch links - Use official slogan "Intelligence begins with memory" as tagline Co-authored-by: Cursor --- README.md | 496 ++++++++++++--------------------------------------- README_ZH.md | 191 ++++++++++++++++++++ 2 files changed, 304 insertions(+), 383 deletions(-) create mode 100644 README_ZH.md diff --git a/README.md b/README.md index 2bc08cef0..5e47a818e 100644 --- a/README.md +++ b/README.md @@ -1,423 +1,172 @@ -
- - MemOS Banner - +# MemOS -

- MemOS Logo  - MemOS 2.0 Stardust(星尘) +Intelligence begins with memory. -

+Give your AI persistent memory and the ability to grow. -

-
- Docs - ArXiv - X - Discord - Resources -

+Scalable memory services for AI applications — keeping models consistent and personalized across tasks and scenarios. -

- 🏆 Leading Performance Across Agent and User Memory Benchmarks
- 🤖 OpenClaw Task Completion Improves from 36.63% to 50.87%
- 🎯 92.34 on LoCoMo and 93.40 on LongMemEval
- 📊 Unified Evaluation Across 14 Commercial Memory Products - +[Docs](https://memos-docs.openmem.net/home/overview/) · [Paper](https://arxiv.org/abs/2507.03724) · [Discord](https://discord.gg/Txbx3gebZR) · [X](https://x.com/MemOS_dev) · [Issues](https://github.com/MemTensor/MemOS/issues) -

+**English** | [中文](README_ZH.md) -
+## Performance - +MemOS leads across multiple benchmarks — evaluated against mainstream commercial memory products across 5 user memory and 5 agent memory tasks. - - +| Benchmark | Score | +| --------------- | ----- | +| LoCoMo | 88.83 | +| LongMemEval | 89.20 | +| PersonaMem v2 | 40.58 | +| HaluMem | 80.91 | +| BEAM-10M | 56.75 | +| GDPVal | 62.07 | +| LiveCodeBench | 64.96 | +| OmniMath | 61.00 | +| SWE-Bench | 38.46 | +| BrowseComp-Plus | 23.85 | -## 🧠 MemOS Plugin: Persistent Memory for Your AI Agents ✨ -
- -MemOS Plugin Banner +Evaluated via OmniMemEval — [https://github.com/MemTensor/OmniMemEval](https://github.com/MemTensor/OmniMemEval). -Your lobsters and Hermes Agents now have **the best** memory system — choose ***Cloud Service*** or ***Self-hosted*** to get started 🏃🏻 +## What MemOS Is For -| 🔌 Plugin |
💡 Core Features
| 🧩 Resources | -| :----: | :--- | :---: | -| 🧠 [**memos-local-plugin 2.0**](https://github.com/hijzy/MemOS/tree/main/apps/memos-local-plugin) |
  • One local-first memory core for **Hermes Agent** and **OpenClaw**.
  • Self-evolving memory: L1 trace, L2 policy, L3 world model,
    and crystallized Skills driven by feedback.
| 🌐 [Website](https://memos-claw.openmem.net/) · 📖 [Docs](https://memos-docs.openmem.net/cn/openclaw/local_plugin) · 🐙 [GitHub](https://github.com/hijzy/MemOS/tree/main/apps/memos-local-plugin) · 📦 [NPM](https://www.npmjs.com/package/@memtensor/memos-local-plugin) | -| ☁️ [**OpenClaw Cloud Plugin**](https://x.com/MemOS_dev/status/2019254160919769171?s=20) |
  • [Reduces token usage by 72%.](https://x.com/MemOS_dev/status/2020854044583924111)
  • [Multi-agent memory sharing by `user_id`.](https://x.com/MemOS_dev/status/2020538135487062094)
| 🖥️ [MemOS Dashboard](https://memos-dashboard.openmem.net/login/) · 📖 [Full Tutorial](https://memos-docs.openmem.net/openclaw/guide#_4-update-plugin) | +MemOS gives AI agents long-term memory. Common uses: -> **🐳 Docker Deployment Note**: When running memos-local-plugin in Docker containers, you must specify the config location using `MEMOS_HOME` environment variable or `--home` CLI flag. See [Docker Configuration Guide](./apps/memos-local-plugin/README.md#docker-deployment) for details. +- AI assistants with consistent, context-rich conversations +- Customer support that recalls past tickets and user history +- Personalized agents that adapt to individual preferences +- Multi-agent collaboration with shared or isolated memory -
-
-## 👾 MemOS: Memory Operating System for LLM & AI Agents -**MemOS** is a Memory Operating System for LLMs and AI agents that unifies **store / retrieve / manage** for long-term memory, enabling **context-aware and personalized** interactions with **KB**, **multi-modal**, **tool memory**, and **enterprise-grade** optimizations built in. +## Quick Start +MemOS is built around three entry points. Pick the one that matches your scenario. -### Key Features -- **Unified Memory API**: A single API to add, retrieve, edit, and delete memory—structured as a graph, inspectable and editable by design, not a black-box embedding store. -- **Multi-Modal Memory**: Natively supports text, images, tool traces, and personas, retrieved and reasoned together in one memory system. -- **Multi-Cube Knowledge Base Management**: Manage multiple knowledge bases as composable memory cubes, enabling isolation, controlled sharing, and dynamic composition across users, projects, and agents. -- **Asynchronous Ingestion via MemScheduler**: Run memory operations asynchronously with millisecond-level latency for production stability under high concurrency. -- **Memory Feedback & Correction**: Refine memory with natural-language feedback—correcting, supplementing, or replacing existing memories over time. +| | Self-Host | OpenClaw Cloud Plugin | Local Plugin | +| ------------ | ------------------ | ------------------------ | ------------------------------- | +| Best for | Teams on own infra | OpenClaw users, zero ops | Hermes/OpenClaw, 100% on-device | +| Setup | docker compose up | openclaw plugins install | npm install + config | +| Infra needed | Neo4j + Qdrant | None (uses MemOS Cloud) | None (local SQLite) | +| Data lives | Your servers | MemOS Cloud | Your machine | -### News -- **2026-07-02** · 🏆 **MemOS Advances Agent and User Memory Benchmarks** - With MemOS, **OpenClaw** improves average task completion from **36.63% to 50.87%** across five agent tasks. MemOS also achieves **92.34 on LoCoMo** and **93.40 on LongMemEval**, and leads in **OmniMemEval**, a unified evaluation of 14 commercial memory products across ten datasets. -- **2026-05-09** · 🧠 **memos-local-plugin 2.0** - Official local memory plugin for **Hermes Agent** and **OpenClaw**. One core powers self-evolving memory across L1 traces, L2 policies, L3 world models, and crystallized Skills, with local-first storage and feedback-driven retrieval. +### 1. Self-Host the MemOS Service -- **2026-04-10** · 👧🏻 **MemOS Hermes Agent Local Plugin** - Official Hermes Agent memory plugins launched: Hybrid retrieval (FTS5 + vector), smart dedup, tiered skill evolution, multi-agent collaboration. 100% local, zero cloud dependency. - -- **2026-03-08** · 🦞 **MemOS OpenClaw Plugin — Cloud & Local** - Official OpenClaw memory plugins launched. **Cloud Plugin**: hosted memory service with 72% lower token usage and multi-agent memory sharing ([MemOS-Cloud-OpenClaw-Plugin](https://github.com/MemTensor/MemOS-Cloud-OpenClaw-Plugin)). **Local Plugin** (`v1.0.0`): 100% on-device memory with persistent SQLite, hybrid search (FTS5 + vector), task summarization & skill evolution, multi-agent collaboration, and a full Memory Viewer dashboard. +You want to run MemOS as a REST service on your own machine or cluster. -- **2025-12-24** · 🎉 **MemOS v2.0: Stardust (星尘) Release** - Comprehensive KB (doc/URL parsing + cross-project sharing), memory feedback & precise deletion, multi-modal memory (images/charts), tool memory for agent planning, Redis Streams scheduling + DB optimizations, streaming/non-streaming chat, MCP upgrade, and lightweight quick/full deployment. -
- ✨ New Features - - **Knowledge Base & Memory** - - Added knowledge base support for long-term memory from documents and URLs - - **Feedback & Memory Management** - - Added natural language feedback and correction for memories - - Added memory deletion API by memory ID - - Added MCP support for memory deletion and feedback - - **Conversation & Retrieval** - - Added chat API with memory-aware retrieval - - Added memory filtering with custom tags (Cloud & Open Source) - - **Multimodal & Tool Memory** - - Added tool memory for tool usage history - - Added image memory support for conversations and documents - -
- -
- 📈 Improvements - - **Data & Infrastructure** - - Upgraded database for better stability and performance - - **Scheduler** - - Rebuilt task scheduler with Redis Streams and queue isolation - - Added task priority, auto-recovery, and quota-based scheduling - - **Deployment & Engineering** - - Added lightweight deployment with quick and full modes - -
- -
- 🐞 Bug Fixes - - **Memory Scheduling & Updates** - - Fixed legacy scheduling API to ensure correct memory isolation - - Fixed memory update logging to show new memories correctly - -
- -- **2025-08-07** · 🎉 **MemOS v1.0.0 (MemCube) Release** - First MemCube release with a word-game demo, LongMemEval evaluation, BochaAISearchRetriever integration, improved search capabilities, and the official Playground launch. - -
- ✨ New Features - - **Playground** - - Expanded Playground features and algorithm performance. - - **MemCube Construction** - - Added a text game demo based on the MemCube novel. - - **Extended Evaluation Set** - - Added LongMemEval evaluation results and scripts. - -
- -
- 📈 Improvements - - **Plaintext Memory** - - Integrated internet search with Bocha. - - Expanded graph database support. - - Added contextual understanding for the tree-structured plaintext memory search interface. - -
- -
- 🐞 Bug Fixes - - **KV Cache Concatenation** - - Fixed the concat_cache method. - - **Plaintext Memory** - - Fixed graph search-related issues. - -
- -- **2025-07-07** · 🎉 **MemOS v1.0: Stellar (星河) Preview Release** - A SOTA Memory OS for LLMs is now open-sourced. -- **2025-07-04** · 🎉 **MemOS Paper Release** - [MemOS: A Memory OS for AI System](https://arxiv.org/abs/2507.03724) is available on arXiv. -- **2024-07-04** · 🎉 **Memory3 Model Release at WAIC 2024** - The Memory3 model, featuring a memory-layered architecture, was unveiled at the 2024 World Artificial Intelligence Conference. - -
- -## 🚀 Quick-start Guide - -### ☁️ 1、Cloud API (Hosted) -#### Get API Key -- Sign up on the [MemOS dashboard](https://memos-dashboard.openmem.net/cn/quickstart/?source=landing) -- Go to **API Keys** and copy your key - -#### Next Steps -- [MemOS Cloud Getting Started](https://memos-docs.openmem.net/memos_cloud/quick_start/) - Connect to MemOS Cloud and enable memory in minutes. -- [MemOS Cloud Platform](https://memos.openmem.net/?from=/quickstart/) - Explore the Cloud dashboard, features, and workflows. - -### 🖥️ 2、Self-Hosted (Local/Private) -1. Get the repository. - ```bash - git clone https://github.com/MemTensor/MemOS.git - cd MemOS - pip install -r ./docker/requirements.txt - ``` -2. Configure `docker/.env.example` and copy to `MemOS/.env` - - The `OPENAI_API_KEY`,`MOS_EMBEDDER_API_KEY`,`MEMRADER_API_KEY` and others can be applied for through [`BaiLian`](https://bailian.console.aliyun.com/?spm=a2c4g.11186623.0.0.2f2165b08fRk4l&tab=api#/api). - - Fill in the corresponding configuration in the `MemOS/.env` file. - - Supported LLM providers: **OpenAI**, **Azure OpenAI**, **Qwen (DashScope)**, **DeepSeek**, **MiniMax**, **Ollama**, **HuggingFace**, **vLLM**. Set `MOS_CHAT_MODEL_PROVIDER` to select the backend (e.g., `openai`, `qwen`, `deepseek`, `minimax`). -3. Start the service. - -- Launch via Docker - ###### Tips: Please ensure that Docker Compose is installed successfully and that you have navigated to the docker directory (via `cd docker`) before executing the following command. - ```bash - # Enter docker directory - docker compose up - ``` - ##### For detailed steps, see the[`Docker Reference`](https://docs.openmem.net/open_source/getting_started/rest_api_server/#method-1-docker-use-repository-dependency-package-imagestart-recommended-use). - -- Launch via the uvicorn command line interface (CLI) - ###### Tips: Please ensure that Neo4j and Qdrant are running before executing the following command. - ```bash - cd src - uvicorn memos.api.server_api:app --host 0.0.0.0 --port 8001 --workers 1 - ``` - ##### For detailed integration steps, see the [`CLI Reference`](https://docs.openmem.net/open_source/getting_started/rest_api_server/#method-3client-install-with-CLI). - - - -### Basic Usage (Self-Hosted) - - Add User Message - ```python - import requests - import json - - data = { - "user_id": "8736b16e-1d20-4163-980b-a5063c3facdc", - "mem_cube_id": "b32d0977-435d-4828-a86f-4f47f8b55bca", - "messages": [ - { - "role": "user", - "content": "I like strawberry" - } - ], - "async_mode": "sync" - } - headers = { - "Content-Type": "application/json" - } - url = "http://localhost:8000/product/add" - - res = requests.post(url=url, headers=headers, data=json.dumps(data)) - print(f"result: {res.json()}") - ``` - - Search User Memory - ```python - import requests - import json - - data = { - "query": "What do I like", - "user_id": "8736b16e-1d20-4163-980b-a5063c3facdc", - "mem_cube_id": "b32d0977-435d-4828-a86f-4f47f8b55bca" - } - headers = { - "Content-Type": "application/json" - } - url = "http://localhost:8000/product/search" - - res = requests.post(url=url, headers=headers, data=json.dumps(data)) - print(f"result: {res.json()}") - ``` - -
- - -## FAQ - -### What is MemOS? - -MemOS is a **Memory Operating System** for LLMs and AI agents that unifies store/retrieve/manage for long-term memory. It enables context-aware and personalized interactions with knowledge base (KB), multi-modal memory, tool memory, and enterprise-grade optimizations built in. - -### What are the benchmark results? - -MemOS achieves **92.34 on LoCoMo** and **93.40 on LongMemEval** for User Memory, while improving **OpenClaw** average task completion from **36.63% to 50.87%** across five Agent Memory tasks. For details, see [OmniMemEval](https://github.com/MemTensor/OmniMemEval), our unified evaluation framework for benchmarking 14 commercial memory products across ten datasets. - - -### How does MemOS compare to other memory solutions? - -| Feature | MemOS | mem0 | LangChain Memory | Letta | -|---------|-------|------|------------------|-------| -| Multi-Modal Memory | ✅ Text/Images/Tools | ❌ Text only | ❌ Text only | ❌ Text only | -| Knowledge Base | ✅ Multi-Cube KB | ❌ No KB | ⚠️ RAG only | ❌ No KB | -| Memory Feedback | ✅ Natural language | ❌ No | ❌ No | ❌ No | -| Graph Memory | ✅ Inspectable/Editable | ❌ Black-box | ❌ Black-box | ❌ Limited | -| Async Ingestion | ✅ MemScheduler | ❌ No | ❌ No | ❌ No | -| Open Source | ✅ Apache 2.0 | ✅ MIT | ✅ Apache | ✅ MIT | -| ArXiv Paper | ✅ 2507.03724 | ❌ No | ❌ No | ❌ No | - -### What are the key features? - -| Feature | Description | -|---------|-------------| -| **Unified Memory API** | Single API for add/retrieve/edit/delete, graph-structured, inspectable | -| **Multi-Modal Memory** | Text, images, tool traces, personas retrieved together | -| **Multi-Cube KB** | Composable memory cubes for users/projects/agents | -| **Async Ingestion** | MemScheduler with millisecond latency | -| **Memory Feedback** | Natural-language correction/supplement/replacement | -| **Self-evolving Memory** | L1 traces, L2 policies, L3 world model, crystallized Skills | - -### What deployment options are available? - -| Option | Description | -|--------|-------------| -| **Cloud API** | Hosted service at memos.openmem.net | -| **Self-Hosted** | Local/private deployment via Docker | -| **Quick Mode** | Lightweight deployment | -| **Full Mode** | Complete deployment | - -### How do I get started with Cloud API? - -1. Sign up at [MemOS dashboard](https://memos-dashboard.openmem.net/) -2. Go to **API Keys** and copy your key -3. Use the Cloud API for memory operations - -See [Cloud Getting Started](https://memos-docs.openmem.net/memos_cloud/quick_start/). - -### How do I self-host MemOS? +**Option A — Docker (recommended):** ```bash -# Clone git clone https://github.com/MemTensor/MemOS.git cd MemOS +cp docker/.env.example .env # fill in your API keys in .env +cd docker +docker compose up # starts MemOS API + Neo4j + Qdrant +``` -# Install dependencies -pip install -r ./docker/requirements.txt +The API is served at `http://localhost:8000`. -# Configure .env (OPENAI_API_KEY, etc.) -cp docker/.env.example MemOS/.env +**Option B — Run with uvicorn (without Docker):** -# Start service -# See docs for full setup +```bash +git clone https://github.com/MemTensor/MemOS.git +cd MemOS +cp docker/.env.example .env # fill in your API keys in .env +# Ensure Neo4j and Qdrant are running, then: +cd src +uvicorn memos.api.server_api:app --host 0.0.0.0 --port 8000 --workers 1 ``` -### What LLM providers are supported? +See `[docker/.env.example](./docker/.env.example)` for all configuration options (LLM provider, embedder, vector DB, graph DB, scheduler). The full deployment guide is at [https://memos-docs.openmem.net/open_source/getting_started/rest_api_server/](https://memos-docs.openmem.net/open_source/getting_started/rest_api_server/). + +**Try the API:** + +```python +import requests, json + +headers = {"Content-Type": "application/json"} +base = "http://localhost:8000/product" + +# 1. Create a memory cube +requests.post(f"{base}/create_cube", headers=headers, data=json.dumps({ + "cube_name": "Alice's memory", + "owner_id": "alice", + "cube_id": "alice_cube", +})) + +# 2. Add a memory +requests.post(f"{base}/add", headers=headers, data=json.dumps({ + "user_id": "alice", + "writable_cube_ids": ["alice_cube"], + "messages": [{"role": "user", "content": "I like strawberry"}], + "async_mode": "sync", +})) + +# 3. Search memories +res = requests.post(f"{base}/search", headers=headers, data=json.dumps({ + "query": "What do I like?", + "user_id": "alice", + "readable_cube_ids": ["alice_cube"], +})) +print(res.json()) +``` -| Provider | Setting | -|----------|---------| -| OpenAI | `MOS_CHAT_MODEL_PROVIDER=openai` | -| Azure OpenAI | `MOS_CHAT_MODEL_PROVIDER=azure` | -| Qwen (DashScope) | `MOS_CHAT_MODEL_PROVIDER=qwen` | -| DeepSeek | `MOS_CHAT_MODEL_PROVIDER=deepseek` | -| MiniMax | `MOS_CHAT_MODEL_PROVIDER=minimax` | -| Ollama | `MOS_CHAT_MODEL_PROVIDER=ollama` | -| HuggingFace | `MOS_CHAT_MODEL_PROVIDER=huggingface` | -| vLLM | `MOS_CHAT_MODEL_PROVIDER=vllm` | -### What plugins are available? -| Plugin | Purpose | -|--------|---------| -| **memos-local-plugin 2.0** | Local-first memory for Hermes Agent & OpenClaw | -| **OpenClaw Cloud Plugin** | Hosted memory service, 72% token reduction | -| **OpenClaw Local Plugin** | 100% on-device SQLite memory | +### 2. OpenClaw Cloud Plugin -### What is the memory architecture? +You use OpenClaw and want persistent memory via MemOS Cloud — no infrastructure to run. -| Layer | Purpose | -|-------|---------| -| **L1 Traces** | Raw interaction history | -| **L2 Policies** | Learned preferences/behaviors | -| **L3 World Model** | User understanding | -| **Crystallized Skills** | Reusable patterns | +- **Repo:** [MemTensor/MemOS ·](https://github.com/MemTensor/MemOS/tree/main/apps/MemOS-Cloud-OpenClaw-Plugin) `apps/MemOS-Cloud-OpenClaw-Plugin` +- **NPM:** `[@memtensor/memos-cloud-openclaw-plugin](https://www.npmjs.com/package/@memtensor/memos-cloud-openclaw-plugin)` +- **Dashboard:** [https://memos-dashboard.openmem.net/](https://memos-dashboard.openmem.net/) +- **Tutorial:** [https://memos-docs.openmem.net/openclaw/guide](https://memos-docs.openmem.net/openclaw/guide) -### What license does MemOS use? +Install: -Apache 2.0 License (see [LICENSE](./LICENSE)). +```bash +openclaw plugins install @memtensor/memos-cloud-openclaw-plugin@latest +openclaw gateway restart +``` -### Where can I get help? +The plugin recalls memories from MemOS Cloud before each agent run and saves new messages back after the run ends. -| Resource | Link | -|----------|------| -| Documentation | [memos-docs.openmem.net](https://memos-docs.openmem.net/home/overview/) | -| ArXiv Paper | [2507.03724](https://arxiv.org/abs/2507.03724) | -| Discord | [Join Server](https://discord.gg/Txbx3gebZR) | -| X/Twitter | [@MemOS_dev](https://x.com/MemOS_dev) | -| GitHub Issues | [Submit issues](https://github.com/MemTensor/MemOS/issues) | -| Awesome-AI-Memory | [IAAR-Shanghai/Awesome-AI-Memory](https://github.com/IAAR-Shanghai/Awesome-AI-Memory) | +### 3. Local Plugin (memos-local-plugin 2.0) -## 📚 Resources +You use Hermes Agent or OpenClaw and want 100% on-device memory — nothing leaves your machine. -- **Awesome-AI-Memory** - This is a curated repository dedicated to resources on memory and memory systems for large language models. It systematically collects relevant research papers, frameworks, tools, and practical insights. The repository aims to organize and present the rapidly evolving research landscape of LLM memory, bridging multiple research directions including natural language processing, information retrieval, agentic systems, and cognitive science.
-**Get started** 👉🏻 [IAAR-Shanghai/Awesome-AI-Memory](https://github.com/IAAR-Shanghai/Awesome-AI-Memory) +- **Repo:** [MemTensor/MemOS ·](https://github.com/MemTensor/MemOS/tree/main/apps/memos-local-plugin) `apps/memos-local-plugin` +- **NPM:** `[@memtensor/memos-local-plugin](https://www.npmjs.com/package/@memtensor/memos-local-plugin)` +- **Docs:** [https://memos-docs.openmem.net/cn/openclaw/local_plugin](https://memos-docs.openmem.net/cn/openclaw/local_plugin) +- **Viewer dashboard:** see `apps/memos-local-plugin/viewer/` -- **MemOS Cloud OpenClaw Plugin** - Official OpenClaw lifecycle plugin for MemOS Cloud. It automatically recalls context from MemOS before the agent starts and saves the conversation back to MemOS after the agent finishes.
-**Get started** 👉🏻 [MemTensor/MemOS-Cloud-OpenClaw-Plugin](https://github.com/MemTensor/MemOS-Cloud-OpenClaw-Plugin) +Features: hybrid retrieval (FTS5 + vector), smart dedup, tiered skill evolution (L1 traces / L2 policies / L3 world model), multi-agent collaboration, local-first SQLite storage. -
+> **Docker note:** When running the local plugin inside Docker, set the `MEMOS_HOME` environment variable or pass `--home` to specify the config location. See [Docker deployment](./apps/memos-local-plugin/README.md#docker-deployment). -## 💬 Community & Support -Join our community to ask questions, share your projects, and connect with other developers. -- **GitHub Issues**: Report bugs or request features in our GitHub Issues. -- **GitHub Pull Requests**: Contribute code improvements via Pull Requests. -- **GitHub Discussions**: Participate in our GitHub Discussions to ask questions or share ideas. -- **Discord**: Join our Discord Server. -- **WeChat**: Scan the QR code to join our WeChat group. +## Community -
- QR Code -
+- **GitHub Issues:** [https://github.com/MemTensor/MemOS/issues](https://github.com/MemTensor/MemOS/issues) +- **GitHub Discussions:** [https://github.com/MemTensor/MemOS/discussions](https://github.com/MemTensor/MemOS/discussions) +- **Discord:** [https://discord.gg/Txbx3gebZR](https://discord.gg/Txbx3gebZR) +- **WeChat:** scan the QR code to join the group. -
-## 📜 Citation -> [!NOTE] -> We publicly released the Short Version on **May 28, 2025**, making it the earliest work to propose the concept of a Memory Operating System for LLMs. +## Citation -If you use MemOS in your research, we would appreciate citations to our papers. +If you use MemOS in your research, please cite: ```bibtex - @article{li2025memos_long, title={MemOS: A Memory OS for AI System}, author={Li, Zhiyu and Song, Shichao and Xi, Chenyang and Wang, Hanyu and Tang, Chen and Niu, Simin and Chen, Ding and Yang, Jiawei and Li, Chunyu and Yu, Qingchen and Zhao, Jihao and Wang, Yezhaohui and Liu, Peng and Lin, Zehao and Wang, Pengyuan and Huo, Jiahao and Chen, Tianyi and Chen, Kai and Li, Kehang and Tao, Zhen and Ren, Junpeng and Lai, Huayi and Wu, Hao and Tang, Bo and Wang, Zhenren and Fan, Zhaoxin and Zhang, Ningyu and Zhang, Linfeng and Yan, Junchi and Yang, Mingchuan and Xu, Tong and Xu, Wei and Chen, Huajun and Wang, Haofeng and Yang, Hongkang and Zhang, Wentao and Xu, Zhi-Qin John and Chen, Siheng and Xiong, Feiyu}, @@ -433,29 +182,10 @@ If you use MemOS in your research, we would appreciate citations to our papers. year={2025}, url={https://arxiv.org/abs/2505.22101} } - -@article{yang2024memory3, -author = {Yang, Hongkang and Zehao, Lin and Wenjin, Wang and Wu, Hao and Zhiyu, Li and Tang, Bo and Wenqiang, Wei and Wang, Jinbo and Zeyun, Tang and Song, Shichao and Xi, Chenyang and Yu, Yu and Kai, Chen and Xiong, Feiyu and Tang, Linpeng and Weinan, E}, -title = {Memory$^3$: Language Modeling with Explicit Memory}, -journal = {Journal of Machine Learning}, -year = {2024}, -volume = {3}, -number = {3}, -pages = {300--346}, -issn = {2790-2048}, -doi = {https://doi.org/10.4208/jml.240708}, -url = {https://global-sci.com/article/91443/memory3-language-modeling-with-explicit-memory} -} ``` -
- -## 🙌 Contributing - -We welcome contributions from the community! Please read our [contribution guidelines](https://memos-docs.openmem.net/open_source/contribution/overview/) to get started. -
-## 📄 License +## License -MemOS is licensed under the [Apache 2.0 License](./LICENSE). +MemOS is licensed under the [Apache 2.0 License](./LICENSE). \ No newline at end of file diff --git a/README_ZH.md b/README_ZH.md new file mode 100644 index 000000000..7f38550ab --- /dev/null +++ b/README_ZH.md @@ -0,0 +1,191 @@ +# MemOS + +智能始于记忆 + +让您的AI拥有持续记忆与成长能力 + +为 AI 应用提供可扩展的记忆服务,让模型在跨任务、跨场景中保持一致理解与个性化体验 + +[文档](https://memos-docs.openmem.net/home/overview/) · [论文](https://arxiv.org/abs/2507.03724) · [Discord](https://discord.gg/Txbx3gebZR) · [X](https://x.com/MemOS_dev) · [Issues](https://github.com/MemTensor/MemOS/issues) + +[English](README.md) | **中文** + +## 性能表现 + +MemOS 在多个评测榜单中处于领先地位——与主流商业记忆产品横向对比,覆盖 5 个用户记忆榜单和 5 个 Agent 记忆任务。 + + +| 榜单 | 分数 | +| --------------- | ----- | +| LoCoMo | 88.83 | +| LongMemEval | 89.20 | +| PersonaMem v2 | 40.58 | +| HaluMem | 80.91 | +| BEAM-10M | 56.75 | +| GDPVal | 62.07 | +| LiveCodeBench | 64.96 | +| OmniMath | 61.00 | +| SWE-Bench | 38.46 | +| BrowseComp-Plus | 23.85 | + + +评测框架 OmniMemEval——[https://github.com/MemTensor/OmniMemEval](https://github.com/MemTensor/OmniMemEval)。 + +## MemOS 适用于 + +MemOS 为 AI agent 提供长期记忆能力,典型场景: + +- AI 助手:保持上下文一致的连续对话 +- 客服系统:召回历史工单与用户信息,提供针对性帮助 +- 个性化 agent:适应用户偏好,持续学习与调整 +- 多 agent 协作:共享或隔离的记忆空间 + + + +## 快速开始 + +MemOS 提供三种使用方式,按你的场景选择。 + + +| | 本地部署 | OpenClaw 云插件 | 本地插件 | +| ---- | ----------------- | ------------------------ | ----------------------- | +| 适合谁 | 自建基础设施的团队 | OpenClaw 用户,零运维 | Hermes/OpenClaw,100% 端侧 | +| 启动方式 | docker compose up | openclaw plugins install | npm install + 配置 | +| 依赖设施 | Neo4j + Qdrant | 无(使用 MemOS Cloud) | 无(本地 SQLite) | +| 数据存放 | 你的服务器 | MemOS Cloud | 你的机器 | + + + + +### 1. 本地部署 MemOS 服务 + +想把 MemOS 作为 REST 服务跑在自己的机器或集群上。 + +**方式 A — Docker(推荐):** + +```bash +git clone https://github.com/MemTensor/MemOS.git +cd MemOS +cp docker/.env.example .env # 在 .env 中填入你的 API key +cd docker +docker compose up # 启动 MemOS API + Neo4j + Qdrant +``` + +API 服务地址:`http://localhost:8000`。 + +**方式 B — 用 uvicorn 启动(不用 Docker):** + +```bash +git clone https://github.com/MemTensor/MemOS.git +cd MemOS +cp docker/.env.example .env # 在 .env 中填入你的 API key +# 确保 Neo4j 和 Qdrant 已启动,然后: +cd src +uvicorn memos.api.server_api:app --host 0.0.0.0 --port 8000 --workers 1 +``` + +所有配置项(LLM、embedder、向量库、图库、调度器)见 `[docker/.env.example](./docker/.env.example)`。完整部署指南:[https://memos-docs.openmem.net/open_source/getting_started/rest_api_server/](https://memos-docs.openmem.net/open_source/getting_started/rest_api_server/)。 + +**试用 API:** + +```python +import requests, json + +headers = {"Content-Type": "application/json"} +base = "http://localhost:8000/product" + +# 1. 创建记忆 cube +requests.post(f"{base}/create_cube", headers=headers, data=json.dumps({ + "cube_name": "Alice's memory", + "owner_id": "alice", + "cube_id": "alice_cube", +})) + +# 2. 写入一条记忆 +requests.post(f"{base}/add", headers=headers, data=json.dumps({ + "user_id": "alice", + "writable_cube_ids": ["alice_cube"], + "messages": [{"role": "user", "content": "I like strawberry"}], + "async_mode": "sync", +})) + +# 3. 检索记忆 +res = requests.post(f"{base}/search", headers=headers, data=json.dumps({ + "query": "What do I like?", + "user_id": "alice", + "readable_cube_ids": ["alice_cube"], +})) +print(res.json()) +``` + + + +### 2. OpenClaw 云插件 + +使用 OpenClaw,想通过 MemOS Cloud 获得持久记忆——无需自建基础设施。 + +- **仓库:** [MemTensor/MemOS ·](https://github.com/MemTensor/MemOS/tree/main/apps/MemOS-Cloud-OpenClaw-Plugin) `apps/MemOS-Cloud-OpenClaw-Plugin` +- **NPM:** `[@memtensor/memos-cloud-openclaw-plugin](https://www.npmjs.com/package/@memtensor/memos-cloud-openclaw-plugin)` +- **控制台:** [https://memos-dashboard.openmem.net/](https://memos-dashboard.openmem.net/) +- **教程:** [https://memos-docs.openmem.net/openclaw/guide](https://memos-docs.openmem.net/openclaw/guide) + +安装: + +```bash +openclaw plugins install @memtensor/memos-cloud-openclaw-plugin@latest +openclaw gateway restart +``` + +插件在每次 agent 运行前从 MemOS Cloud 召回记忆,运行结束后把新消息写回。 + +### 3. 本地插件(memos-local-plugin 2.0) + +使用 Hermes Agent 或 OpenClaw,想要 100% 端侧记忆——数据不离开本机。 + +- **仓库:** [MemTensor/MemOS ·](https://github.com/MemTensor/MemOS/tree/main/apps/memos-local-plugin) `apps/memos-local-plugin` +- **NPM:** `[@memtensor/memos-local-plugin](https://www.npmjs.com/package/@memtensor/memos-local-plugin)` +- **文档:** [https://memos-docs.openmem.net/cn/openclaw/local_plugin](https://memos-docs.openmem.net/cn/openclaw/local_plugin) +- **查看器面板:** 见 `apps/memos-local-plugin/viewer/` + +特性:混合检索(FTS5 + 向量)、智能去重、分层技能演化(L1 轨迹 / L2 策略 / L3 世界模型)、多 agent 协作、本地优先 SQLite 存储。 + +> **Docker 提示:** 在 Docker 中运行本地插件时,需设置 `MEMOS_HOME` 环境变量或传入 `--home` 指定配置路径。见 [Docker 部署说明](./apps/memos-local-plugin/README.md#docker-deployment)。 + + + +## 社区 + +- **GitHub Issues:** [https://github.com/MemTensor/MemOS/issues](https://github.com/MemTensor/MemOS/issues) +- **GitHub Discussions:** [https://github.com/MemTensor/MemOS/discussions](https://github.com/MemTensor/MemOS/discussions) +- **Discord:** [https://discord.gg/Txbx3gebZR](https://discord.gg/Txbx3gebZR) +- **微信:** 扫码加入微信群。 + + + +## 引用 + +如果在研究中使用 MemOS,请引用: + +```bibtex +@article{li2025memos_long, + title={MemOS: A Memory OS for AI System}, + author={Li, Zhiyu and Song, Shichao and Xi, Chenyang and Wang, Hanyu and Tang, Chen and Niu, Simin and Chen, Ding and Yang, Jiawei and Li, Chunyu and Yu, Qingchen and Zhao, Jihao and Wang, Yezhaohui and Liu, Peng and Lin, Zehao and Wang, Pengyuan and Huo, Jiahao and Chen, Tianyi and Chen, Kai and Li, Kehang and Tao, Zhen and Ren, Junpeng and Lai, Huayi and Wu, Hao and Tang, Bo and Wang, Zhenren and Fan, Zhaoxin and Zhang, Ningyu and Zhang, Linfeng and Yan, Junchi and Yang, Mingchuan and Xu, Tong and Xu, Wei and Chen, Huajun and Wang, Haofeng and Yang, Hongkang and Zhang, Wentao and Xu, Zhi-Qin John and Chen, Siheng and Xiong, Feiyu}, + journal={arXiv preprint arXiv:2507.03724}, + year={2025}, + url={https://arxiv.org/abs/2507.03724} +} + +@article{li2025memos_short, + title={MemOS: An Operating System for Memory-Augmented Generation (MAG) in Large Language Models}, + author={Li, Zhiyu and Song, Shichao and Wang, Hanyu and Niu, Simin and Chen, Ding and Yang, Jiawei and Xi, Chenyang and Lai, Huayi and Zhao, Jihao and Wang, Yezhaohui and others}, + journal={arXiv preprint arXiv:2505.22101}, + year={2025}, + url={https://arxiv.org/abs/2505.22101} +} +``` + + + +## 许可证 + +MemOS 基于 [Apache 2.0 许可证](./LICENSE) 开源。 \ No newline at end of file From 17a6be9a2a230f5ae62868c7e768384d1fed7694 Mon Sep 17 00:00:00 2001 From: sunqi Date: Thu, 9 Jul 2026 10:14:58 +0800 Subject: [PATCH 2/6] docs: restore visual layout and restructure Quick Start sections - Restore top banner GIF, logo, title, shield badges from original README - Replace performance highlights list with official slogan - Add Performance block with 10 benchmark scores - Restructure Quick Start: Self-Host and Plugin as peer ### sections, Cloud Plugin and Local Plugin as #### subsections under Plugin - Remove redundant Docker note from Local Plugin section - Sync structure between English and Chinese versions Co-authored-by: Cursor --- README.md | 48 ++++++++++++++++++++++++------------------------ README_ZH.md | 50 ++++++++++++++++++++++++++++++++------------------ 2 files changed, 56 insertions(+), 42 deletions(-) diff --git a/README.md b/README.md index 5e47a818e..4ed1ce691 100644 --- a/README.md +++ b/README.md @@ -1,16 +1,18 @@ -# MemOS -Intelligence begins with memory. -Give your AI persistent memory and the ability to grow. +# MemOS 2.0 Stardust(星尘) + +**Intelligence begins with memory.** +**Give your Agent persistent memory and the ability to grow.** +**Scalable memory services for AI applications — keeping models consistent and personalized across tasks and scenarios.** -Scalable memory services for AI applications — keeping models consistent and personalized across tasks and scenarios. -[Docs](https://memos-docs.openmem.net/home/overview/) · [Paper](https://arxiv.org/abs/2507.03724) · [Discord](https://discord.gg/Txbx3gebZR) · [X](https://x.com/MemOS_dev) · [Issues](https://github.com/MemTensor/MemOS/issues) **English** | [中文](README_ZH.md) -## Performance +--- + +## 📊 Performance MemOS leads across multiple benchmarks — evaluated against mainstream commercial memory products across 5 user memory and 5 agent memory tasks. @@ -31,7 +33,7 @@ MemOS leads across multiple benchmarks — evaluated against mainstream commerci Evaluated via OmniMemEval — [https://github.com/MemTensor/OmniMemEval](https://github.com/MemTensor/OmniMemEval). -## What MemOS Is For +## 🎯 What MemOS Is For MemOS gives AI agents long-term memory. Common uses: @@ -40,9 +42,7 @@ MemOS gives AI agents long-term memory. Common uses: - Personalized agents that adapt to individual preferences - Multi-agent collaboration with shared or isolated memory - - -## Quick Start +## 🚀 Quick Start MemOS is built around three entry points. Pick the one that matches your scenario. @@ -54,10 +54,7 @@ MemOS is built around three entry points. Pick the one that matches your scenari | Infra needed | Neo4j + Qdrant | None (uses MemOS Cloud) | None (local SQLite) | | Data lives | Your servers | MemOS Cloud | Your machine | - - - -### 1. Self-Host the MemOS Service +### 🖥️ Self-Host the MemOS Service You want to run MemOS as a REST service on your own machine or cluster. @@ -118,9 +115,16 @@ res = requests.post(f"{base}/search", headers=headers, data=json.dumps({ print(res.json()) ``` +### 🧠 MemOS Plugin: Persistent Memory for Your AI Agents ✨ + +Your OpenClaw and Hermes Agents now have **the best** memory system — choose ***Cloud Service*** or ***Self-hosted*** to get started 🏃🏻 +| 🔌 Plugin | 💡 Core Features | 🧩 Resources | +| ------------------------------------------------------------------------------------------------------------- | ---------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | +| 🧠 **[memos-local-plugin 2.0](https://github.com/MemTensor/MemOS/tree/main/apps/memos-local-plugin)** | | 🌐 [Website](https://memos-claw.openmem.net/) · 📖 [Docs](https://memos-docs.openmem.net/cn/openclaw/local_plugin) · 🐙 [GitHub](https://github.com/MemTensor/MemOS/tree/main/apps/memos-local-plugin) · 📦 [NPM](https://www.npmjs.com/package/@memtensor/memos-local-plugin) | +| ☁️ **[OpenClaw Cloud Plugin](https://github.com/MemTensor/MemOS/tree/main/apps/MemOS-Cloud-OpenClaw-Plugin)** | | 🖥️ [MemOS Dashboard](https://memos-dashboard.openmem.net/login/) · 📖 [Full Tutorial](https://memos-docs.openmem.net/openclaw/guide#_4-update-plugin) | -### 2. OpenClaw Cloud Plugin +#### 1. OpenClaw Cloud Plugin You use OpenClaw and want persistent memory via MemOS Cloud — no infrastructure to run. @@ -138,7 +142,7 @@ openclaw gateway restart The plugin recalls memories from MemOS Cloud before each agent run and saves new messages back after the run ends. -### 3. Local Plugin (memos-local-plugin 2.0) +#### 2. Local Plugin (memos-local-plugin 2.0) You use Hermes Agent or OpenClaw and want 100% on-device memory — nothing leaves your machine. @@ -149,11 +153,7 @@ You use Hermes Agent or OpenClaw and want 100% on-device memory — nothing leav Features: hybrid retrieval (FTS5 + vector), smart dedup, tiered skill evolution (L1 traces / L2 policies / L3 world model), multi-agent collaboration, local-first SQLite storage. -> **Docker note:** When running the local plugin inside Docker, set the `MEMOS_HOME` environment variable or pass `--home` to specify the config location. See [Docker deployment](./apps/memos-local-plugin/README.md#docker-deployment). - - - -## Community +## 🤝 Community - **GitHub Issues:** [https://github.com/MemTensor/MemOS/issues](https://github.com/MemTensor/MemOS/issues) - **GitHub Discussions:** [https://github.com/MemTensor/MemOS/discussions](https://github.com/MemTensor/MemOS/discussions) @@ -162,7 +162,7 @@ Features: hybrid retrieval (FTS5 + vector), smart dedup, tiered skill evolution -## Citation +## 📚 Citation If you use MemOS in your research, please cite: @@ -186,6 +186,6 @@ If you use MemOS in your research, please cite: -## License +## ⚖️ License -MemOS is licensed under the [Apache 2.0 License](./LICENSE). \ No newline at end of file +MemOS is licensed under the [Apache 2.0 License](./LICENSE). diff --git a/README_ZH.md b/README_ZH.md index 7f38550ab..b2e0127e7 100644 --- a/README_ZH.md +++ b/README_ZH.md @@ -1,16 +1,20 @@ -# MemOS -智能始于记忆 -让您的AI拥有持续记忆与成长能力 +#   MemOS 2.0 Stardust(星尘) + +**智能始于记忆** +**让您的Agent拥有持续记忆与成长能力** +**为 AI 应用提供可扩展的记忆服务,让模型在跨任务、跨场景中保持一致理解与个性化体验** -为 AI 应用提供可扩展的记忆服务,让模型在跨任务、跨场景中保持一致理解与个性化体验 -[文档](https://memos-docs.openmem.net/home/overview/) · [论文](https://arxiv.org/abs/2507.03724) · [Discord](https://discord.gg/Txbx3gebZR) · [X](https://x.com/MemOS_dev) · [Issues](https://github.com/MemTensor/MemOS/issues) [English](README.md) | **中文** -## 性能表现 +--- + + + +## 📊 性能表现 MemOS 在多个评测榜单中处于领先地位——与主流商业记忆产品横向对比,覆盖 5 个用户记忆榜单和 5 个 Agent 记忆任务。 @@ -31,7 +35,7 @@ MemOS 在多个评测榜单中处于领先地位——与主流商业记忆产 评测框架 OmniMemEval——[https://github.com/MemTensor/OmniMemEval](https://github.com/MemTensor/OmniMemEval)。 -## MemOS 适用于 +## 🎯 MemOS 适用于 MemOS 为 AI agent 提供长期记忆能力,典型场景: @@ -40,9 +44,10 @@ MemOS 为 AI agent 提供长期记忆能力,典型场景: - 个性化 agent:适应用户偏好,持续学习与调整 - 多 agent 协作:共享或隔离的记忆空间 + -## 快速开始 +## 🚀 快速开始 MemOS 提供三种使用方式,按你的场景选择。 @@ -57,7 +62,7 @@ MemOS 提供三种使用方式,按你的场景选择。 -### 1. 本地部署 MemOS 服务 +### 🖥️ 本地部署 MemOS 服务 想把 MemOS 作为 REST 服务跑在自己的机器或集群上。 @@ -120,7 +125,20 @@ print(res.json()) -### 2. OpenClaw 云插件 +### 🧠 MemOS 插件:为你的 AI agent 提供持久记忆 ✨ + +你的 OpenClaw 和 Hermes Agent 现在拥有**最佳**记忆系统——选择***云服务***或***自部署***即可开始 🏃🏻 + + +| 🔌 插件 | 💡 核心特性 | 🧩 资源 | +| ----------------------------------------------------------------------------------------------------- | ------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| 🧠 **[memos-local-plugin 2.0](https://github.com/MemTensor/MemOS/tree/main/apps/memos-local-plugin)** | | 🌐 [官网](https://memos-claw.openmem.net/) · 📖 [文档](https://memos-docs.openmem.net/cn/openclaw/local_plugin) · 🐙 [GitHub](https://github.com/MemTensor/MemOS/tree/main/apps/memos-local-plugin) · 📦 [NPM](https://www.npmjs.com/package/@memtensor/memos-local-plugin) | +| ☁️ **[OpenClaw 云插件](https://github.com/MemTensor/MemOS/tree/main/apps/MemOS-Cloud-OpenClaw-Plugin)** | | 🖥️ [MemOS 控制台](https://memos-dashboard.openmem.net/login/) · 📖 [完整教程](https://memos-docs.openmem.net/openclaw/guide#_4-update-plugin) | + + + + +#### 1. OpenClaw 云插件 使用 OpenClaw,想通过 MemOS Cloud 获得持久记忆——无需自建基础设施。 @@ -138,7 +156,7 @@ openclaw gateway restart 插件在每次 agent 运行前从 MemOS Cloud 召回记忆,运行结束后把新消息写回。 -### 3. 本地插件(memos-local-plugin 2.0) +#### 2. 本地插件(memos-local-plugin 2.0) 使用 Hermes Agent 或 OpenClaw,想要 100% 端侧记忆——数据不离开本机。 @@ -149,11 +167,7 @@ openclaw gateway restart 特性:混合检索(FTS5 + 向量)、智能去重、分层技能演化(L1 轨迹 / L2 策略 / L3 世界模型)、多 agent 协作、本地优先 SQLite 存储。 -> **Docker 提示:** 在 Docker 中运行本地插件时,需设置 `MEMOS_HOME` 环境变量或传入 `--home` 指定配置路径。见 [Docker 部署说明](./apps/memos-local-plugin/README.md#docker-deployment)。 - - - -## 社区 +## 🤝 社区 - **GitHub Issues:** [https://github.com/MemTensor/MemOS/issues](https://github.com/MemTensor/MemOS/issues) - **GitHub Discussions:** [https://github.com/MemTensor/MemOS/discussions](https://github.com/MemTensor/MemOS/discussions) @@ -162,7 +176,7 @@ openclaw gateway restart -## 引用 +## 📚 引用 如果在研究中使用 MemOS,请引用: @@ -186,6 +200,6 @@ openclaw gateway restart -## 许可证 +## ⚖️ 许可证 MemOS 基于 [Apache 2.0 许可证](./LICENSE) 开源。 \ No newline at end of file From e94ae38e65a891dc45467a7bb17f4b6607df40d1 Mon Sep 17 00:00:00 2001 From: sunqi Date: Thu, 9 Jul 2026 10:31:19 +0800 Subject: [PATCH 3/6] docs: restore lost images in README header, plugin, and community sections - Restore centered logo (with link to memos.openmem.net), title, and shield badges (Docs, ArXiv, Follow, Discord, Resources) in both READMEs - Restore plugin banner image under the MemOS Plugin section header - Restore WeChat QR code under the Community section - Sync structure between English and Chinese versions --- README.md | 46 +++++++++++++++++++++++++++++++++++----------- README_ZH.md | 46 +++++++++++++++++++++++++++++++++++----------- 2 files changed, 70 insertions(+), 22 deletions(-) diff --git a/README.md b/README.md index 4ed1ce691..369eacfa2 100644 --- a/README.md +++ b/README.md @@ -1,14 +1,30 @@ - - -# MemOS 2.0 Stardust(星尘) - -**Intelligence begins with memory.** -**Give your Agent persistent memory and the ability to grow.** -**Scalable memory services for AI applications — keeping models consistent and personalized across tasks and scenarios.** - - - -**English** | [中文](README_ZH.md) +
+

+ + MemOS Logo +   + MemOS 2.0 Stardust(星尘) +

+ +

+ Docs + ArXiv + X + Discord +
+ Resources +

+ +

+ Intelligence begins with memory.
+ Give your Agent persistent memory and the ability to grow.
+ Scalable memory services for AI applications — keeping models consistent and personalized across tasks and scenarios. +

+ +

+ English | 中文 +

+
--- @@ -117,6 +133,10 @@ print(res.json()) ### 🧠 MemOS Plugin: Persistent Memory for Your AI Agents ✨ +
+ MemOS Plugin Banner +
+ Your OpenClaw and Hermes Agents now have **the best** memory system — choose ***Cloud Service*** or ***Self-hosted*** to get started 🏃🏻 | 🔌 Plugin | 💡 Core Features | 🧩 Resources | @@ -160,6 +180,10 @@ Features: hybrid retrieval (FTS5 + vector), smart dedup, tiered skill evolution - **Discord:** [https://discord.gg/Txbx3gebZR](https://discord.gg/Txbx3gebZR) - **WeChat:** scan the QR code to join the group. +
+ QR Code +
+ ## 📚 Citation diff --git a/README_ZH.md b/README_ZH.md index b2e0127e7..9ccd501b3 100644 --- a/README_ZH.md +++ b/README_ZH.md @@ -1,14 +1,30 @@ - - -#   MemOS 2.0 Stardust(星尘) - -**智能始于记忆** -**让您的Agent拥有持续记忆与成长能力** -**为 AI 应用提供可扩展的记忆服务,让模型在跨任务、跨场景中保持一致理解与个性化体验** - - - -[English](README.md) | **中文** +
+

+ + MemOS Logo +   + MemOS 2.0 Stardust(星尘) +

+ +

+ Docs + ArXiv + X + Discord +
+ Resources +

+ +

+ 智能始于记忆
+ 让您的 Agent 拥有持续记忆与成长能力
+ 为 AI 应用提供可扩展的记忆服务,让模型在跨任务、跨场景中保持一致理解与个性化体验 +

+ +

+ English | 中文 +

+
--- @@ -127,6 +143,10 @@ print(res.json()) ### 🧠 MemOS 插件:为你的 AI agent 提供持久记忆 ✨ +
+ MemOS Plugin Banner +
+ 你的 OpenClaw 和 Hermes Agent 现在拥有**最佳**记忆系统——选择***云服务***或***自部署***即可开始 🏃🏻 @@ -174,6 +194,10 @@ openclaw gateway restart - **Discord:** [https://discord.gg/Txbx3gebZR](https://discord.gg/Txbx3gebZR) - **微信:** 扫码加入微信群。 +
+ QR Code +
+ ## 📚 引用 From 3c92df3f02f3c6a5f70c19e5bbbcc5ed5b9cda6b Mon Sep 17 00:00:00 2001 From: sunqi Date: Thu, 9 Jul 2026 11:04:08 +0800 Subject: [PATCH 4/6] docs: add local plugin install commands and restructure README overview - Add macOS/Linux and Windows install commands for memos-local-plugin, with a prerequisites note (Node.js + an installed OpenClaw/Hermes) - Use robust download-then-run form on Windows instead of irm|iex so errors stay visible and the script dir resolves correctly - Add "MemOS: Memory Operating System" overview section (Key Features + News) - Move plugin banner to the top; simplify the tagline - Keep English and Chinese versions structurally in sync Co-authored-by: Cursor --- README.md | 52 +++++++++++++++++++++++++++---- README_ZH.md | 86 ++++++++++++++++++++++++++++++---------------------- 2 files changed, 96 insertions(+), 42 deletions(-) diff --git a/README.md b/README.md index 369eacfa2..b2e8b2ea3 100644 --- a/README.md +++ b/README.md @@ -16,9 +16,7 @@

- Intelligence begins with memory.
Give your Agent persistent memory and the ability to grow.
- Scalable memory services for AI applications — keeping models consistent and personalized across tasks and scenarios.

@@ -26,8 +24,40 @@

+ +
+ MemOS Plugin Banner +
+ --- +## 👾 MemOS: Memory Operating System for LLM & AI Agents + +**MemOS** is a Memory Operating System for LLMs and AI agents that unifies **store / retrieve / manage** for long-term memory, enabling **context-aware and personalized** interactions with **KB**, **multi-modal**, **tool memory**, and **enterprise-grade** optimizations built in. + +### Key Features + +- **Unified Memory API**: A single API to add, retrieve, edit, and delete memory—structured as a graph, inspectable and editable by design, not a black-box embedding store. +- **Multi-Modal Memory**: Natively supports text, images, tool traces, and personas, retrieved and reasoned together in one memory system. +- **Multi-Cube Knowledge Base Management**: Manage multiple knowledge bases as composable memory cubes, enabling isolation, controlled sharing, and dynamic composition across users, projects, and agents. +- **Asynchronous Ingestion via MemScheduler**: Run memory operations asynchronously with millisecond-level latency for production stability under high concurrency. +- **Memory Feedback & Correction**: Refine memory with natural-language feedback—correcting, supplementing, or replacing existing memories over time. + + +### News + +- **2026-07-02** · 🏆 **MemOS Advances Agent and User Memory Benchmarks** + With MemOS, **OpenClaw** improves average task completion from **36.63% to 50.87%** across five agent tasks. MemOS also achieves **92.34 on LoCoMo** and **93.40 on LongMemEval**, and leads in **OmniMemEval**, a unified evaluation of 14 commercial memory products across ten datasets. + +- **2026-05-09** · 🧠 **memos-local-plugin 2.0** + Official local memory plugin for **Hermes Agent** and **OpenClaw**. One core powers self-evolving memory across L1 traces, L2 policies, L3 world models, and crystallized Skills, with local-first storage and feedback-driven retrieval. + +- **2026-04-10** · 👧🏻 **MemOS Hermes Agent Local Plugin** + Official Hermes Agent memory plugins launched: Hybrid retrieval (FTS5 + vector), smart dedup, tiered skill evolution, multi-agent collaboration. 100% local, zero cloud dependency. + +- **2026-03-08** · 🦞 **MemOS OpenClaw Plugin — Cloud & Local** + Official OpenClaw memory plugins launched. **Cloud Plugin**: hosted memory service with 72% lower token usage and multi-agent memory sharing ([MemOS-Cloud-OpenClaw-Plugin](https://github.com/MemTensor/MemOS-Cloud-OpenClaw-Plugin)). **Local Plugin** (`v1.0.0`): 100% on-device memory with persistent SQLite, hybrid search (FTS5 + vector), task summarization & skill evolution, multi-agent collaboration, and a full Memory Viewer dashboard. + ## 📊 Performance MemOS leads across multiple benchmarks — evaluated against mainstream commercial memory products across 5 user memory and 5 agent memory tasks. @@ -133,10 +163,6 @@ print(res.json()) ### 🧠 MemOS Plugin: Persistent Memory for Your AI Agents ✨ -
- MemOS Plugin Banner -
- Your OpenClaw and Hermes Agents now have **the best** memory system — choose ***Cloud Service*** or ***Self-hosted*** to get started 🏃🏻 | 🔌 Plugin | 💡 Core Features | 🧩 Resources | @@ -171,6 +197,20 @@ You use Hermes Agent or OpenClaw and want 100% on-device memory — nothing leav - **Docs:** [https://memos-docs.openmem.net/cn/openclaw/local_plugin](https://memos-docs.openmem.net/cn/openclaw/local_plugin) - **Viewer dashboard:** see `apps/memos-local-plugin/viewer/` +Install (macOS / Linux): + +```bash +curl -fsSL https://raw.githubusercontent.com/MemTensor/MemOS/main/apps/memos-local-plugin/install.sh | bash +``` + +Install (Windows PowerShell): + +```powershell +irm https://raw.githubusercontent.com/MemTensor/MemOS/main/apps/memos-local-plugin/install.ps1 -OutFile "$env:TEMP\memos-install.ps1"; powershell -ExecutionPolicy Bypass -File "$env:TEMP\memos-install.ps1" +``` + +Requires Node.js and an already-installed OpenClaw or Hermes. The installer auto-detects OpenClaw and Hermes, deploys the plugin to the right agent home (`~/.hermes/plugins/` or `~/.openclaw/plugins/`), writes the initial `config.yaml`, and restarts the agent runtime. + Features: hybrid retrieval (FTS5 + vector), smart dedup, tiered skill evolution (L1 traces / L2 policies / L3 world model), multi-agent collaboration, local-first SQLite storage. ## 🤝 Community diff --git a/README_ZH.md b/README_ZH.md index 9ccd501b3..fb30b00aa 100644 --- a/README_ZH.md +++ b/README_ZH.md @@ -1,33 +1,42 @@ -
-

- - MemOS Logo -   - MemOS 2.0 Stardust(星尘) -

- -

- Docs - ArXiv - X - Discord -
- Resources -

- -

- 智能始于记忆
- 让您的 Agent 拥有持续记忆与成长能力
- 为 AI 应用提供可扩展的记忆服务,让模型在跨任务、跨场景中保持一致理解与个性化体验 -

- -

- English | 中文 -

-
+#   MemOS 2.0 Stardust(星尘) + + + + +**让 Agent 拥有持续记忆与成长能力** + + +[English](README.md) | **中文** + --- +## 👾 MemOS:面向 LLM 与 AI Agent 的记忆操作系统 + +**MemOS** 是一个面向 LLM 与 AI Agent 的记忆操作系统,统一了长期记忆的**存/取/管**,内置 **KB**、**多模态**、**工具记忆** 与 **企业级** 优化,实现上下文感知与个性化的交互。 + +### 核心特性 + +- **统一记忆 API**:用单一 API 完成记忆的增、删、改、查——以图结构组织,可检视、可编辑,不是黑盒向量库。 +- **多模态记忆**:原生支持文本、图像、工具轨迹与人格,在同一记忆系统中统一检索与推理。 +- **多 Cube 知识库管理**:将多个知识库组合为可复用的记忆 Cube,实现跨用户、项目与 Agent 的隔离、受控共享与动态组合。 +- **MemScheduler 异步写入**:以异步方式执行记忆操作,毫秒级延迟,保障高并发下的生产稳定性。 +- **记忆反馈与修正**:通过自然语言反馈精炼记忆——可纠正、补充或替换已有记忆,持续演进。 + +### News + +- **2026-07-02** · 🏆 **MemOS 在 Agent 与用户记忆榜单上全面领先** + 在 MemOS 的加持下,**OpenClaw** 在五个 Agent 任务上的平均任务完成率从 **36.63% 提升到 50.87%**。MemOS 在 **LoCoMo** 取得 **92.34**、**LongMemEval** 取得 **93.40**,并在 **OmniMemEval**(覆盖 14 款商业记忆产品、十个数据集的统一评测)中领先。 + +- **2026-05-09** · 🧠 **memos-local-plugin 2.0** + **Hermes Agent** 与 **OpenClaw** 官方本地记忆插件。单一核心驱动自演化记忆:L1 轨迹、L2 策略、L3 世界模型与结晶化 Skill,本地优先存储 + 反馈驱动检索。 + +- **2026-04-10** · 👧🏻 **MemOS Hermes Agent 本地插件** + 官方 Hermes Agent 记忆插件发布:混合检索(FTS5 + 向量)、智能去重、分层技能演化、多 Agent 协作。100% 本地,零云依赖。 + +- **2026-03-08** · 🦞 **MemOS OpenClaw 插件——云端与本地** + 官方 OpenClaw 记忆插件发布。**云插件**:托管记忆服务,token 用量降低 72%,支持多 Agent 记忆共享([MemOS-Cloud-OpenClaw-Plugin](https://github.com/MemTensor/MemOS-Cloud-OpenClaw-Plugin))。**本地插件**(`v1.0.0`):100% 端侧记忆,持久化 SQLite,混合检索(FTS5 + 向量),任务摘要与技能演化,多 Agent 协作,配套完整记忆查看器面板。 + ## 📊 性能表现 @@ -60,7 +69,6 @@ MemOS 为 AI agent 提供长期记忆能力,典型场景: - 个性化 agent:适应用户偏好,持续学习与调整 - 多 agent 协作:共享或隔离的记忆空间 - ## 🚀 快速开始 @@ -143,10 +151,6 @@ print(res.json()) ### 🧠 MemOS 插件:为你的 AI agent 提供持久记忆 ✨ -
- MemOS Plugin Banner -
- 你的 OpenClaw 和 Hermes Agent 现在拥有**最佳**记忆系统——选择***云服务***或***自部署***即可开始 🏃🏻 @@ -185,6 +189,20 @@ openclaw gateway restart - **文档:** [https://memos-docs.openmem.net/cn/openclaw/local_plugin](https://memos-docs.openmem.net/cn/openclaw/local_plugin) - **查看器面板:** 见 `apps/memos-local-plugin/viewer/` +安装(macOS / Linux): + +```bash +curl -fsSL https://raw.githubusercontent.com/MemTensor/MemOS/main/apps/memos-local-plugin/install.sh | bash +``` + +安装(Windows PowerShell): + +```powershell +irm https://raw.githubusercontent.com/MemTensor/MemOS/main/apps/memos-local-plugin/install.ps1 -OutFile "$env:TEMP\memos-install.ps1"; powershell -ExecutionPolicy Bypass -File "$env:TEMP\memos-install.ps1" +``` + +需先安装 Node.js,且已安装 OpenClaw 或 Hermes。安装器会自动识别 OpenClaw 与 Hermes,将插件部署到对应的 agent 主目录(`~/.hermes/plugins/` 或 `~/.openclaw/plugins/`),写入初始 `config.yaml`,并按需重启 agent 运行时。 + 特性:混合检索(FTS5 + 向量)、智能去重、分层技能演化(L1 轨迹 / L2 策略 / L3 世界模型)、多 agent 协作、本地优先 SQLite 存储。 ## 🤝 社区 @@ -194,10 +212,6 @@ openclaw gateway restart - **Discord:** [https://discord.gg/Txbx3gebZR](https://discord.gg/Txbx3gebZR) - **微信:** 扫码加入微信群。 -
- QR Code -
- ## 📚 引用 From 80c638ac5efb72ba36b4b8468db2346e698c923f Mon Sep 17 00:00:00 2001 From: sunqi Date: Thu, 9 Jul 2026 11:16:03 +0800 Subject: [PATCH 5/6] docs: restore header logo, badges, banner, and QR code in README_ZH Bring the Chinese README visually in sync with the English version: centered logo (linked), shield badges, top plugin banner, and the WeChat QR code in the Community section. Co-authored-by: Cursor --- README_ZH.md | 44 ++++++++++++++++++++++++++++++++++---------- 1 file changed, 34 insertions(+), 10 deletions(-) diff --git a/README_ZH.md b/README_ZH.md index fb30b00aa..c99147579 100644 --- a/README_ZH.md +++ b/README_ZH.md @@ -1,13 +1,33 @@ -#   MemOS 2.0 Stardust(星尘) - - - - -**让 Agent 拥有持续记忆与成长能力** - - -[English](README.md) | **中文** - +
+

+ + MemOS Logo +   + MemOS 2.0 Stardust(星尘) +

+ +

+ Docs + ArXiv + X + Discord +
+ Resources +

+ +

+ 让 Agent 拥有持续记忆与成长能力
+

+ +

+ English | 中文 +

+
+ + +
+ MemOS Plugin Banner +
--- @@ -212,6 +232,10 @@ irm https://raw.githubusercontent.com/MemTensor/MemOS/main/apps/memos-local-plug - **Discord:** [https://discord.gg/Txbx3gebZR](https://discord.gg/Txbx3gebZR) - **微信:** 扫码加入微信群。 +
+ QR Code +
+ ## 📚 引用 From ca212e4a40ac4eb492b1553a731de987844d876a Mon Sep 17 00:00:00 2001 From: sunqi Date: Thu, 9 Jul 2026 13:44:15 +0800 Subject: [PATCH 6/6] docs: add Cloud API (Hosted) quick-start scenario to README Add the managed MemOS Cloud API as a fourth entry point in the Quick Start of both README.md and README_ZH.md: a comparison-table column, API-key setup, an add/search code example, and next-step doc links. Mirrors the Cloud API section from upstream main. Co-authored-by: Cursor --- README.md | 52 +++++++++++++++++++++++++++++++++++++++++++++------- README_ZH.md | 49 ++++++++++++++++++++++++++++++++++++++++++------- 2 files changed, 87 insertions(+), 14 deletions(-) diff --git a/README.md b/README.md index b2e8b2ea3..9ce8c031a 100644 --- a/README.md +++ b/README.md @@ -90,15 +90,53 @@ MemOS gives AI agents long-term memory. Common uses: ## 🚀 Quick Start -MemOS is built around three entry points. Pick the one that matches your scenario. +MemOS is built around four entry points. Pick the one that matches your scenario. -| | Self-Host | OpenClaw Cloud Plugin | Local Plugin | -| ------------ | ------------------ | ------------------------ | ------------------------------- | -| Best for | Teams on own infra | OpenClaw users, zero ops | Hermes/OpenClaw, 100% on-device | -| Setup | docker compose up | openclaw plugins install | npm install + config | -| Infra needed | Neo4j + Qdrant | None (uses MemOS Cloud) | None (local SQLite) | -| Data lives | Your servers | MemOS Cloud | Your machine | +| | Cloud API | Self-Host | OpenClaw Cloud Plugin | Local Plugin | +| ------------ | ----------------------- | ------------------ | ------------------------ | ------------------------------- | +| Best for | Your app, fully managed | Teams on own infra | OpenClaw users, zero ops | Hermes/OpenClaw, 100% on-device | +| Setup | Get an API key | docker compose up | openclaw plugins install | npm install + config | +| Infra needed | None (hosted) | Neo4j + Qdrant | None (uses MemOS Cloud) | None (local SQLite) | +| Data lives | MemOS Cloud | Your servers | MemOS Cloud | Your machine | + +### ☁️ Use the Cloud API (Hosted) + +You want to add memory to your app through a fully managed service — no infrastructure to run. + +**1. Get an API key:** + +- Sign up on the [MemOS dashboard](https://memos-dashboard.openmem.net/cn/quickstart/?source=landing). +- Go to **API Keys** and copy your key (starts with `mpg-`). Keep it server-side. + +**2. Add and search memories:** + +```python +import requests + +API_KEY = "mpg-..." # keep this server-side +base = "https://memos.memtensor.cn/api/openmem/v1" +headers = {"Authorization": f"Token {API_KEY}", "Content-Type": "application/json"} + +# 1. Add a memory +requests.post(f"{base}/add/message", headers=headers, json={ + "user_id": "alice", + "conversation_id": "conv_001", + "messages": [{"role": "user", "content": "I like strawberry"}], +}) + +# 2. Search memories +res = requests.post(f"{base}/search/memory", headers=headers, json={ + "query": "What do I like?", + "user_id": "alice", +}) +print(res.json()) +``` + +**Next steps:** + +- [MemOS Cloud Getting Started](https://memos-docs.openmem.net/memos_cloud/quick_start/) — connect to MemOS Cloud and enable memory in minutes. +- [MemOS Cloud Platform](https://memos.openmem.net/?from=/quickstart/) — explore the Cloud dashboard, features, and workflows. ### 🖥️ Self-Host the MemOS Service diff --git a/README_ZH.md b/README_ZH.md index c99147579..2ef403383 100644 --- a/README_ZH.md +++ b/README_ZH.md @@ -93,18 +93,53 @@ MemOS 为 AI agent 提供长期记忆能力,典型场景: ## 🚀 快速开始 -MemOS 提供三种使用方式,按你的场景选择。 +MemOS 提供四种使用方式,按你的场景选择。 -| | 本地部署 | OpenClaw 云插件 | 本地插件 | -| ---- | ----------------- | ------------------------ | ----------------------- | -| 适合谁 | 自建基础设施的团队 | OpenClaw 用户,零运维 | Hermes/OpenClaw,100% 端侧 | -| 启动方式 | docker compose up | openclaw plugins install | npm install + 配置 | -| 依赖设施 | Neo4j + Qdrant | 无(使用 MemOS Cloud) | 无(本地 SQLite) | -| 数据存放 | 你的服务器 | MemOS Cloud | 你的机器 | +| | Cloud API | 本地部署 | OpenClaw 云插件 | 本地插件 | +| ---- | ------------ | ----------------- | ------------------------ | ----------------------- | +| 适合谁 | 自建应用,全托管 | 自建基础设施的团队 | OpenClaw 用户,零运维 | Hermes/OpenClaw,100% 端侧 | +| 启动方式 | 申请 API Key | docker compose up | openclaw plugins install | npm install + 配置 | +| 依赖设施 | 无(托管) | Neo4j + Qdrant | 无(使用 MemOS Cloud) | 无(本地 SQLite) | +| 数据存放 | MemOS Cloud | 你的服务器 | MemOS Cloud | 你的机器 | +### ☁️ 使用 Cloud API(托管) +想通过全托管服务给应用加记忆——无需自建任何基础设施。 +**1. 申请 API Key:** + +- 在 [MemOS 控制台](https://memos-dashboard.openmem.net/cn/quickstart/?source=landing) 注册。 +- 进入 **API Keys** 复制你的 Key(以 `mpg-` 开头),请妥善保存在服务端。 + +**2. 写入与检索记忆:** + +```python +import requests + +API_KEY = "mpg-..." # 请保存在服务端 +base = "https://memos.memtensor.cn/api/openmem/v1" +headers = {"Authorization": f"Token {API_KEY}", "Content-Type": "application/json"} + +# 1. 写入一条记忆 +requests.post(f"{base}/add/message", headers=headers, json={ + "user_id": "alice", + "conversation_id": "conv_001", + "messages": [{"role": "user", "content": "I like strawberry"}], +}) + +# 2. 检索记忆 +res = requests.post(f"{base}/search/memory", headers=headers, json={ + "query": "What do I like?", + "user_id": "alice", +}) +print(res.json()) +``` + +**下一步:** + +- [MemOS Cloud 快速开始](https://memos-docs.openmem.net/memos_cloud/quick_start/)——几分钟内接入 MemOS Cloud 并启用记忆。 +- [MemOS Cloud 平台](https://memos.openmem.net/?from=/quickstart/)——探索云端控制台、功能与工作流。 ### 🖥️ 本地部署 MemOS 服务