OpenClaw Supermemory Plugin

Long-term memory for OpenClaw. Automatically remembers conversations, recalls relevant context, and builds a persistent user profile — all powered by Supermemory cloud. No local infrastructure required.

Requires Supermemory Pro or above - Unlock the state of the art memory for your OpenClaw bot.

Install

openclaw plugins install @supermemory/openclaw-supermemory

Setup

openclaw supermemory setup
openclaw gateway restart

Enter your API key from app.supermemory.ai. That's it.

Advanced Setup

openclaw supermemory setup-advanced
openclaw gateway restart

Configure all options interactively: container tag, auto-recall, auto-capture, capture mode, custom container tags, and more.

How it works

Once installed, the plugin works automatically:

• Auto-Recall — Before every AI turn, queries Supermemory for relevant memories and injects them as context. The AI sees your user profile and semantically similar past conversations.
• Auto-Capture — After every AI turn, the conversation is sent to Supermemory for extraction and long-term storage.
• Custom Container Tags — Define custom memory containers (e.g., work, personal, bookmarks). The AI automatically picks the right container based on your instructions when using memory tools.

Everything runs in the cloud. Supermemory handles extraction, deduplication, and profile building.

Slash Commands

AI Tools

The AI uses these tools autonomously. With custom container tags enabled, all tools support a containerTag parameter for routing to specific containers.

CLI Commands

openclaw supermemory setup              # Configure API key
openclaw supermemory setup-advanced     # Configure all options
openclaw supermemory status             # View current configuration
openclaw supermemory search <query>     # Search memories
openclaw supermemory profile            # View user profile
openclaw supermemory wipe               # Delete all memories (requires confirmation)

Configuration

Set API key (and, for self-hosted instances, the base URL) via environment variables:

export SUPERMEMORY_OPENCLAW_API_KEY="sm_..."
export SUPERMEMORY_BASE_URL="http://localhost:8000"   # optional; defaults to https://api.supermemory.ai

Or configure in ~/.openclaw/openclaw.json:

Options

Full Example

{
  "plugins": {
    "slots": {
      "memory": "openclaw-supermemory"
    },
    "entries": {
      "openclaw-supermemory": {
        "enabled": true,
        "hooks": {
          "allowPromptInjection": true,
          "allowConversationAccess": true
        },
        "config": {
          "apiKey": "${SUPERMEMORY_OPENCLAW_API_KEY}",
          "baseUrl": "https://api.supermemory.ai",
          "containerTag": "my_memory",
          "autoRecall": true,
          "autoCapture": true,
          "maxRecallResults": 10,
          "profileFrequency": 50,
          "captureMode": "all",
          "debug": false,
          "enableCustomContainerTags": true,
          "customContainers": [
            { "tag": "work", "description": "Work-related memories" },
            { "tag": "personal", "description": "Personal notes" }
          ],
          "customContainerInstructions": "Store work tasks in 'work', personal stuff in 'personal'"
        }
      }
    }
  }
}