Maximem Vity

OpenClaw’s memory is local. This plugin makes it universal. Sync your AI context across OpenClaw, ChatGPT, Claude, Gemini, Manus, and many more, so you never re-explain yourself again.

Features

Long-term memory: Saves what is relevant for personalizing your OpenClaw and other AI app experiences as memories from your OpenClaw usage, in your Vity account: facts, preferences, goals, constraints, and more.
Your data: Your memories belong to your Vity account, and your keys and sign-in reach only your own memories. Vity is not end-to-end encrypted: Vity and the outside AI model providers it uses process your conversations to make memories. You can delete memories in the dashboard, one at a time or several at once, or have your agent forget them. Memories cannot be exported, and the only way to delete everything from the dashboard is to delete your account. Privacy and data has the full picture.
Cross-platform sync: Chats the browser extension saves from ChatGPT, Claude, Gemini, Manus, and other supported sites go into the same memory, and OpenClaw uses them automatically. The extension doesn’t save Perplexity chats; bring those in with an import.
Cross-channel memory: Memories persist across Telegram, Slack, WhatsApp, Discord, and all supported channels.
Auto-recall: Automatically injects relevant memories before each LLM turn.
Auto-capture: Automatically stores conversation context after each turn.
Slash commands: /remember and /recall for direct memory interaction.
Agent tools: maximem_store, maximem_search, maximem_forget for agent-driven memory operations.
CLI commands: Terminal-based memory management with openclaw maximem: search, stats, wipe and help.

API key

You’ll need a Maximem API key to use this plugin.

Sign up or log in at app.maximem.ai.
Open API Keys in the sidebar.
Click Generate API Key, enter a name, and click Generate Key.
Copy your key (starts with mx_...). Vity shows it only once.

Configuration covers keys in more detail, including how to revoke one.

Keep this key secure. Anyone who has it can read, add to and delete from your memory. Put it only in an environment variable or your config file, and never paste it into a chat with your agent.

Installation

openclaw plugins install @maximem/memory-plugin

That’s it. The plugin is now installed.

Verify installation

openclaw plugins list

You should see memory-plugin in the list with status enabled.

Run diagnostics

If something isn’t working:

openclaw plugins info memory-plugin
openclaw plugins doctor

Configuration

Option 1: Environment variable (recommended)

Set your API key as an environment variable. This keeps it out of config files.

macOS / Linux (zsh)
macOS / Linux (bash)
Windows PowerShell

echo 'export MAXIMEM_API_KEY="mx_..."' >> ~/.zshrc
source ~/.zshrc

echo 'export MAXIMEM_API_KEY="mx_..."' >> ~/.bashrc
source ~/.bashrc

[System.Environment]::SetEnvironmentVariable("MAXIMEM_API_KEY", "mx_...", "User")

Then restart your terminal, and restart OpenClaw so it reads the key.

Option 2: Config file

Edit ~/.openclaw/openclaw.json:

{
  "plugins": {
    "entries": {
      "memory-plugin": {
        "enabled": true,
        "config": {
          "apiKey": "mx_...",
          "autoRecall": true,
          "autoCapture": true,
          "maxRecallTokens": 1000,
          "minPromptLength": 5,
          "captureDebounceMs": 2000,
          "recallSlashLimit": 5,
          "recallSlashMinScore": 0.3
        }
      }
    }
  },
  "agents": {
    "list": [{
      "id": "main",
      "tools": {
        "allow": ["maximem_store", "maximem_search", "maximem_forget"]
      }
    }]
  }
}

Configuration options

Option	Type	Default	Description
`apiKey`	string	none	Your Maximem API key. Required (or set `MAXIMEM_API_KEY` env var).
`autoRecall`	boolean	`true`	Automatically inject relevant memories before each turn. Recommended: keep enabled.
`autoCapture`	boolean	`true`	Automatically capture conversation context after each turn. Recommended: keep enabled.
`maxRecallTokens`	number	`1000`	Maximum tokens for recalled memory context (100 to 10000). Higher = more context, more API usage.
`minPromptLength`	number	`5`	Minimum prompt length to trigger recall. Prevents recall on very short messages like “hi”.
`captureDebounceMs`	number	`2000`	Debounce window for batching captures (milliseconds). Lower = faster capture, more API calls.
`recallSlashLimit`	number	`5`	How many results `/recall` returns (1 to 20). Add `--limit` at the end of a `/recall` message to change it for one search.
`recallSlashMinScore`	number	`0.3`	The lowest relevance score (0 to 1) that `/recall` shows. Add `--min-score` at the end of a `/recall` message to change it for one search.

Usage

Quick start

Once installed and configured, the plugin works automatically:

You chat with OpenClaw on any channel (WhatsApp, Slack, Telegram, etc.).
Vity recalls relevant context from your AI history, including past ChatGPT, Claude, and Gemini conversations the browser extension saved.
OpenClaw responds with full awareness of your cross-platform context.
Vity captures new information for future sessions.

No manual action needed. It just works. Use the commands below when you want direct control.

Slash commands

Use these commands directly in any supported chat channel.

`/remember [text]`

/remember My favorite programming language is TypeScript
/remember I prefer dark themes for all applications --category preference
/remember Project deadline is March 15, 2026 --importance medium

Response:

Stored in memory: "My favorite programming language is TypeScript"

The reply shows the first 60 characters of what you saved, followed by ... if the text is longer.

