@supermemory/openclaw-supermemory

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.

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

Command	Description
/remember <text>	Manually save something to memory.
/recall <query>	Search memories with similarity scores.

AI Tools

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

Tool	Description
supermemory_store	Save information to memory.
supermemory_search	Search memories by query.
supermemory_forget	Delete a memory by query or ID.
supermemory_profile	View user profile (persistent facts + recent context).

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

Key	Type	Default	Description
apiKey	string	—	Supermemory API key.
baseUrl	string	https://api.supermemory.ai	API endpoint. Set to a self-hosted / local URL to point at your own instance; leave blank for the cloud.
containerTag	string	openclaw_{hostname}	Root memory namespace.
autoRecall	boolean	true	Inject relevant memories before every AI turn.
autoCapture	boolean	true	Store conversations after every turn.
maxRecallResults	number	10	Max memories injected per turn.
profileFrequency	number	50	Inject full profile every N turns.
captureMode	string	"all"	"all" filters short texts, "everything" captures all.
debug	boolean	false	Verbose debug logs.
enableCustomContainerTags	boolean	false	Enable custom container routing.
customContainers	array	[]	Custom containers with tag and description.
customContainerInstructions	string	""	Instructions for AI on container routing.

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'"
        }
      }
    }
  }
}