OpenClaw → NanoClaw v2 마이그레이션
기존 OpenClaw 설치를 탐지해 정체성·채널 토큰·예약 작업·설정을 NanoClaw v2 구조로 대화형으로 옮겨주는 스킬.
유틸리티고급★ 30,471⑂ 12,865AI 점수 8/10마지막 업데이트: 2026. 8. 9.
무엇을 해주나
기존 OpenClaw(또는 clawdbot) 설치를 찾아내고, 그 안의 설정을 NanoClaw v2의 새로운 엔티티 모델로 옮기는 과정을 9단계(Phase 0~8)로 안내합니다.
- Phase 0 탐지:
~/.openclaw,~/.clawdbot등을 스캔해 채널, 워크스페이스 파일, 데일리 메모리, 스킬, cron, MCP 서버, 에이전트 수를 요약 - Phase 1 구조 매핑: OpenClaw의 "에이전트"를 v2의 에이전트 그룹(컨테이너), 채팅방을 메시징 그룹으로 매핑하고 공유/분리 여부를 결정
- Phase 2 설정: 타임존(
TZ), 컨테이너 타임아웃, allowFrom 기반 접근제어를 v2의 역할/멤버 모델로 변환 - Phase 3 정체성·메모리: IDENTITY/SOUL/USER/MEMORY 파일을
instructions.prepend.md와memory/개념 파일로 분리 이관 - Phase 4 자격증명: 채널 토큰은
.env, 컨테이너용 API 키는 OneCLI Vault로 라우팅(표시 시 마스킹) - Phase 5~8: cron → v2 recurrence 매핑, MCP 서버 연결, 첫 실행 안내, 그리고 vitest 테스트로 검증 후 요약
또한 migration-state.md를 만들어 진행 상황을 기록하므로, 대화 컨텍스트가 끊겨도 어디까지 했는지 복구할 수 있습니다.
이런 분께 추천
- OpenClaw/clawdbot으로 봇을 운영하다 NanoClaw v2로 이전하려는 운영자
- 여러 채널(Telegram/Discord/Slack)과 예약 작업, 커스텀 스킬이 얽혀 있어 수동 이전이 부담스러운 분
- 자격증명을 코드나 컨테이너 환경변수에 남기지 않고 안전하게 옮기고 싶은 분
활용 예시
- "openclaw에서 마이그레이션 해줘" → 탐지 스크립트가
~/.openclaw를 스캔하고, 어시스턴트 이름·채널·그룹 목록을 요약해 보여준 뒤 단계별로 진행합니다. - Telegram + Slack 봇 이전 → Slack의 봇/앱 토큰 두 개를 마스킹된 상태로 미리 보여주고 승인 시
.env에 기록, Anthropic 키는.env대신 OneCLI Vault에 등록합니다. - 예약 작업 12건 이전 →
cron/jobs.json을 읽어 각 job을 v2의messages_in(kind='task')+ cron recurrence로 매핑하고, 매핑 결과를 표로 보여준 뒤 에이전트의schedule_task툴로 생성합니다.
· · · 설치 가이드 · · ·
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 /tmp/nanoclaw && mkdir -p ~/.claude/skills && cp -r /tmp/nanoclaw/.claude/skills/migrate-from-openclaw ~/.claude/skills/⚠ 제3자가 만든 스킬입니다. 설치 전 원본 저장소를 한 번 확인하세요.
- 터미널을 열고 스킬을 저장할 위치로 이동합니다.
- 저장소를 클론합니다:
git clone https://github.com/nanocoai/nanoclaw.git - 스킬 폴더를 Claude 스킬 디렉터리로 복사합니다:
mkdir -p ~/.claude/skills && cp -r nanoclaw/.claude/skills/migrate-from-openclaw ~/.claude/skills/ - 이 스킬은 NanoClaw v2 프로젝트 내부에서 실행해야 합니다. NanoClaw v2 프로젝트 폴더로 이동한 뒤
pnpm install로 의존성을 설치하세요. - NanoClaw 서비스를 실행해 둡니다(Phase 1의
init-first-agent가 CLI 소켓을 사용합니다). - 중요: 마이그레이션 전
~/.openclaw(또는~/.clawdbot) 디렉터리와 기존.env를 백업하세요. - Claude Code를 열고 "OpenClaw에서 마이그레이션 해줘"라고 요청하면 스킬이 트리거됩니다.
- 각 단계에서 제안된 변경 사항을 직접 확인하고 승인하세요. 특히 자격증명 저장 위치(
.envvs OneCLI Vault)를 꼭 검토하세요.
GitHub에서 원본 보기 ↗라이선스: MIT