Use in Agents

In addition to calling the cloud APIs directly, you can connect MemOS to your AI workflow through plugins, MCP, CLI, and other integration methods if you use:

• Agent frameworks such as OpenClaw and Hermes.
• AI clients such as Cursor, VS Code, Claude Desktop, Cline, and Chatbox.
• Any Agent or development environment that can execute shell commands.

These integration methods help you save tokens while adding long-term memory to your Agent workflows.

Quick Integration (Recommended)

You can connect MemOS automatically by chatting with your Agent in natural language. Once it is done, you can start chatting right away with no extra setup.

Use the Plugin

MemOS currently provides a cloud plugin deeply integrated with OpenClaw. If you use OpenClaw, prefer the plugin integration. Copy the following prompt and paste it into your OpenClaw chat:

Help me set up the MemOS OpenClaw plugin. Follow these steps:

1. Verify the API Key
   Check the value of MEMOS_API_KEY in the commands of step 2:
   - If it is already a real API Key starting with mpg-, go straight to step 2
   - If it is still a placeholder, guide the user to open
     https://memos-dashboard.openmem.net/quickstart/ to get an API Key,
     then replace the placeholder in the commands with the real Key

2. Configure the API Key environment variable
   Detect the current operating system first, then write it accordingly:

   macOS / Linux:
     mkdir -p ~/.openclaw
     echo 'MEMOS_API_KEY=YOUR_API_KEY' >> ~/.openclaw/.env

   Windows PowerShell:
     [System.Environment]::SetEnvironmentVariable("MEMOS_API_KEY", "YOUR_API_KEY", "User")

3. Install and enable the plugin
   openclaw plugins install @memtensor/memos-cloud-openclaw-plugin@latest
   openclaw gateway restart

4. Verify the installation
   Read ~/.openclaw/openclaw.json (%USERPROFILE%\.openclaw\openclaw.json on Windows),
   and confirm that under plugins.entries, memos-cloud-openclaw-plugin has enabled set to true

OpenClaw will install the plugin, prompt you to get an API Key, and complete all the configuration.

Use the MemOS CLI

The MemOS CLI provides a more universal way to integrate with Agents and works with any Agent framework that can execute shell commands. Copy the following prompt and send it to your Agent:

Help me set up the MemOS CLI development environment. Follow these steps:
1. Install the MemOS CLI globally
npm i -g @memtensor/memos-cloud-cli
2. Initialize the CLI configuration
memos init --api-key YOUR_API_KEY --agent <your agent>
For step 2, pass the --agent parameter matching the Agent the user is using.
If the value of --api-key is already a real Key starting with mpg-, run it directly;
if it is still a placeholder, first guide the user to open
https://memos-dashboard.openmem.net/ to get an API Key and replace it.

Your Agent will install the MemOS CLI and configure the corresponding Skill automatically (View supported Agents).

Manual Configuration

1. Before You Start

• Register and sign in to the MemOS Cloud platform.
• Get an API Key from the API Key page.

2. Use the Plugin

MEMOS_API_KEY=YOUR_API_KEY

mkdir -p ~/.openclaw
echo 'MEMOS_API_KEY=YOUR_API_KEY' >> ~/.openclaw/.env

[System.Environment]::SetEnvironmentVariable("MEMOS_API_KEY", "YOUR_API_KEY", "User")

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

{
  "plugins": {
    "entries": {
      "memos-cloud-openclaw-plugin": { "enabled": true }
    }
  }
}

3. Use MCP

Mainstream clients that support MCP include Cursor, Claude Desktop, Cline, VS Code / Trae, and Chatbox. Taking Cursor as an example, after configuration, Cursor can directly call MemOS memory tools and use memory across clients.

Cursor Settings → Tools & MCP → Add Custom MCP

{
  "mcpServers": {
    "memos-api-mcp": {
      "timeout": 60,
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@memtensor/memos-api-mcp@latest"
      ],
      "env": {
        "MEMOS_API_KEY": "YOUR_API_KEY",
        "MEMOS_USER_ID": "your-user-id",
        "MEMOS_CHANNEL": "MODELSCOPE"
      }
    }
  }
}

Before answering the user's question, call MemOS search_memory to search long-term memories related to the current task.
After answering, if this turn contains new user facts, preferences, project background, or other information useful in the long term, call add_message to write it into MemOS.
Only use memories relevant to the current task. Ignore memories that are irrelevant, outdated, or about the wrong subject.
Do not expose internal implementation details such as "memory store" or "retrieval results" to the user.

4. Use CLI + Skill

If your Agent framework can execute shell commands (e.g. Cursor, Codex, Claude Code, Hermes), you can use the MemOS CLI to install a memory Skill with one command, enabling your Agent to automatically search and write memories.

npm install -g @memtensor/memos-cloud-cli

memos init --agent cursor
memos init --api-key YOUR_API_KEY --agent cursor

memos init --agent cursor    # ~/.cursor/skills/memos/
memos init --agent codex     # ~/.codex/skills/memos/
memos init --agent claude    # ~/.claude/skills/memos/
memos init --agent openclaw  # ~/.openclaw/skills/memos/
memos init --agent hermes    # ~/.hermes/skills/memos/

Which Integration Should You Choose?

Next Steps