Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
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
78 changes: 63 additions & 15 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -26,9 +26,16 @@


<div align="center">
<img width="1660" height="664" alt="MemOS Plugin Banner" src="https://github.com/user-attachments/assets/9d15dde2-196e-4f71-a364-dd5a33062117" />
<img width="1660" alt="MemOS agent ecosystem: OpenClaw, Hermes, and DeepSeek Harness" src="./assets/readme/memos-agent-ecosystem.png" />
</div>

> [!TIP]
> **New: Connect MemOS to DeepSeek Harness (`dsh`)**
>
> Add automatic recall, background capture, hybrid retrieval, and a local Memory Viewer to DeepSeek Harness—powered by the same MemOS core used across agent ecosystems.
>
> **[Get started →](#memos-plugin)**

---

## 👾 MemOS: Memory Operating System for LLM & AI Agents
Expand Down Expand Up @@ -93,12 +100,12 @@ MemOS gives AI agents long-term memory. Common uses:
MemOS is built around four entry points. Pick the one that matches your scenario.


| | 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 |
| | Cloud API | Self-Host | MemOS Cloud Plugin | Local Plugin |
| ------------ | ----------------------- | ------------------ | ------------------------ | ------------------------------------------------ |
| Best for | Your app, fully managed | Teams on own infra | OpenClaw users, zero ops | DeepSeek Harness, Hermes, or OpenClaw; on-device |
| Setup | Get an API key | docker compose up | openclaw plugins install | npm install + agent-specific setup |
| 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)