`/recall [query]`

Search your long-term memory across all channels. By default it returns up to 5 results with a relevance score of at least 0.3; the recallSlashLimit and recallSlashMinScore options change those defaults. To change them for one search, add --limit N (1 to 20) or --min-score 0.x at the end of the message.

/recall favorite programming language
/recall project deadline --limit 10
/recall preferences --min-score 0.5

Response:

Found 2 memories:

1. [preference] (87%) My favorite programming language is TypeScript
2. (62%) I prefer dark themes for all applications

Each result shows its relevance score as a percentage, and its category in square brackets when it has one. If nothing matches, you get No matching memories found.

CLI commands

Manage memories from your terminal.

Search memories

openclaw maximem search "favorite color"
openclaw maximem search "deadlines" --limit 20
openclaw maximem search "preferences" --json

Options:

-l, --limit <n>: Maximum results (default: 10, maximum: 20; a higher number is lowered to 20 with a warning)
-c, --category <cat>: Only show one category: preference, fact, task, relationship or context
--json: Output as JSON for scripting

Without --json, each result prints as a line with its category, relevance score and text, then a second line with the memory’s ID and creation date.

Count your memories

openclaw maximem stats

Prints Memories on this account: followed by a count. The count comes from a preview of a delete request, which stops at 1,000, so a larger total shows as 1000+ with a note to check the dashboard for the exact number.

Delete your memories

openclaw maximem wipe
openclaw maximem wipe --dry-run
openclaw maximem wipe --yes

wipe counts your memories, asks Are you sure you want to delete N memories? (yes/no), and deletes them when you answer yes or y. Add --dry-run to see the count without deleting anything, or --yes to skip the question.

wipe deletes memories permanently, and it takes up to your 1,000 most recent memories in one run. If you have more, run it again. It deletes memories the same way the dashboard does; see Your controls.

Setup guide

openclaw maximem help

Prints the install and API key steps in your terminal.

Agent tools

Enable these tools in your agent configuration to let OpenClaw manage memory autonomously:

{
  "agents": {
    "list": [{
      "id": "main",
      "tools": {
        "allow": ["maximem_store", "maximem_search", "maximem_forget"]
      }
    }]
  }
}

With these enabled, your agent can:

Tool	What it does
`maximem_store`	Save important facts when you share information.
`maximem_search`	Recall memories when answering questions about past conversations.
`maximem_forget`	Remove memories that match what you describe (up to the 100 closest matches) when you ask it to. It previews what would be deleted unless the agent confirms with `dryRun` set to false. With no description it targets your 1,000 most recent memories.

Example interaction:

You: "Forget that I said I like Python. I've switched to Rust."

Agent: Done. I've removed the memory about Python and noted your preference for Rust.

Troubleshooting

”API key not found” error

Ensure your API key is set correctly:

echo $MAXIMEM_API_KEY

This should output your key (starting with mx_...). If it’s empty:

Re-run the export command from the Configuration section.
Restart your terminal.
Try again.

Memories not being recalled

Check config: ensure autoRecall is true.
Check prompt length: messages shorter than minPromptLength (default: 5 characters) won’t trigger recall.
Verify plugin status:
openclaw plugins list
Confirm memory-plugin shows as enabled.

Plugin not loading

Run diagnostics:

openclaw plugins doctor

This checks for common configuration issues and missing dependencies.

Context not syncing from other platforms

Make sure you have:

The Maximem Vity Chrome extension installed for web-based LLMs.
Signed in to the extension with the same Vity account that you generated this plugin’s API key in. Keys and the extension only share memory within one account.
Live Capture switched on for the sites you want saved (ChatGPT, Claude, etc.). There is one switch, in the dashboard under Settings, Apps, and it doesn’t cover every site. The browser extension page shows which sites save chats and how to switch it on.

Support

Documentation: Vity overview
Other plugins: Hermes Agent
Plugin site: maximem.ai/openclaw
Issues & bugs: GitHub Issues
Email: [email protected]
Twitter / X: @MaximemAI

Get started

Plugins and extensions

Apps

Vity MCP server

Settings

OpenClaw

Features

API key

Installation

Verify installation

Configuration

Option 1: Environment variable (recommended)

Option 2: Config file

Configuration options

Usage

Quick start

Slash commands

`/remember [text]`

`/recall [query]`

CLI commands

Search memories

Count your memories

Delete your memories

Setup guide

Agent tools

Troubleshooting

”API key not found” error

Memories not being recalled

Plugin not loading

Context not syncing from other platforms

Support

​Features

​API key

​Installation

​Verify installation

​Configuration

​Option 1: Environment variable (recommended)

​Option 2: Config file

​Configuration options

​Usage

​Quick start

​Slash commands

​/remember [text]

​/recall [query]

​CLI commands

​Search memories

​Count your memories

​Delete your memories

​Setup guide

​Agent tools

​Troubleshooting

​”API key not found” error

​Memories not being recalled

​Plugin not loading

​Context not syncing from other platforms

​Support

Features

API key

Installation

Verify installation

Configuration

Option 1: Environment variable (recommended)

Option 2: Config file

Configuration options

Usage

Quick start

Slash commands

`/remember [text]`

`/recall [query]`

CLI commands

Search memories

Count your memories

Delete your memories

Setup guide

Agent tools

Troubleshooting

”API key not found” error

Memories not being recalled

Plugin not loading

Context not syncing from other platforms

Support