Legacy Memory Migration (NanoClaw)
A careful runbook for moving legacy NanoClaw and Claude-native memory into the shared memory/ tree with quarantine, reporting, and rollback.
UtilitiesAdvanced★ 30,471⑂ 12,865AI score 8/10Last updated: Aug 9, 2026
What it does
Migrates pre-shared-memory files into the unified groups/<folder>/memory/ tree.
- Inventories each group for
.seed.md,CLAUDE.md,CLAUDE.local.md, Claude auto-memory dirs, and unindexedimported-agent-memory.md - Opens a safe maintenance window by pausing scheduled task series and stopping the group container
- Runs a content-blind staging phase using atomic, collision-safe renames; symlinks are quarantined, never followed
- Then the invoking harness reads staged files as untrusted data, splitting standing instructions into
instructions.prepend.mdand durable facts into indexed concept files with OKF frontmatter - Ends with a source-to-destination report, a verification checklist, and an exact reverse rollback
Who it's for
- NanoClaw operators hit by the shared-memory breaking change ("the agent forgot everything")
- Teams switching providers who need memory to carry over
- Anyone who wants migration without accidental overwrites
Examples
- Say "migrate memory" → get the affected-group list plus collision/symlink status, approve, then migrate group by group
- After an update flags the shared-memory change → pause pending task series, migrate, resume only the series you paused
- A legacy
CLAUDE.mdturns out to be a symlink → only the link is moved to quarantine, target untouched, and you're offered three plain-language options
· · · Install guide · · ·
Try it now, no install
Paste this into Claude to use the skill without installing anything.
Read the instructions in this file and follow them to help me: https://raw.githubusercontent.com/nanocoai/nanoclaw/HEAD/.claude/skills/migrate-memory/SKILL.md What I want: (describe your task here)
If Claude can't open the link, open it yourself and paste the contents instead.
↓ If it works for you, download the ZIP below and install it. Then it runs on its own — no pasting each time.
Install in the Claude app (no terminal)
- Download the ZIP with the button below.
- In Claude, open Settings → Capabilities and turn on 'Code execution and file creation'. (one time)
- Go to Customize → Skills → + → 'Upload a skill' and upload the ZIP.
Install in Claude Code
Let Claude do it — paste this into Claude Code
Install the skill I found on Claude Skill Mart. Copy the .claude/skills/migrate-memory folder from the GitHub repo nanocoai/nanoclaw into my ~/.claude/skills/migrate-memory/. When it's done, tell me in one line what this skill can do.
Install with a command instead
git clone https://github.com/nanocoai/nanoclaw.git /tmp/nanoclaw && mkdir -p ~/.claude/skills && cp -r /tmp/nanoclaw/.claude/skills/migrate-memory ~/.claude/skills/⚠ This is a third-party skill. Check the source repository before installing.
- Open a terminal.
- Clone the repo:
git clone https://github.com/nanocoai/nanoclaw.git /tmp/nanoclaw - Create the skills folder:
mkdir -p ~/.claude/skills - Copy the skill:
cp -r /tmp/nanoclaw/.claude/skills/migrate-memory ~/.claude/skills/ - If you already work inside the NanoClaw repo, you can use
.claude/skills/migrate-memoryas-is. - Restart Claude Code and type "migrate memory" to confirm the skill loads.
- Before running it, verify the
nclCLI works and back up your group data.
View source on GitHub ↗License: MIT