OpenClaw → NanoClaw v2 마이그레이션
기존 OpenClaw 설치를 탐지해 정체성·채널 토큰·예약 작업·MCP 설정을 NanoClaw v2 구조로 대화형으로 옮겨주는 스킬입니다.
유틸리티고급★ 30,471⑂ 12,865AI 점수 8/10마지막 업데이트: 2026. 8. 9.
무엇을 해주나
~/.openclaw,~/.clawdbot등 표준 경로에서 기존 설치를 자동 탐지하고, 워크스페이스 파일·채널·크론·MCP 서버·에이전트 수를 요약합니다.- OpenClaw의 "에이전트 = 공유 워크스페이스" 모델을 v2의 에이전트 그룹(컨테이너) + 메시징 그룹 + 배선 모델로 재배치합니다.
- 자격증명을 두 갈래로 라우팅합니다: 채널 봇 토큰은
.env, 컨테이너가 쓰는 API 키(Anthropic/OpenAI 등)는 OneCLI 볼트. 화면에는 앞 4자 +...+ 뒤 4자만 마스킹해 보여줍니다. - IDENTITY/SOUL/USER/MEMORY 문서를 "상시 지시문(
instructions.prepend.md)"과 "기억 개념(memory/)"으로 나눠 제안 후 적용합니다. - 크론 작업을 v2의
schedule_task기반 recurrence로 변환하고, 마지막에 vitest 테스트로 매핑 가정을 검증합니다. - 진행 상황을
migration-state.md에 기록해 대화 컨텍스트가 끊겨도 이어서 진행할 수 있습니다.
이런 분께 추천
- OpenClaw(구 Clawdbot)로 텔레그램·디스코드·슬랙 봇을 운영하다 NanoClaw v2로 넘어가려는 운영자
- 봇 인격/메모리 자산을 잃지 않고 옮기고 싶은 분
- 자격증명을 함부로 복사하지 않고, 무엇이 어디로 가는지 확인하며 이전하고 싶은 분
활용 예시
- "openclaw에서 마이그레이션 해줘" → 탐지 스크립트 실행 후 설치 요약과 v2 구조 차이 설명, 단계별 진행 동의를 받습니다.
- 그룹이 3개였다면 "공유 정체성 / 완전 분리 / 우선 하나만" 중 선택하게 하고, 선택에 따라
setup/index.ts --step register로 각 그룹의 폴더·세션 모드를 등록합니다. - 슬랙 봇 토큰과 앱 토큰을 마스킹 상태로 보여준 뒤 승인 시
.env에 기록하고, Anthropic 키는onecli secrets create로 볼트에 등록합니다.
· · · 설치 가이드 · · ·
설치 없이 지금 한 번 써보기
아래를 Claude에 붙여넣으면 설치하지 않고도 이 스킬을 그대로 씁니다.
이 파일의 지시를 읽고 그대로 따라서 나를 도와줘: https://raw.githubusercontent.com/nanocoai/nanoclaw/HEAD/.claude/skills/migrate-from-openclaw/SKILL.md 내가 원하는 것: (여기에 하고 싶은 일을 쓰세요)
Claude가 링크를 열지 못하면, 링크를 직접 열어 내용을 복사해 붙여넣으세요.
↓ 쓸 만하면 아래에서 ZIP을 받아 설치하세요. 그러면 매번 붙여넣지 않아도 알아서 작동합니다.
Claude 앱에 설치 (터미널 필요 없음)
- 아래 버튼으로 ZIP 파일을 받으세요.
- Claude 설정 → Capabilities에서 '코드 실행 및 파일 생성'을 켭니다. (한 번만)
- Claude에서 Customize → Skills → + → '스킬 업로드'를 누르고 받은 ZIP을 올립니다.
Claude Code에 설치
Claude에게 맡기기 — 아래 문장을 Claude Code에 붙여넣으세요
클로드스킬마트에서 찾은 스킬을 설치해줘. GitHub 저장소 nanocoai/nanoclaw 의 .claude/skills/migrate-from-openclaw 폴더를 내 ~/.claude/skills/migrate-from-openclaw/ 에 그대로 복사해줘. 설치가 끝나면 이 스킬로 무엇을 할 수 있는지 한 줄로 알려줘.
직접 명령으로 설치하기
git clone https://github.com/nanocoai/nanoclaw.git && mkdir -p ~/.claude/skills && cp -r nanoclaw/.claude/skills/migrate-from-openclaw ~/.claude/skills/⚠ 제3자가 만든 스킬입니다. 설치 전 원본 저장소를 한 번 확인하세요.
- NanoClaw v2 프로젝트가 이미 로컬에 있고
pnpm,tsx가 동작하는지 확인합니다. - 터미널에서 저장소를 받습니다:
git clone https://github.com/nanocoai/nanoclaw.git - 스킬 폴더를 복사합니다:
mkdir -p ~/.claude/skills && cp -r nanoclaw/.claude/skills/migrate-from-openclaw ~/.claude/skills/ - (권장) NanoClaw 프로젝트 디렉터리 안에서 Claude Code를 실행합니다. 프로젝트 전용으로 쓰려면
.claude/skills/아래에 두어도 됩니다. - 마이그레이션 전 NanoClaw 서비스를 켭니다(
init-first-agent가 CLI 소켓을 사용합니다). OneCLI도 미리 설치해두면 좋습니다. - Claude Code에서 "OpenClaw에서 마이그레이션 해줘"라고 말하면 Phase 0 탐지부터 시작됩니다.
- 기존
~/.openclaw디렉터리와.env는 미리 백업해 두세요.
GitHub에서 원본 보기 ↗라이선스: MIT