Skip to main content
This integration requires the Supermemory Pro plan. Upgrade here.
OpenClaw is a multi-platform AI messaging gateway that connects to WhatsApp, Telegram, Discord, Slack, iMessage, and other messaging channels. The Supermemory plugin gives OpenClaw memory across every channel.

Install the Plugin

Get started by installing the plugin with a single command.
openclaw plugins install @supermemory/openclaw-supermemory
Restart OpenClaw after installing.

Setup

Run the setup command and enter your API key when prompted.
openclaw supermemory setup
Enter your API key from console.supermemory.ai. That’s it.
Configure all options interactively with the advanced setup command:
openclaw supermemory setup-advanced
This lets you configure: container tag, auto-recall, auto-capture, capture mode, custom container tags, and more.See Configuration Options for all available settings.

How It Works

Once installed, the plugin runs automatically with zero interaction.
  • Auto-Recall — Before every AI turn, Supermemory is queried for relevant memories and the user’s profile. These are injected as context so the AI sees preferences, facts, and semantically similar past conversations.
  • Auto-Capture — After every AI turn, the conversation exchange is sent to Supermemory for extraction and long-term storage. Supermemory handles deduplication and profile building.
  • Custom Container Tags — When enabled via advanced setup, define custom memory containers (e.g., work, personal, bookmarks). The AI automatically picks the right container based on your instructions.

Features

AI Tools

The AI can use these tools autonomously during conversations.
ToolDescription
supermemory_storeSave information to long-term memory.
supermemory_searchSearch memories by query with similarity scores.
supermemory_forgetDelete a memory by query or ID.
supermemory_profileView the user profile — persistent facts and recent context.

Slash Commands

Users can interact with memory directly in chat.
CommandDescription
/remember [text]Manually save something to memory.
/recall [query]Search memories and see results with similarity scores.

CLI Commands

Manage your memory from the terminal.
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 Options

KeyTypeDefaultDescription
apiKeystringSupermemory API key.
containerTagstringopenclaw_{hostname}Root memory namespace.
autoRecallbooleantrueInject relevant memories before every AI turn.
autoCapturebooleantrueStore conversation content after every turn.
maxRecallResultsnumber10Max memories injected into context per turn.
profileFrequencynumber50Inject full user profile every N turns.
captureModestring"all""all" filters noise. "everything" captures all messages.
debugbooleanfalseVerbose debug logs.
enableCustomContainerTagsbooleanfalseEnable custom container routing.
customContainersarray[]Custom containers with tag and description.
customContainerInstructionsstring""Instructions for AI on container routing.

Full Example

{
  "plugins": {
    "entries": {
      "openclaw-supermemory": {
        "enabled": true,
        "config": {
          "apiKey": "${SUPERMEMORY_OPENCLAW_API_KEY}",
          "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'"
        }
      }
    }
  }
}

Next Steps