Get Your API Key
Create a Supermemory API key from the API Keys page, then add it to your shell profile so it persists across sessions:- macOS / Linux (zsh)
- macOS / Linux (bash)
- Windows (PowerShell)
Install the Plugin
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.
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
Manual Configuration
Optional — only needed if you prefer to set the API key directly in the config file instead of the environment variable. Add the plugin to yourclawdbot.json:
Advanced Options
| Key | Type | Default | Description |
|---|---|---|---|
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. |