What problem does it solve?
Running the initial migrate-v2.sh script only handles deterministic migration steps, leaving critical manual tasks like triaging failed steps, seeding the owner user, cleaning up legacy v1 configuration files, reconciling container settings, and porting custom v1 code that are error-prone to complete manually.
Core Features & Use Cases
- Failed Step Triage: Identifies and resolves migration failures that block the v2 router from handling messages.
- Owner & Access Setup: Seeds the owner user role and configures sender access policies for the new v2 instance.
- Legacy Config Cleanup: Removes v1 boilerplate from CLAUDE.local.md files while preserving user customizations, and updates path references to match v2 structure.
- Custom Code Porting: Safely ports portable v1 customizations like skills and docs to the v2 codebase, with non-portable source code stashed for reference.
- Use Case: An instructor upgrading their NanoClaw classroom instance from v1 to v2 can use this skill to complete the full migration without manual configuration errors, ensuring all their custom agent personas and skills carry over correctly.
Quick Start
Use the migrate-from-v1 skill to finalize your NanoClaw v1 to v2 migration after running the initial migrate-v2.sh script in your terminal.