Migrate from OpenClaw to NanoClaw v2

Detects an existing OpenClaw install and walks you conversationally through moving identity, channel tokens, scheduled tasks and MCP config into NanoClaw v2's entity model.

UtilitiesAdvanced★ 30,471⑂ 12,865AI score 8/10Last updated: Aug 9, 2026

What it does

Discovers OpenClaw/Clawdbot state directories and summarizes workspace files, channels, cron jobs, MCP servers, skills and agent count.
Remaps the old "one agent, one shared workspace" model onto v2's agent group (container) + messaging group + wiring row structure.
Routes credentials in two directions: channel bot tokens to .env, container-facing API keys (Anthropic, OpenAI) to the OneCLI vault — always displayed masked (first 4 + ... + last 4).
Splits IDENTITY/SOUL/USER/MEMORY content into standing instructions (instructions.prepend.md) versus durable memory concepts, showing proposed edits before writing.
Converts cron jobs to v2 recurrence tasks and ships a vitest test that guards the credential-routing and cron-mapping assumptions.
Tracks everything in migration-state.md so the migration is resumable if context is lost.

Who it's for

Operators running Telegram/Discord/Slack bots on OpenClaw who are upgrading to NanoClaw v2.
Anyone who wants to preserve a bot's personality and accumulated memory across the move.
Teams that need a review-before-apply migration rather than a blind copy.

Examples

Say "migrate from openclaw" — the skill runs discovery, summarizes the install, explains the architectural differences, and asks whether to proceed.
With three legacy group chats, pick shared identity vs. fully separate agents, then register each with setup/index.ts --step register using the right folder and session mode.
Review masked Slack bot/app tokens, approve writing them to .env, and have the Anthropic key registered into the vault via onecli secrets create.

· · · 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-from-openclaw/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.

↓ Download 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-from-openclaw folder from the GitHub repo nanocoai/nanoclaw into my ~/.claude/skills/migrate-from-openclaw/.
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 && mkdir -p ~/.claude/skills && cp -r nanoclaw/.claude/skills/migrate-from-openclaw ~/.claude/skills/

⚠ This is a third-party skill. Check the source repository before installing.

Make sure you already have a NanoClaw v2 project checked out and that pnpm and tsx work.
Clone the repo: git clone https://github.com/nanocoai/nanoclaw.git
Copy the skill: mkdir -p ~/.claude/skills && cp -r nanoclaw/.claude/skills/migrate-from-openclaw ~/.claude/skills/
Launch Claude Code from inside your NanoClaw project directory (or place the skill in the project's .claude/skills/ instead).
Start the NanoClaw service before migrating — init-first-agent talks to its CLI socket — and install OneCLI if you want vault-based credentials.
Ask Claude: "migrate from openclaw" to kick off Phase 0 discovery.
Back up ~/.openclaw and your .env file first, just in case.

View source on GitHub ↗License: MIT