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 a private cloud-vault with encryption-at-rest and secure interfaces. Auto-consolidates and forgets stale information. Securely stores facts, preferences, episodes, goals, constraints, and more.
Short-term memory: Determines short-term memory needs from OpenClaw usage such as conversation summaries, tasks, facts, preferences, procedures, and more. Auto-converts them to long-term memory periodically.
Data privacy & security: You own all your data and only you can read your information. All LLM calls are made in secure mode. You have granular control to forget or delete what you need to.
Cross-platform sync: Save context from ChatGPT, Claude, Gemini, Manus, Perplexity, and other flows into your cloud-vault and use in OpenClaw automatically.
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.

API key

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

Sign up or log in at app.maximem.ai.
Navigate to Settings → API Keys.
Click Generate New Key.
Copy your key (starts with mx_...).

Keep this key secure. It grants access to your memory vault.

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.

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
        }
      }
    }
  },
  "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.

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 Perplexity conversations.
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]`

Manually save information to long-term memory.

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

Response:

✓ Saved to memory: "My favorite programming language is TypeScript"

`/recall [query]`

Search your long-term memory.

/recall favorite programming language
/recall project deadline
/recall preferences

Response:

Found 2 relevant memories:

1. "My favorite programming language is TypeScript" (saved 2 days ago)
2. "I prefer dark themes for all applications" (saved 1 week ago)

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)
--json: Output as JSON for scripting

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 specific memories when you ask it to.

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.
Logged into the same Maximem account in both the extension and this plugin.
Enabled sync for the platforms you want (ChatGPT, Claude, etc.) in your Vity settings.

Coming soon

openclaw maximem stats: view memory statistics and usage.
openclaw maximem wipe: bulk delete memories with filters.
Category-based filtering in search.

Support

Plugin site: memoryplugin-for-openclaw.com
Issues & bugs: GitHub Issues
Email: [email protected]
Twitter / X: @MaximemAI

​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

​Agent tools

​Troubleshooting

​”API key not found” error

​Memories not being recalled

​Plugin not loading

​Context not syncing from other platforms

​Coming soon

​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

Agent tools

Troubleshooting

”API key not found” error

Memories not being recalled

Plugin not loading

Context not syncing from other platforms

Coming soon

Support