NanoClaw v1 → v2 마이그레이션 마무리
`migrate-v2.sh` 실행 이후 남은 사람 판단 단계(오너 지정·메모리 이관·컨테이너 설정·포크 코드 정리)를 Claude가 순서대로 처리해 줍니다.
개발·코딩고급★ 30,471⑂ 12,865AI 점수 8/10마지막 업데이트: 2026. 8. 9.
무엇을 해주나
logs/setup-migration/handoff.json을 먼저 읽어 자동 마이그레이션 결과와 실패 단계를 분류합니다.- 스크립트가 실행되지 않았다면 즉시 중단하고 터미널에서
bash migrate-v2.sh를 먼저 돌리라고 안내합니다(중간 개입 금지). - Phase 0: 실제 채널로 메시지가 라우팅되는지 스모크 테스트 → Phase 1:
users/user_roles조회 후 owner 권한 부여,unknown_sender_policy(public/strict/request_approval) 결정 및 v1 메시지 이력에서 기존 발신자 임포트. - Phase 2~4:
/migrate-memory로 레거시 메모리 이관,container.json의 마운트 경로 검증, v1 포크 커밋 분류(포터블 항목만 복사,src/*는 참고용 보관). - 마무리로
pnpm exec tsx setup/index.ts --step verify실행과 설치별 서비스 라벨 기반 재시작까지 안내합니다.
이런 분께 추천
- NanoClaw v1을 운영 중이고 v2로 올려야 하는 사람
- v1을 포크해 스킬·문서·컨테이너 설정을 커스터마이징한 사람
- 텔레그램/디스코드/왓츠앱/슬랙 채널 봇의 권한 정책을 새로 정리하려는 운영자
활용 예시
- "v1 마이그레이션 마무리해줘" → handoff.json 확인, 실패 단계 중 라우팅 차단 요인만 우선 수정하고 테스트 메시지 응답 확인.
- "내 계정을 오너로 만들어줘" →
users조회 후telegram:6037840640같은 ID를 확인하고grantRole로 owner 부여(중복 방지 체크 포함). - "v1에서 고친 코드 어떻게 옮기지?" →
git log upstream/main..HEAD로 커밋 목록을 보여주고, 스킬·문서만 복사하고 소스는docs/v1-fork-reference/에 정리.
· · · 설치 가이드 · · ·
설치 없이 지금 한 번 써보기
아래를 Claude에 붙여넣으면 설치하지 않고도 이 스킬을 그대로 씁니다.
이 파일의 지시를 읽고 그대로 따라서 나를 도와줘: https://raw.githubusercontent.com/nanocoai/nanoclaw/HEAD/.claude/skills/migrate-from-v1/SKILL.md 내가 원하는 것: (여기에 하고 싶은 일을 쓰세요)
Claude가 링크를 열지 못하면, 링크를 직접 열어 내용을 복사해 붙여넣으세요.
↓ 쓸 만하면 아래에서 ZIP을 받아 설치하세요. 그러면 매번 붙여넣지 않아도 알아서 작동합니다.
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 && mkdir -p ~/.claude/skills && cp -r nanoclaw/.claude/skills/migrate-from-v1 ~/.claude/skills/⚠ 제3자가 만든 스킬입니다. 설치 전 원본 저장소를 한 번 확인하세요.
- 터미널을 엽니다.
- 저장소를 받습니다:
git clone https://github.com/nanocoai/nanoclaw.git - 이미 NanoClaw v2 저장소를 쓰고 있다면 이 스킬은
.claude/skills/migrate-from-v1에 이미 포함되어 있으니 추가 설치가 필요 없습니다. - 전역으로 쓰려면 스킬 폴더로 복사합니다:
mkdir -p ~/.claude/skills && cp -r nanoclaw/.claude/skills/migrate-from-v1 ~/.claude/skills/ - 중요: Claude를 켜기 전에 터미널에서
bash migrate-v2.sh를 먼저 실행합니다(대화형 프롬프트·Docker 빌드 필요). - 스크립트가 끝나면 프로젝트 폴더에서 Claude Code를 실행하고 "v1 마이그레이션 마무리"라고 요청합니다.
- DB와 서비스를 변경하므로 사전에
data/와.env백업을 권장합니다.
GitHub에서 원본 보기 ↗라이선스: MIT