Skip to main content

​
Installation

npm install -g memoclaw

​
Setup

​
memoclaw init

Generate a new wallet or configure an existing one. 
# Generate a new wallet
memoclaw init

# Use an existing wallet
memoclaw init --private-key 0xYourExistingKey
Config is saved to ~/.memoclaw/config.json. Every wallet gets 100 free API calls — no payment required to start.
FlagDescription
--private-key <key>Use an existing EVM private key

​
Storing Memories

​
memoclaw store

Store a single memory with semantic embeddings. 
memoclaw store "User prefers dark mode and vim keybindings" \
  --importance 0.8 \
  --tags preferences,editor \
  --namespace project-x
FlagTypeDefaultDescription
--importance <n>number0.5Importance score (0–1)
--tags <list>string—Comma-separated tags
--namespace <ns>stringdefaultMemory namespace
--type <type>stringgeneralMemory type: correction, preference, decision, project, observation, general
--agent <id>string—Agent identifier
--session <id>string—Session identifier
--pinnedflagfalsePin memory (exempt from decay)
Price: $0.005

​
memoclaw store-batch

Store multiple memories in a single request (up to 100). 
memoclaw store-batch \
  '{"content": "Uses PostgreSQL 15", "importance": 0.9}' \
  '{"content": "Deploys to Railway", "importance": 0.8}' \
  '{"content": "Team of 3 developers", "importance": 0.7}'
FlagTypeDefaultDescription
--namespace <ns>stringdefaultNamespace for all memories
--agent <id>string—Agent identifier
--session <id>string—Session identifier
Price: $0.04 per batch

​
Retrieving Memories

​
memoclaw recall

Semantic search — find memories by meaning. 
memoclaw recall "What are the user's editor preferences?" \
  --limit 5 \
  --min-similarity 0.7 \
  --namespace project-x
FlagTypeDefaultDescription
--limit <n>number10Max results (1–100)
--min-similarity <n>number0.0Minimum similarity threshold (0–1)
--tags <list>string—Filter by tags (match any)
--namespace <ns>stringdefaultFilter by namespace
--type <type>string—Filter by memory type
--after <date>string—Only memories after this ISO date
Price: $0.005 Full-text keyword search (no embeddings). Always free. 
memoclaw search "PostgreSQL" --limit 10 --namespace project-x
FlagTypeDefaultDescription
--limit <n>number10Max results (1–100)
--namespace <ns>stringdefaultFilter by namespace
--tags <list>string—Filter by tags
--type <type>string—Filter by memory type
--agent <id>string—Filter by agent
--session <id>string—Filter by session
Price: FREE

​
memoclaw list

List stored memories with pagination. 
memoclaw list --limit 20 --namespace project-x --tags preferences
FlagTypeDefaultDescription
--limit <n>number20Max results
--offset <n>number0Pagination offset
--namespace <ns>stringdefaultFilter by namespace
--tags <list>string—Filter by tags
--type <type>string—Filter by memory type
--agent <id>string—Filter by agent
Price: FREE

​
memoclaw suggested

Get proactive memory suggestions (stale, fresh, hot, decaying). 
memoclaw suggested --category stale --limit 5
FlagTypeDefaultDescription
--category <cat>string—stale, fresh, hot, or decaying
--limit <n>number10Max results
--namespace <ns>stringdefaultFilter by namespace
Price: FREE

​
Updating & Deleting

​
memoclaw delete

Delete a memory by ID. 
memoclaw delete 550e8400-e29b-41d4-a716-446655440000
Price: FREE

​
memoclaw update

Update an existing memory (content change re-embeds). 
memoclaw update 550e8400-e29b-41d4-a716-446655440000 \
  --importance 0.95 \
  --tags corrections,critical
FlagTypeDescription
--content <text>stringNew content (triggers re-embedding)
--importance <n>numberNew importance score
--tags <list>stringNew tags (replaces existing)
--type <type>stringNew memory type
--pinnedflagPin the memory
Price: $0.005 (if content changes), FREE (metadata-only update)

​
Intelligence

​
memoclaw ingest

Extract facts from a conversation, deduplicate, and optionally create relations. 
memoclaw ingest \
  --messages '[{"role":"user","content":"I prefer dark mode and use vim."},{"role":"assistant","content":"Got it!"}]' \
  --auto-relate \
  --namespace project-x
FlagTypeDefaultDescription
--messages <json>string—JSON array of {role, content} messages
--namespace <ns>stringdefaultTarget namespace
--auto-relateflagfalseAutomatically create relations between extracted facts
Price: $0.01

​
memoclaw consolidate

Merge similar/duplicate memories by clustering. 
memoclaw consolidate --namespace default --dry-run
FlagTypeDefaultDescription
--namespace <ns>stringdefaultTarget namespace
--min-similarity <n>number0.9Similarity threshold for merging
--dry-runflagfalsePreview without merging
Price: $0.01

​
Import & Export

​
memoclaw migrate

Import markdown files (.md) into MemoClaw. Each ## section becomes a separate memory. 
memoclaw migrate ~/.openclaw/workspace/memory/
FlagTypeDefaultDescription
--namespace <ns>stringdefaultTarget namespace
--dry-runflagfalsePreview without importing
Migration is idempotent — running it twice won’t create duplicates. Price: $0.01 per file

​
memoclaw export

Export all memories as JSON. 
memoclaw export --namespace project-x > memories.json
FlagTypeDefaultDescription
--namespace <ns>string—Filter by namespace
--agent <id>string—Filter by agent
--format <fmt>stringjsonOutput format
Price: FREE

​
Status & Info

​
memoclaw status

Check your free tier remaining calls and wallet info. 
memoclaw status

Wallet: 0x1a2B...9cDe
Free tier: 87/100 calls remaining
Price: FREE

​
memoclaw config

Show current configuration. 
memoclaw config

​
Relations

​
memoclaw relate

Create a directed relationship between two memories. 
memoclaw relate <source-id> <target-id> --type derived_from
FlagTypeDefaultDescription
--type <type>stringrelated_toRelation type: related_to, derived_from, contradicts, supersedes, supports
Price: FREE

​
Global Flags

These flags work with any command:
FlagDescription
--jsonOutput raw JSON instead of formatted text
--url <url>Override API URL (default: https://api.memoclaw.com)
--helpShow help for a command
--versionShow CLI version

​
Environment Variables

VariableDescription
MEMOCLAW_PRIVATE_KEYWallet private key (alternative to memoclaw init)
MEMOCLAW_URLAPI URL override
MEMOCLAW_NAMESPACEDefault namespace

​
Next Steps

Quickstart

Get started in under 2 minutes.

Recipes

Common patterns and examples.

OpenClaw Hooks

Automatic memory for OpenClaw agents.

Pricing

Full pricing breakdown.