Install the Plugin
Get started by installing the plugin with a single command.Setup
Run the setup command and enter your API key when prompted.Advanced Setup
Advanced Setup
Configure all options interactively with the advanced setup command: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.| Tool | Description |
|---|---|
supermemory_store | Save information to long-term memory. |
supermemory_search | Search memories by query with similarity scores. |
supermemory_forget | Delete a memory by query or ID. |
supermemory_profile | View the user profile — persistent facts and recent context. |
Slash Commands
Users can interact with memory directly in chat.| Command | Description |
|---|---|
/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.Manual Configuration
Manual Configuration
Configuration Options
| Key | Type | Default | Description |
|---|---|---|---|
apiKey | string | — | Supermemory API key. |
containerTag | string | openclaw_{hostname} | Root memory namespace. |
autoRecall | boolean | true | Inject relevant memories before every AI turn. |
autoCapture | boolean | true | Store conversation content after every turn. |
maxRecallResults | number | 10 | Max memories injected into context per turn. |
profileFrequency | number | 50 | Inject full user profile every N turns. |
captureMode | string | "all" | "all" filters noise. "everything" captures all messages. |
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. |
