playbooks

home / skills / robertknowles / openclaw-workspace / supermemory-1

supermemory-1 skill

/workspace/skills/supermemory-1

This skill stores, searches, and chats with memories via SuperMemory API, helping you organize knowledge and quickly retrieve relevant notes.

npx playbooks add skill robertknowles/openclaw-workspace --skill supermemory-1

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_qqDFbbsoAhtZ38N6LN8ukX_zAkYtvqurZfOdAylhpNpBPUoKXyhcHopIpUOvxaflgoDAeRTYfrVMLOIpNglRVaS"
```

## 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 to the SuperMemory API to store, search, and chat with a personal memory store. It provides simple commands to add content with optional descriptions, perform semantic searches, and run conversational queries against your knowledge base. Use it to persist facts, links, notes, and project details for later retrieval.

How this skill works

The skill sends content to the SuperMemory API to create memory entries and indexes them for semantic search. You can run search queries to retrieve relevant memories or start a chat session that queries and summarizes the memory store conversationally. CLI wrapper scripts are provided for add, search, and chat operations that call the API using your configured API key.

When to use it

  • Save facts, credentials, or short notes you want to recall later
  • Bookmark links, snippets, or resources tied to projects
  • Search for related information across past notes and memories
  • Get conversational summaries or answers based on your stored knowledge
  • Automate memory storage from other tools or agents

Best practices

  • Keep memory entries concise and focused on single facts or topics for better search relevance
  • Include a short description or tags when adding important memories to aid retrieval
  • Avoid storing sensitive secrets in plain text; follow secure storage practices
  • Use clear, searchable phrasing when creating memories (names, dates, project identifiers)
  • Regularly prune or archive outdated memories to maintain signal quality

Example use cases

  • Save a meeting summary or action items: add meeting notes with a description for the project
  • Store a configuration snippet or URL for later: add the link with a descriptive tag
  • Find all notes related to a topic: search "Python" or a project name to surface related memories
  • Ask for a consolidated view: chat "What do I know about the marketing strategy?" to get a summary
  • Automate backups: integrate the add command into workflows to log important events or decisions

FAQ

How do I authenticate with SuperMemory?

Set the SUPERMEMORY_API_KEY environment variable to your API key before running commands.

Can I search semantically or only by keyword?

Search supports semantic retrieval, so queries return relevant memories beyond exact keyword matches.