OpenClaw에서 마이그레이션하기

새집으로 이사하는 건 스트레스가 가득하죠. 그런데 만약 이삿짐센터에서 짐을 싸고, 라벨을 붙이고, 심지어 가구를 계단까지 날라다 준다면 어떨까요? Hermes Agent의 마이그레이션 도구가 바로 그런 역할을 합니다. OpenClaw(또는 그 이전 버전인 Clawdbot, Moldbot)에서 전환할 때 말이죠. 수동 복사도, 기억 상실도, 눈물도 필요 없습니다.

마이그레이션 도구는 어떤 기능을 하나요?

hermes claw migrate를 개인 이삿짐 팀이라고 생각하면 됩니다. 기존 OpenClaw 설정(보통 ~/.openclaw/에 있음)에서 모든 것을 읽어 새 Hermes 홈(~/.hermes/)에 깔끔하게 배치합니다. 다음 항목들을 처리합니다:

• 성격 및 지침 – SOUL.md 파일(에이전트의 “캐릭터”)이 그대로 복사됩니다.
• 작업 공간 규칙 – AGENTS.md 파일(프로젝트에서 에이전트가 어떻게 행동해야 하는지)이 선택한 위치로 이동합니다.
• 장기 기억 – MEMORY.md 파일이 개별 항목으로 파싱되어 기존 기억과 병합되고, 중복은 제거되어 반복되지 않습니다.

간단한 시작 방법

터미널을 열고 다음 명령어 하나만 실행하면 됩니다:

hermes claw migrate

도구가 이동할 모든 항목의 미리보기를 보여줍니다. 목록을 확인하고 “yes”를 입력해 확인하면 끝입니다. 정말 쉽죠.

적용 전에 미리 보고 싶다면?

변경 사항이 걱정된다면 먼저 시험 실행을 해보세요:

hermes claw migrate --dry-run

이 명령은 아무것도 건드리지 않고 전체 계획을 보여줍니다. 계약서에 서명하기 전에 새 아파트를 둘러보는 것과 같다고 생각하면 됩니다.

API 키 이동 (선택 사항이지만 중요)

기본적으로 마이그레이션은 API 키(OpenAI 또는 Anthropic 자격 증명 등)를 복사하지 않습니다. 그것들도 이동하려면 명시적으로 지정해야 합니다:

hermes claw migrate --preset full --migrate-secrets --yes

--migrate-secrets 플래그는 안전 스위치 역할을 합니다. 키가 사용자 모르게 조용히 이동되지 않도록 보장합니다.

문제가 생기면 어떻게 하나요?

Hermes가 보호해 드립니다. 변경 사항을 적용하기 전에 현재 ~/.hermes/ 폴더의 백업 zip을 생성합니다. 뭔가 이상하다면 다음 명령으로 복원할 수 있습니다:

hermes import

이 백업은 ~/.hermes/backups/pre-migration-*.zip에 저장됩니다. 아파트의 “이전” 사진을 갖고 있는 것과 같아서, 언제든지 모든 것을 되돌릴 수 있습니다.

몇 가지 추가 팁

• 레거시 사용자: ~/.clawdbot/ 또는 ~/.moltbot/에서 오는 경우 걱정하지 마세요. Hermes가 해당 폴더를 자동으로 감지합니다.
• 충돌 발생 시? Hermes가 이미 존재하는 파일을 발견하면 기본적으로 덮어쓰기를 거부합니다. --overwrite로 강제하거나 --skill-conflict rename으로 충돌 파일 이름을 변경하도록 선택할 수 있습니다.
• 멀티 프로바이더 설정: 이전에 여러 AI 프로바이더를 사용했다면 hermes setup --portal을 통해 300개 이상의 모델에 접근할 수 있는 단일 OAuth 로그인으로 모두 통합할 수 있습니다.

결론

마이그레이션이 골치 아플 필요는 없습니다. hermes claw migrate를 사용하면 미리보기, 안전 백업, 에이전트의 성격·기억·규칙의 깔끔한 전송을 모두 하나의 명령어로 얻을 수 있습니다.

실용적인 팁: 먼저 hermes claw migrate --dry-run을 실행해 목록을 꼼꼼히 검토한 다음, 실제 마이그레이션을 실행하세요. 백업 zip은 최소 일주일 동안 안전한 곳에 보관하세요. 미래의 당신이 감사할 것입니다.

---