Skip to main content
OpenClaw stores memories as local markdown files (memory/YYYY-MM-DD.md, MEMORY.md). MemoClaw can import these directly — each ## section becomes a separate, searchable memory with auto-detected importance, tags, and type.
The CLI reads all .md files in the directory, splits them by ## headers, and sends them to the /v1/migrate endpoint.
Migration is idempotent — running it twice won’t create duplicates. Each memory chunk is content-hashed and checked against existing memories.

What gets imported

Each ## section in a markdown file becomes one memory: Files without ## headers are stored as a single memory.

API migration

If you prefer direct API access, use POST /v1/migrate:

Response

If any files fail, partial results are returned with an errors array:

Limits

  • Max 50 files per request
  • Each section truncated to 8,000 characters
  • Sections shorter than 10 characters are skipped
  • Requires x402 payment or free tier credits
After migrating your files, install the MemoClaw hooks so your agent automatically stores and recalls memories going forward — no manual commands needed.
Set your wallet key in your environment (same wallet you used for migration):
Restart the gateway:
Verify everything is wired up:
The hooks automatically handle:
With hooks installed, you can remove memory-related instructions from your AGENTS.md and SOUL.md — MemoClaw handles it automatically.

After migration

Your memories are now searchable by meaning:

Quickstart

New to MemoClaw? Start here.

API Reference: Migrate

Full endpoint documentation.