memoclaw

<security>
This skill requires MEMOCLAW_PRIVATE_KEY environment variable for wallet auth.
Use a dedicated wallet. The skill only makes HTTPS calls to api.memoclaw.com.
Free tier: 100 calls per wallet. After that, USDC on Base required.
</security>

# MemoClaw Skill

Persistent memory for AI agents. Store text, recall it later with semantic search.

No API keys. No registration. Your wallet address is your identity.

Every wallet gets 100 free API calls — just sign and go. After that, x402 micropayments ($0.005/call, USDC on Base).

---

## Prerequisites checklist

Before using any MemoClaw command, ensure setup is complete:

1. **CLI installed?** → `which memoclaw` — if missing: `npm install -g memoclaw`
2. **Wallet configured?** → `memoclaw config check` — if not: `memoclaw init`
3. **Free tier remaining?** → `memoclaw status` — if 0: fund wallet with USDC on Base

If `memoclaw init` has never been run, **all commands will fail**. Run it first — it's interactive and takes 30 seconds.

---

## Quick reference

> 📖 For full end-to-end examples (session flows, migration, multi-agent patterns, cost breakdown), see [examples.md](examples.md).

**Essential commands:**
```bash
memoclaw store "fact" --importance 0.8 --tags t1,t2 --memory-type preference   # save ($0.005)  [types: correction|preference|decision|project|observation|general]
memoclaw store --file notes.txt --importance 0.7 --memory-type general  # store from file ($0.005)
echo -e "fact1\nfact2" | memoclaw store --batch --memory-type general  # batch from stdin ($0.04)
memoclaw store "fact" --pinned --immutable --memory-type correction  # pinned + locked forever
memoclaw recall "query"                    # semantic search ($0.005)
memoclaw recall "query" --min-similarity 0.7 --limit 3  # stricter match
memoclaw search "keyword"                  # text search (free)
memoclaw context "what I need" --limit 10  # LLM-ready block ($0.01)
memoclaw core --limit 5                    # high-importance foundational mem...

# MemoClaw Skill

Persistent semantic memory for AI agents. Store facts, recall them later with natural language. No API keys — your wallet is your identity.

**Install:** `clawhub install memoclaw`

## 30-second quickstart

```bash
npm install -g memoclaw
memoclaw init                    # one-time wallet setup
memoclaw store "User prefers dark mode" --importance 0.8 --memory-type preference
memoclaw recall "UI preferences"  # semantic search
```

## How it works

1. **Store** facts with importance scores, tags, and memory types
2. **Recall** with natural language — vector search finds semantically similar memories
3. **Decay** naturally — memory types control half-lives (corrections: 180d, observations: 14d)
4. **Pin** critical facts so they never decay

Every wallet gets **100 free API calls**. After that, $0.005/call (USDC on Base).

## What agents get

| Feature | Details |
|---------|---------|
| Semantic recall | "What editor does the user prefer?" → finds "User likes Neovim with vim bindings" |
| Free-tier first | `core` + `search` are free; `recall` + `context` only when needed |
| Auto-dedup | `consolidate` merges similar memories |
| Namespaces | Isolate memories per project |
| Relations | Link memories: supersedes, contradicts, supports |
| Import/export | Migrate from MEMORY.md files, export as JSON/CSV/markdown |

## Key commands

```bash
memoclaw store "fact" --importance 0.8 --memory-type preference   # $0.005
memoclaw recall "query" --limit 5                                  # $0.005
memoclaw core --limit 5                                            # FREE
memoclaw search "keyword"                                          # FREE
memoclaw list --sort-by importance --limit 10                      # FREE
memoclaw context "what I need" --limit 10                          # $0.01
memoclaw consolidate --namespace default --dry-run                 # $0.01
memoclaw stats                                                     # FREE
```

## Cost

| Usage | Dai...