Quickstart

Install → init → store → recall in under 2 minutes.

Using OpenClaw? Skip the manual setup — install the memoclaw-hooks package and your agent gets persistent memory automatically. Three commands, zero code.

Get started in 4 steps

1. Install the CLI

   npm install -g memoclaw
   
2. Initialize your wallet

   memoclaw init
   

   This generates a new wallet, saves your config to ~/.memoclaw/config.json, and gives you 100 free API calls. No accounts, no API keys.

   ✔ Generated new wallet: 0x1a2B...9cDe
   ✔ Saved config to ~/.memoclaw/config.json
   ✔ Free tier: 100 calls remaining
   
   You're ready to go! Try: memoclaw store "Hello, MemoClaw"
   

   Already have a wallet? Pass it directly:

   memoclaw init --private-key 0xYourExistingKey
   
3. Store a memory

   memoclaw store "User prefers dark mode and vim keybindings"
   

   {
     "id": "550e8400-e29b-41d4-a716-446655440000",
     "stored": true,
     "tokens_used": 8
   }
   
4. Recall it

   memoclaw recall "What are the user's editor preferences?"
   

   [0.847] User prefers dark mode and vim keybindings
     tags: preferences, editor
   

That’s it. Your agent now has persistent memory.

---

Using namespaces

Namespaces isolate memories per project:

memoclaw store "Uses PostgreSQL 15 with pgvector" --namespace acme-api
memoclaw recall "database setup" --namespace acme-api

CLI reference

memoclaw store "content" --importance 0.9 --tags tag1,tag2 --namespace project-x
memoclaw recall "query" --limit 10 --min-similarity 0.7 --namespace project-x
memoclaw list --limit 20 --namespace project-x
memoclaw delete <memory-id>
memoclaw migrate ~/path/to/memory/files   # Import OpenClaw files

Pricing

Endpoints using OpenAI are charged per request (USDC on Base). Every wallet gets 100 free API calls — no payment required. After that, you pay per request. List, get, delete, search, and stats endpoints are always free.

Operation	Cost
Store	$0.005
Store Batch (up to 100)	$0.04
Recall	$0.005
List	FREE
Migrate	$0.01

See full pricing for all endpoints.

Next steps

OpenClaw Hooks

Automatic memory for OpenClaw agents. Install, restart, done.

Migration Guide

Moving from OpenClaw? Import your memory files in one command.

MCP Integration

Use MemoClaw as an MCP server for any compatible client.

API Reference

Explore all available endpoints.