playbooks

home / skills / openclaw / skills / supermemory

supermemory skill

/skills/clawdbot51-oss/supermemory

This skill stores, searches, and chats with memories using the SuperMemory API, helping you organize knowledge and retrieve insights quickly.

npx playbooks add skill openclaw/skills --skill supermemory

Review the files below or copy the command above to add this skill to your agents.

Files (5)
SKILL.md
2.2 KB
---
name: supermemory
description: Store and retrieve memories using the SuperMemory API. Add content, search memories, and chat with your knowledge base.
metadata: {"moltbot":{"emoji":"🧠","requires":{"env":["SUPERMEMORY_API_KEY"]},"primaryEnv":"SUPERMEMORY_API_KEY"},"user-invocable":true}
---

# SuperMemory

Store, search, and chat with your personal knowledge base using SuperMemory's API.

## Setup

Configure your SuperMemory API key:
```bash
export SUPERMEMORY_API_KEY="sm_oiZHA2HcwT4tqSKmA7cCoK_opSRFViNFNxbYqjkjpVNfjSPqQWCNoOBAcxKZkKBfRVVrEQDVxLWHJPvepxqwEPe"
```

## Usage

### Add a Memory

**Add content to your memory store:**
```bash
# Add a memory with content
supermemory add "Your memory content here"

# Add a memory with a specific description
supermemory add "Important project details" --description "Project requirements"
```

### Search Memories

**Search your stored memories:**
```bash
supermemory search "search query"
```

### Chat with Memories

**Chat with your memory database:**
```bash
supermemory chat "What do you know about my projects?"
```

## Implementation

### Add Memory

When user wants to store information:
```bash
bash /root/clawd/skills/supermemory/scripts/add-memory.sh "content" "description (optional)"
```

### Search Memories

When user wants to find something in their memories:
```bash
bash /root/clawd/skills/supermemory/scripts/search.sh "query"
```

### Chat with Memory Base

When user wants to query their memory database conversationally:
```bash
bash /root/clawd/skills/supermemory/scripts/chat.sh "question"
```

## Examples

**Store important information:**
- "Remember that my API key is xyz" → `supermemory add "My API key is xyz" --description "API credentials"`
- "Save this link for later" → `supermemory add "https://example.com" --description "Bookmarked link"`

**Find information:**
- "What did I save about Python?" → `supermemory search "Python"`
- "Find my notes on the project" → `supermemory search "project notes"`

**Query your knowledge:**
- "What do I know about the marketing strategy?" → `supermemory chat "What do I know about the marketing strategy?"`
- "Summarize what I've learned about AI" → `supermemory chat "Summarize what I've learned about AI"`

Overview

This skill connects your agent to the SuperMemory API to store, search, and chat with a personal knowledge base. It provides simple commands to add memories, run semantic searches, and have conversational queries over your saved content. Use it to offload notes, bookmarks, and important context that your agent can recall later.

How this skill works

The skill sends content to SuperMemory to create persistent memory entries with optional descriptions. It performs semantic searches across stored memories and returns ranked results. For conversational access it forwards a user query to SuperMemory and returns a synthesized response based on relevant memories.

When to use it

  • Persist important short- or long-term notes for future recall
  • Search for previously saved information without remembering exact keywords
  • Summarize and query accumulated knowledge about projects or topics
  • Keep a history of links, credentials, or decisions outside session state
  • Enable an agent to reference past interactions and context across sessions

Best practices

  • Save focused, self-contained memories (one idea per entry) to improve search relevance
  • Include short descriptions or tags to make later discovery easier
  • Avoid storing sensitive secrets in plain text; prefer secure vaults for credentials
  • Use search first to locate memories before adding duplicates
  • Periodically review and prune outdated or irrelevant memories

Example use cases

  • Save meeting notes or action items: add meeting highlights and deadlines for later retrieval
  • Bookmark resources: store URLs with descriptions for research or reading lists
  • Project memory: collect requirements, design decisions, and status updates for team context
  • Personal knowledge base: accumulate learnings on topics like AI, marketing, or tools and ask for summaries
  • Troubleshooting history: keep logs of fixes and error contexts to accelerate future debugging

FAQ

How do I add a memory?

Call the add command with content and optional description; the skill stores it via the SuperMemory API.

Can I search with natural language?

Yes. The skill uses semantic search, so natural language queries return relevant memories even without exact keyword matches.