How to Install and Use Supermemory in OpenClaw

Open your terminal and run the clawhub install command to add Supermemory to your OpenClaw instance. ClawHub downloads the supermemory skill package, verifies its integrity against the registry, and registers it with your local OpenClaw configuration. Installation takes 10-25 seconds. When it completes, the terminal shows a confirmation message with the installed version and the required configuration key: SUPERMEMORY_API_KEY. The skill is installed but inactive until you configure the API key — any attempts to save or retrieve memory before configuration will return a clear error pointing to the missing credential. After installation, run `clawhub info supermemory` to see the full list of available configuration options, including optional settings for default tags, memory categories, and retrieval preferences that you can configure later to customize how Supermemory organizes and surfaces your saved knowledge.

1clawhub install supermemory

Navigate to supermemory.ai and sign in or create an account. Supermemory offers a free tier that provides enough storage for personal use and initial exploration — check their pricing page for current tier details. Once logged in, navigate to your account settings or developer dashboard and look for 'API Keys' or 'Access Tokens'. Click to create a new API key and give it a descriptive name like 'OpenClaw Integration'. Supermemory generates the key immediately — copy it to your clipboard now. Your Supermemory API key is the authentication credential for all save and retrieve operations from OpenClaw. It is scoped to your Supermemory account, so all memories saved through OpenClaw are associated with your Supermemory account and accessible through the Supermemory web interface as well as through OpenClaw. Keep the key private — it grants full read and write access to your Supermemory knowledge store. If it is ever compromised, you can revoke it from the Supermemory dashboard and generate a new one without losing your saved memories.

Add your Supermemory API key to OpenClaw's configuration using the `clawhub config set` command or by adding it to your `~/.openclaw/.env` file. Both methods write to the same secure configuration store and the key will be available to the supermemory skill on next reload. After setting the key, run `clawhub reload` to apply the configuration without a full OpenClaw restart. Verify the key is correctly saved by running `clawhub config get SUPERMEMORY_API_KEY` — you should see a masked version of your key confirming it is present. Optionally, configure the supermemory skill's YAML file at `~/.openclaw/skills/supermemory.yaml` to set default behavior for saves and retrievals — such as a default space or default tags to apply to all saved memories from OpenClaw. These defaults make saving consistent without requiring you to specify organizational details in every prompt.

1# Option A: Add to ~/.openclaw/.env
2SUPERMEMORY_API_KEY=your_supermemory_api_key_here
3
4# Option B: Set via clawhub config command
5clawhub config set SUPERMEMORY_API_KEY your_supermemory_api_key_here
6
7# Verify the key is saved
8clawhub config get SUPERMEMORY_API_KEY
9
10# Apply changes
11clawhub reload

Open OpenClaw chat and test the Supermemory skill by saving a piece of information and then retrieving it in a new prompt. This two-step test confirms that both the save operation (write to Supermemory API) and the retrieve operation (read from Supermemory API) are working correctly. For the save test, provide a clear title, some content to save, and optionally some tags to categorize the memory. The supermemory skill formats this into a Supermemory API call and returns a confirmation with the memory ID once saved. For the retrieve test, reference the title or tags you used in the save and ask OpenClaw to search Supermemory for it. A successful retrieval returns the saved content with its title, tags, and the timestamp of when it was saved. Once the basic save/retrieve cycle works, you can explore more sophisticated retrieval patterns — semantic search across multiple saved memories, filtering by date range or tags, and combining retrieved context with fresh information from other skills.

With Supermemory working, establish a knowledge management habit that compounds in value over time. The most effective use of Supermemory is consistent, structured saving — tagging memories with topics, projects, or dates so that retrieval is precise rather than requiring broad semantic searches across everything you have ever saved. A practical workflow is to end each OpenClaw session with a save step: summarize the key insights, decisions, or outputs from the session and save them to Supermemory with the project name and date as tags. Over weeks, this builds a rich retrievable record of your work that OpenClaw can query at the start of future sessions. Supermemory also excels as the output target for other OpenClaw skills. After ByteRover produces a data analysis, save the summary to Supermemory. After Sag runs a validation pattern, save the findings. After Larry completes a weekly review, save the key points. Each skill output that would otherwise disappear at session end becomes a permanent, searchable record. RapidDev helps teams set up Supermemory as a shared organizational knowledge base within OpenClaw, particularly for teams who want consistent memory organization standards across multiple users and projects.

1# Configure Supermemory defaults in ~/.openclaw/skills/supermemory.yaml
2supermemory:
3  default_space: "openclaw"          # default Supermemory space for saves
4  default_tags: ["openclaw"]         # tags automatically added to every save
5  max_results: 10                    # max memories returned per search (default: 5)
6  retrieval_mode: "semantic"         # semantic | exact | hybrid (default: semantic)
7  include_metadata: true             # include timestamps and tags in retrieval
8  auto_save_summaries: false         # auto-save session summaries (optional feature)