🚀 Quick Start

MemOS is built around four entry points. Pick the one that matches your scenario.

☁️ 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.
• 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"}

🧠 MemOS Plugin: Persistent Memory for Your AI Agents ✨

MemOS gives OpenClaw, Hermes, and DeepSeek Harness a shared local memory core; the managed MemOS Cloud Plugin is available for OpenClaw and DeepSeek Harness 🏃🏻

1. MemOS Cloud Plugin

Use MemOS Cloud for persistent memory in OpenClaw or DeepSeek Harness — no infrastructure to run.

• Repo: MemTensor/MemOS · 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/
• Tutorial: https://memos-docs.openmem.net/openclaw/guide

Install:

openclaw plugins install @memtensor/memos-cloud-openclaw-plugin@latest
openclaw gateway restart

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

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.
2. Install the cloud plugin into the default DSH web profile:

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

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

   MEMOS_API_KEY: mpg-your-key
   

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

   memos-cloud:
     apiKeyEnv: MEMOS_API_KEY
   

1. Restart the DSH Web profile:

   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 · 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
• DeepSeek Harness: integration details
• Viewer dashboard: see apps/memos-local-plugin/viewer/

Install for DeepSeek Harness (macOS / Linux):

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):

curl -fsSL https://raw.githubusercontent.com/MemTensor/MemOS/main/apps/memos-local-plugin/install.sh | bash

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 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.