Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
46 commits
Select commit Hold shift + click to select a range
78ae7a5
fix(memos-local-plugin): handle full endpoint paths in openai_compati…
liuhaibin0528 May 8, 2026
38fbcfc
Fix #1540: fix: (#1824)
Memtensor-AI Jun 14, 2026
576b408
Fix #1888: [Bug] test_system_parser.py: SystemParser.__init__() got a…
Memtensor-AI Jun 14, 2026
968930f
Fix #1525: [Bug] clean_json_response crashes with cryptic AttributeEr…
Memtensor-AI Jun 14, 2026
8bfef25
Fix #1901: share_cube_with_user passes swapped args to _validate_cube…
Memtensor-AI Jun 14, 2026
8aef4a6
fix(capture): skip orphan trace insert during dirty-reward recovery
chiefmojo May 28, 2026
d2ec89b
fix(bridge): extend startup poll window and prevent double-spawn
chiefmojo May 28, 2026
4afaa3c
fix(auth): restrict /api/v1/rpc session exemption to loopback callers
chiefmojo May 28, 2026
ca2b385
fix(memos): apply Memtensor-AI review feedback to PR #1817
fayenix May 28, 2026
0398e0e
Merge branch 'main' into pr/may27-fixes
chiefmojo Jul 4, 2026
257b2be
feat: route embedding input types by usage
RerankerGuo Jul 1, 2026
23b39dd
fix: tighten skill generation policy prompts
RerankerGuo Jul 1, 2026
3e67ae8
refactor(mem-reader): remove dead remove_prompt_example branch in Str…
nuthalapativarun Jul 8, 2026
afada8c
docs: clarify API product model descriptions (#1810)
Lucas-FManager Jul 8, 2026
713ed02
fix: correct "monitering" typo in task_id field descriptions (#1931)
nuthalapativarun Jul 8, 2026
d9046d6
fix: quote OpenClaw FTS query terms (#2043)
RerankerGuo Jul 8, 2026
d2adf17
docs: fix Quick Start examples in Chat & Message API docs to match Me…
hiasky Jul 8, 2026
10014cf
docs: translate API reference pages (#2053)
RerankerGuo Jul 9, 2026
d7f15b0
fix: align Gemini viewer embedding test (#2050)
RerankerGuo Jul 9, 2026
c4ed7a2
fix: add durable Hermes provider link (#2051)
RerankerGuo Jul 9, 2026
e508065
fix: delimit memory context with XML boundary (#2052)
RerankerGuo Jul 9, 2026
98b0372
fix: load bridge package version without require (#1992)
RerankerGuo Jul 9, 2026
46dff5b
fix: log LLM error response bodies (#2012)
RerankerGuo Jul 9, 2026
2c48b49
fix(skill-crystallize): retry with context when LLM returns empty res…
34262315716 Jul 9, 2026
598b674
fix: avoid blocking OpenClaw plugin registration (#2044)
RerankerGuo Jul 9, 2026
edcd7c8
fix: bridge startup race, dirty-reward orphan traces, RPC loopback au…
syzsunshine219 Jul 9, 2026
de03ab2
Fix #2063: algorithm.lightweightMemory.enabled: true does not actuall…
Memtensor-AI Jul 9, 2026
a9338d8
feat: add configurable CJK keyword tokenization (#2040)
RerankerGuo Jul 9, 2026
43b8f2e
feat: route embedding input types by usage (#2024)
syzsunshine219 Jul 9, 2026
365bd8b
feat(memos-local): add data export endpoint and UI (closes #1474) (#1…
owensun6 Jul 9, 2026
347ce82
Merge branch 'dev-v2.0.23' into fix/openai-compatible-endpoint-path-d…
syzsunshine219 Jul 9, 2026
0f4d286
fix(memos-local-plugin): handle full endpoint paths in openai_compati…
syzsunshine219 Jul 9, 2026
11758c9
fix: add missing contracts.tools declaration for OpenClaw tool allowl…
saraphine001 Jul 9, 2026
8436e3f
fix: Disable thinking for qwen3 preference extractor
bittergreen Jul 8, 2026
c739e9f
fix: ruff
bittergreen Jul 9, 2026
bcb711e
fix: Disable thinking for qwen3 preference extractor (#2079)
bittergreen Jul 9, 2026
8db255e
fix: tests for preference extractors (#2080)
bittergreen Jul 9, 2026
4053c25
feat(memos-local): make auto-recall Phase 1 search parameters configu…
yongren-del Jul 9, 2026
40f8e83
docs: rewrite README around three usage scenarios + add bilingual REA…
shinetata Jul 9, 2026
fda8c22
fix: quarantine stale sqlite native binding (#2049)
RerankerGuo Jul 9, 2026
ff1b1be
fix: tighten skill generation policy prompts (#2014)
syzsunshine219 Jul 9, 2026
9deb941
feat(l3): dedicated l3Llm config slot for abstraction pass (#1959)
chiefmojo Jul 9, 2026
142fad4
fix: publish compiled OpenClaw plugin entry (#2084)
syzsunshine219 Jul 9, 2026
59c1474
Fix #2076: local-plugin v2.0.8: gateway CPU 100% — synchronous full-t…
Memtensor-AI Jul 9, 2026
7a17ce1
chore: update version to 2.0.23
Jul 9, 2026
906b45b
Merge branch 'main' into dev-v2.0.23
CarltonXiang Jul 9, 2026
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
522 changes: 177 additions & 345 deletions README.md

Large diffs are not rendered by default.

302 changes: 302 additions & 0 deletions README_ZH.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,302 @@
<div align="center">
<h1 align="center">
<a href="https://memos.openmem.net/">
<img src="https://statics.memtensor.com.cn/logo/memos_color_m.png" alt="MemOS Logo" width="48"/>
</a>&nbsp;
MemOS 2.0&ensp;Stardust(星尘)
</h1>

<p align="center">
<a href="https://memos-docs.openmem.net/home/overview/"><img src="https://img.shields.io/badge/Docs-Get--Start-002FA7?labelColor=gray&style=for-the-badge&logo=googledocs&logoColor=white" alt="Docs"></a>
<a href="https://arxiv.org/abs/2507.03724"><img src="https://img.shields.io/badge/ArXiv-2507.03724-B31B1B?labelColor=gray&style=for-the-badge&logo=arxiv&logoColor=white" alt="ArXiv"></a>
<a href="https://x.com/MemOS_dev"><img src="https://img.shields.io/badge/Follow-MemOS-000000?labelColor=gray&style=for-the-badge&logo=x&logoColor=white" alt="X"></a>
<a href="https://discord.gg/Txbx3gebZR"><img src="https://img.shields.io/badge/dynamic/json?url=https%3A%2F%2Fdiscord.com%2Fapi%2Fv10%2Finvites%2FTxbx3gebZR%3Fwith_counts%3Dtrue&query=%24.approximate_presence_count&suffix=%20online&label=Discord&color=404EED&labelColor=gray&style=for-the-badge&logo=discord&logoColor=white" alt="Discord"></a>
<br>
<a href="https://github.com/IAAR-Shanghai/Awesome-AI-Memory"><img src="https://img.shields.io/badge/Resources-Awesome--AI--Memory-8A2BE2?labelColor=gray&style=for-the-badge&logo=awesomelists&logoColor=white" alt="Resources"></a>
</p>

<p align="center">
<strong>让 Agent 拥有持续记忆与成长能力</strong><br/>
</p>

<p align="center">
<a href="README.md">English</a> | <strong>中文</strong>
</p>
</div>


<div align="center">
<img width="1660" height="664" alt="MemOS Plugin Banner" src="https://github.com/user-attachments/assets/9d15dde2-196e-4f71-a364-dd5a33062117" />
</div>

---

## 👾 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 协作,配套完整记忆查看器面板。



## 📊 性能表现

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 提供四种使用方式,按你的场景选择。


| | 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 服务

想把 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())
```



### 🧠 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 获得持久记忆——无需自建基础设施。

- **仓库:** [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 召回记忆,运行结束后把新消息写回。

#### 2. 本地插件(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/`

安装(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 存储。

## 🤝 社区

- **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)
- **微信:** 扫码加入微信群。

<div align="center">
<img src="https://statics.memtensor.com.cn/memos/qr-code.png" alt="QR Code" width="300" />
</div>



## 📚 引用

如果在研究中使用 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) 开源。
Loading
Loading