NanoClaw v1 → v2 마이그레이션 마무리
`migrate-v2.sh` 실행 후 남은 소유자 지정·메모리 이전·컨테이너 설정·포크 코드 이식을 Claude가 단계별로 마무리해 줍니다.
개발·코딩고급★ 30,471⑂ 12,865AI 점수 7/10마지막 업데이트: 2026. 8. 9.
무엇을 해주나
NanoClaw v1 설치본을 v2로 옮길 때, 스크립트가 자동으로 처리하지 못하는 "사람 판단이 필요한" 부분을 담당합니다.
logs/setup-migration/handoff.json을 읽어 실패한 단계를 분류하고 우선 라우팅을 살리는 스모크 테스트 진행users/user_roles테이블에서 소유자(owner) 권한 시드, 채널별 사용자 ID 포맷(telegram:,discord:,whatsapp:등) 안내unknown_sender_policy(public / strict / request_approval) 선택과 v1 메시지 DB에서 기존 발신자 임포트/migrate-memory로 레거시 CLAUDE.local.md 메모리 이전,container.json마운트 경로 검증- v1 포크 커밋 분류: 이식 가능한 스킬·문서만 복사하고 소스코드는 참고용으로 보관
이런 분께 추천
- 이미 NanoClaw v1을 운영 중이고 v2로 넘어가려는 셀프호스팅 사용자
- 여러 메신저 채널(텔레그램·디스코드·왓츠앱·슬랙)을 연결해 둔 봇 관리자
- v1을 포크해 커스텀 스킬이나 컨테이너 설정을 붙여 쓰던 개발자
활용 예시
bash migrate-v2.sh완료 후 Claude에게 "finish migration"이라고 말하면 handoff.json을 읽고 실패 단계부터 정리해 줍니다.- "내 텔레그램 계정을 owner로 지정해줘" → DB를 조회해 후보를 보여주고 중복 없이
grantRole을 실행합니다. - "v1 포크 커밋들 어떻게 처리할까?" → upstream 대비 커밋 목록을 보여주고 이식 가능/불가능 항목을 분리해 제안합니다.
· · · 설치 가이드 · · ·
Claude 앱에 설치 (터미널 필요 없음)
- 아래 버튼으로 ZIP 파일을 받으세요.
- Claude 설정 → Capabilities에서 '코드 실행 및 파일 생성'을 켭니다. (한 번만)
- Claude에서 Customize → Skills → + → '스킬 업로드'를 누르고 받은 ZIP을 올립니다.
Claude Code에 설치
Claude에게 맡기기 — 아래 문장을 Claude Code에 붙여넣으세요
클로드스킬마트에서 찾은 스킬을 설치해줘. GitHub 저장소 nanocoai/nanoclaw 의 .claude/skills/migrate-from-v1 폴더를 내 ~/.claude/skills/migrate-from-v1/ 에 그대로 복사해줘. 설치가 끝나면 이 스킬로 무엇을 할 수 있는지 한 줄로 알려줘.
직접 명령으로 설치하기
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/⚠ 제3자가 만든 스킬입니다. 설치 전 원본 저장소를 한 번 확인하세요.
- 터미널을 엽니다.
- 저장소를 내려받습니다:
git clone https://github.com/nanocoai/nanoclaw.git - 스킬 폴더를 만듭니다:
mkdir -p ~/.claude/skills - 스킬을 복사합니다:
cp -r nanoclaw/.claude/skills/migrate-from-v1 ~/.claude/skills/ - 중요: 먼저 v1 설치 디렉터리에서
bash migrate-v2.sh를 터미널로 직접 실행해 완료합니다(대화형 프롬프트와 Docker 빌드가 필요해 Claude 안에서는 실행 불가). - 프로젝트 폴더에서 Claude Code를 실행하고 "finish migration" 또는 "migrate from v1"이라고 입력하면 스킬이 시작됩니다.
GitHub에서 원본 보기 ↗라이선스: MIT