Expand Down Expand Up @@ -199,18 +206,20 @@ res = requests.post(f"{base}/search", headers=headers, data=json.dumps({
print(res.json())
```

<a id="memos-plugin"></a>

### 🧠 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 🏃🏻
MemOS gives OpenClaw, Hermes, and DeepSeek Harness a shared local memory core; the managed ***MemOS Cloud Plugin*** is available for OpenClaw and DeepSeek Harness 🏃🏻

| 🔌 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) |
| ☁️ **[MemOS 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) |

#### 1. OpenClaw Cloud Plugin
#### 1. MemOS Cloud Plugin

You use OpenClaw and want persistent memory via MemOS Cloud — no infrastructure to run.
Use MemOS Cloud for persistent memory in OpenClaw or DeepSeek Harness — no infrastructure to run.

- **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)`
Expand All @@ -226,16 +235,55 @@ openclaw gateway restart

The plugin recalls memories from MemOS Cloud before each agent run and saves new messages back after the run ends.

#### 2. Local Plugin (memos-local-plugin 2.0)
##### DeepSeek Harness

Connect DeepSeek Harness to MemOS Cloud through its native plugin mechanism. Before the first model step of each user request, the plugin recalls relevant cloud memories; after a successful turn, it saves the new user and assistant messages back to MemOS Cloud.

1. [Create a MemOS API Key](https://memos-dashboard.openmem.net/cn/apikeys/).
2. Install the cloud plugin into the default DSH `web` profile:

```bash
npx @deepseek-ai/dsh plugin --profile web add @memtensor/memos-cloud-dsh-plugin@latest
```

3. Add the API Key to `~/.dsh/.credentials.yaml`:

```yaml
MEMOS_API_KEY: mpg-your-key
```

4. Add the minimal plugin configuration to `~/.dsh/settings.yaml`:

```yaml
memos-cloud:
apiKeyEnv: MEMOS_API_KEY
```

You use Hermes Agent or OpenClaw and want 100% on-device memory — nothing leaves your machine.
5. Restart the DSH Web profile:

```bash
npx @deepseek-ai/dsh web
```

The cloud plugin is fail-open: a temporary MemOS Cloud outage does not interrupt the current DSH task.

#### 2. Local Plugin (OpenClaw, Hermes, and DeepSeek Harness)

You use DeepSeek Harness, Hermes Agent, or OpenClaw and want 100% on-device memory — nothing leaves your machine.

- **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)
- **DeepSeek Harness:** [integration details](./apps/memos-local-plugin/adapters/deepseek-harness/README.md)
- **Viewer dashboard:** see `apps/memos-local-plugin/viewer/`

Install (macOS / Linux):
Install for DeepSeek Harness (macOS / Linux):

```bash
curl -fsSL https://raw.githubusercontent.com/MemTensor/MemOS/main/apps/memos-local-plugin/install.sh | bash -s -- --agent dsh --profile web
```

Install for OpenClaw or Hermes (macOS / Linux):

```bash
curl -fsSL https://raw.githubusercontent.com/MemTensor/MemOS/main/apps/memos-local-plugin/install.sh | bash
Expand All @@ -247,7 +295,7 @@ Install (Windows 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.
Requires Node.js and an already-installed DeepSeek Harness, OpenClaw, or Hermes. The installer deploys MemOS to the selected agent runtime; the DeepSeek Harness target installs it as an out-of-tree DSH bundle, while the OpenClaw and Hermes targets write the initial `config.yaml` in their respective agent homes.

Features: hybrid retrieval (FTS5 + vector), smart dedup, tiered skill evolution (L1 traces / L2 policies / L3 world model), multi-agent collaboration, local-first SQLite storage.

Expand Down
80 changes: 64 additions & 16 deletions README_ZH.md
Original file line number Diff line number Diff line change
Expand Up @@ -26,9 +26,16 @@


<div align="center">
<img width="1660" height="664" alt="MemOS Plugin Banner" src="https://github.com/user-attachments/assets/9d15dde2-196e-4f71-a364-dd5a33062117" />
<img width="1660" alt="MemOS Agent 生态:OpenClaw、Hermes 与 DeepSeek Harness" src="./assets/readme/memos-agent-ecosystem.png" />
</div>

> [!TIP]
> **新支持:为 DeepSeek Harness(dsh)接入 MemOS**
>
> 在 DeepSeek Harness 中使用自动召回、后台记忆沉淀、混合检索和本地记忆查看器;它们均由同一套 MemOS 核心驱动,并可复用于不同 Agent 生态。
>
> **[开始接入 →](#memos-plugin)**

---

## 👾 MemOS:面向 LLM 与 AI Agent 的记忆操作系统
Expand Down Expand Up @@ -96,12 +103,12 @@ MemOS 为 AI 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 | 本地部署 | MemOS 云插件 | 本地插件 |
| ---- | ------------ | ----------------- | ------------------------ | --------------------------------------------- |
| 适合谁 | 自建应用,全托管 | 自建基础设施的团队 | OpenClaw 用户,零运维 | DeepSeek Harness、Hermes 或 OpenClaw,100% 端侧 |
| 启动方式 | 申请 API Key | docker compose up | openclaw plugins install | npm install + 按 Agent 配置 |
| 依赖设施 | 无(托管) | Neo4j + Qdrant | 无(使用 MemOS Cloud) | 无(本地 SQLite) |
| 数据存放 | MemOS Cloud | 你的服务器 | MemOS Cloud | 你的机器 |

### ☁️ 使用 Cloud API(托管)

Expand Down Expand Up @@ -204,22 +211,24 @@ print(res.json())



<a id="memos-plugin"></a>

### 🧠 MemOS 插件:为你的 AI agent 提供持久记忆 ✨

你的 OpenClaw 和 Hermes Agent 现在拥有**最佳**记忆系统——选择***云服务***或***自部署***即可开始 🏃🏻
OpenClaw、Hermes 与 DeepSeek Harness 均可接入同一套 MemOS 本地记忆核心;OpenClaw 与 DeepSeek Harness 还可选择托管的 ***MemOS 云插件*** 🏃🏻


| 🔌 插件 | 💡 核心特性 | 🧩 资源 |
| ----------------------------------------------------------------------------------------------------- | ------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| 🧠 **[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) |
| ☁️ **[MemOS 云插件](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 云插件
#### 1. MemOS 云插件

使用 OpenClaw,想通过 MemOS Cloud 获得持久记忆——无需自建基础设施。
使用 OpenClaw 或 DeepSeek Harness,想通过 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)`
Expand All @@ -235,16 +244,55 @@ openclaw gateway restart

插件在每次 agent 运行前从 MemOS Cloud 召回记忆,运行结束后把新消息写回。

#### 2. 本地插件(memos-local-plugin 2.0)
##### DeepSeek Harness

通过 DSH 原生插件机制为 DeepSeek Harness 接入 MemOS Cloud。每次用户请求的第一个模型步骤开始前,插件会自动召回相关云端记忆;当前回合成功结束后,再把新的用户与助手消息写回 MemOS Cloud。

1. 在 [MemOS 控制台创建 API Key](https://memos-dashboard.openmem.net/cn/apikeys/)。
2. 将云插件安装到 DSH 默认的 `web` profile:

```bash
npx @deepseek-ai/dsh plugin --profile web add @memtensor/memos-cloud-dsh-plugin@latest
```

3. 在 `~/.dsh/.credentials.yaml` 中写入 API Key:

```yaml
MEMOS_API_KEY: mpg-your-key
```

4. 在 `~/.dsh/settings.yaml` 中加入最小配置:

```yaml
memos-cloud:
apiKeyEnv: MEMOS_API_KEY
```

使用 Hermes Agent 或 OpenClaw,想要 100% 端侧记忆——数据不离开本机。
5. 重启 DSH Web profile:

```bash
npx @deepseek-ai/dsh web
```

云插件采用 Fail-open 机制:MemOS Cloud 临时不可用时,不会中断当前 DSH 任务。

#### 2. 本地插件(OpenClaw、Hermes 与 DeepSeek Harness)

使用 DeepSeek Harness、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)
- **DeepSeek Harness:** [接入说明](./apps/memos-local-plugin/adapters/deepseek-harness/README.md)
- **查看器面板:** 见 `apps/memos-local-plugin/viewer/`

安装(macOS / Linux):
接入 DeepSeek Harness(macOS / Linux):

```bash
curl -fsSL https://raw.githubusercontent.com/MemTensor/MemOS/main/apps/memos-local-plugin/install.sh | bash -s -- --agent dsh --profile web
```

安装 OpenClaw 或 Hermes(macOS / Linux):

```bash
curl -fsSL https://raw.githubusercontent.com/MemTensor/MemOS/main/apps/memos-local-plugin/install.sh | bash
Expand All @@ -256,7 +304,7 @@ curl -fsSL https://raw.githubusercontent.com/MemTensor/MemOS/main/apps/memos-loc
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 运行时。
需先安装 Node.js,且已安装 DeepSeek Harness、OpenClaw 或 Hermes。安装器会将 MemOS 部署到所选 Agent 运行时:DeepSeek Harness 以独立 DSH bundle 方式接入;OpenClaw 与 Hermes 则在各自的 Agent 主目录中写入初始 `config.yaml`。

特性:混合检索(FTS5 + 向量)、智能去重、分层技能演化(L1 轨迹 / L2 策略 / L3 世界模型)、多 agent 协作、本地优先 SQLite 存储。

Expand Down Expand Up @@ -299,4 +347,4 @@ irm https://raw.githubusercontent.com/MemTensor/MemOS/main/apps/memos-local-plug

## ⚖️ 许可证

MemOS 基于 [Apache 2.0 许可证](./LICENSE) 开源。
MemOS 基于 [Apache 2.0 许可证](./LICENSE) 开源。
Binary file added assets/readme/memos-agent-ecosystem.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading