Claude Skill MartBrowse skillsWhat is a Skill?
 
← Back to list

Finish NanoClaw v1 → v2 Migration

Picks up after `migrate-v2.sh` to seed the owner, move legacy memory, reconcile container configs, and port v1 fork customizations.

Dev & CodingAdvanced★ 30,471⑂ 12,865AI score 7/10Last updated: Aug 9, 2026

What it does

Handles the judgment-heavy half of a NanoClaw v1→v2 upgrade that the deterministic script cannot automate.

  • Reads logs/setup-migration/handoff.json, triages failed steps, and runs a live smoke test so v2 answers real messages before deeper work
  • Seeds the owner role in users / user_roles, with per-channel ID formats (telegram:, discord:, whatsapp:, slack:)
  • Walks you through unknown_sender_policy (public / strict / request_approval) and imports known senders from the v1 message DB
  • Runs /migrate-memory for legacy CLAUDE.local.md content and validates container.json mount paths
  • Classifies fork commits: copies portable skills/docs, stashes non-portable source under docs/v1-fork-reference/

Who it's for

  • Self-hosters running NanoClaw v1 who want to move to v2
  • Bot operators with multiple messaging channels wired up
  • Developers who forked v1 with custom skills or container settings

Examples

  1. After bash migrate-v2.sh finishes, say "finish migration" — the skill reads handoff.json and fixes routing blockers first.
  2. "Make my Telegram account the owner" — it queries the DB, confirms the right user, and calls grantRole idempotently.
  3. "What about my v1 fork commits?" — it diffs against upstream and splits portable vs. non-portable changes with recommendations.

· · · Install guide · · ·

Install in the Claude app (no terminal)
  1. Download the ZIP with the button below.
  2. In Claude, open Settings → Capabilities and turn on 'Code execution and file creation'. (one time)
  3. 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-v1 folder from the GitHub repo nanocoai/nanoclaw into my ~/.claude/skills/migrate-from-v1/.
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-from-v1 ~/.claude/skills/

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

  1. Open a terminal.
  2. Clone the repo: git clone https://github.com/nanocoai/nanoclaw.git
  3. Create the skills folder: mkdir -p ~/.claude/skills
  4. Copy the skill: cp -r nanoclaw/.claude/skills/migrate-from-v1 ~/.claude/skills/
  5. Important: run bash migrate-v2.sh yourself in a real terminal from your v1 install — it needs interactive prompts and a Docker build that cannot run inside Claude.
  6. Open Claude Code in the project folder and type "finish migration" or "migrate from v1" to trigger the skill.
View source on GitHub ↗License: MIT