클로드스킬마트스킬 둘러보기스킬이 뭐예요?
목록으로

OpenClaw → NanoClaw v2 마이그레이션

기존 OpenClaw 설치를 탐지해 정체성·채널 토큰·예약 작업·설정을 NanoClaw v2 구조로 대화형으로 옮겨주는 스킬.

유틸리티고급30,47112,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.mdmemory/ 개념 파일로 분리 이관
  • Phase 4 자격증명: 채널 토큰은 .env, 컨테이너용 API 키는 OneCLI Vault로 라우팅(표시 시 마스킹)
  • Phase 5~8: cron → v2 recurrence 매핑, MCP 서버 연결, 첫 실행 안내, 그리고 vitest 테스트로 검증 후 요약

또한 migration-state.md를 만들어 진행 상황을 기록하므로, 대화 컨텍스트가 끊겨도 어디까지 했는지 복구할 수 있습니다.

이런 분께 추천

  • OpenClaw/clawdbot으로 봇을 운영하다 NanoClaw v2로 이전하려는 운영자
  • 여러 채널(Telegram/Discord/Slack)과 예약 작업, 커스텀 스킬이 얽혀 있어 수동 이전이 부담스러운 분
  • 자격증명을 코드나 컨테이너 환경변수에 남기지 않고 안전하게 옮기고 싶은 분

활용 예시

  1. "openclaw에서 마이그레이션 해줘" → 탐지 스크립트가 ~/.openclaw를 스캔하고, 어시스턴트 이름·채널·그룹 목록을 요약해 보여준 뒤 단계별로 진행합니다.
  2. Telegram + Slack 봇 이전 → Slack의 봇/앱 토큰 두 개를 마스킹된 상태로 미리 보여주고 승인 시 .env에 기록, Anthropic 키는 .env 대신 OneCLI Vault에 등록합니다.
  3. 예약 작업 12건 이전cron/jobs.json을 읽어 각 job을 v2의 messages_in(kind='task') + cron recurrence로 매핑하고, 매핑 결과를 표로 보여준 뒤 에이전트의 schedule_task 툴로 생성합니다.

· · · 설치 가이드 · · ·

Claude 앱에 설치 (터미널 필요 없음)
  1. 아래 버튼으로 ZIP 파일을 받으세요.
  2. Claude 설정 → Capabilities에서 '코드 실행 및 파일 생성'을 켭니다. (한 번만)
  3. Claude에서 Customize → Skills → + → '스킬 업로드'를 누르고 받은 ZIP을 올립니다.
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자가 만든 스킬입니다. 설치 전 원본 저장소를 한 번 확인하세요.

  1. 터미널을 열고 스킬을 저장할 위치로 이동합니다.
  2. 저장소를 클론합니다: git clone https://github.com/nanocoai/nanoclaw.git
  3. 스킬 폴더를 Claude 스킬 디렉터리로 복사합니다: mkdir -p ~/.claude/skills && cp -r nanoclaw/.claude/skills/migrate-from-openclaw ~/.claude/skills/
  4. 이 스킬은 NanoClaw v2 프로젝트 내부에서 실행해야 합니다. NanoClaw v2 프로젝트 폴더로 이동한 뒤 pnpm install로 의존성을 설치하세요.
  5. NanoClaw 서비스를 실행해 둡니다(Phase 1의 init-first-agent가 CLI 소켓을 사용합니다).
  6. 중요: 마이그레이션 전 ~/.openclaw(또는 ~/.clawdbot) 디렉터리와 기존 .env를 백업하세요.
  7. Claude Code를 열고 "OpenClaw에서 마이그레이션 해줘"라고 요청하면 스킬이 트리거됩니다.
  8. 각 단계에서 제안된 변경 사항을 직접 확인하고 승인하세요. 특히 자격증명 저장 위치(.env vs OneCLI Vault)를 꼭 검토하세요.