지금까지 OpenClaw를 굴려왔다면, Hermes Agent가 그 후속이다. 프로젝트 혈통은 한 줄로 이어지고, 메인테이너도 같은 사람들이고, 거기에 개명과 재설계가 얹혔다. Hermes 인스톨러는 그걸 알고 있다 — v0.14.0에는 일급 시민 명령으로 hermes claw migrate가 들어 있다. 기존 OpenClaw 상태를 한 번에 끌고 오고, dry-run과 명시적 프리셋도 지원한다.
이 글은 실전 마이그레이션 가이드다: 무엇이 옮겨지는지, 어떤 플래그가 있는지, 그리고 사고를 피하는 "일단 dry-run" 흐름.
1. Hermes Agent 설치
Hermes 셋업 마법사는 ~/.openclaw를 자동 감지하고, 설정 시작 전에 마이그레이션할지 물어본다. 가장 빠른 경로:
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
source ~/.bashrc
hermes setup
마법사가 OpenClaw 홈 디렉터리를 찾으면 마이그레이션할지 묻는다. 그대로 yes 해도 된다 — 다만 정확히 무엇이 옮겨질지 먼저 보고 싶으면, 마법사를 빠져나와서 migrate 명령을 직접 돌리는 게 맞다.
2. --dry-run으로 미리보기
이걸 항상 먼저 돌린다. 마이그레이터가 가져올 모든 것을 디스크에 쓰지 않고 나열한다:
hermes claw migrate --dry-run
출력은 카테고리별로 묶인다 — SOUL.md, memory, skill, 허용 목록, 메시징 설정, API key, TTS 자산. 한 번 훑어본다. 뭔가 어긋난 게 있으면(옮기고 싶지 않은 옛 API key, 이미 졸업한 퍼소나 파일 등), 프리셋으로 해당 섹션을 건너뛴다.
3. 프리셋 고르기
기본 두 개의 프리셋이 제공된다:
- •
full(기본) — 시크릿 포함 전부 마이그레이션 - •
user-data— API key를 제외하고 전부 마이그레이션; 시크릿은 직접 다시 입력
새 머신으로 옮기는 김에 시크릿은 끊고 시작하고 싶다? user-data를 쓴다:
hermes claw migrate --preset user-data
같은 머신을 올리면서 연속성을 유지하고 싶다?
hermes claw migrate
4. 옮겨지는 것
README 대조표에 따라:
| OpenClaw | Hermes 쪽 목적지 |
|---|---|
SOUL.md (퍼소나) | 그대로 가져옴 |
MEMORY.md와 USER.md 엔트리 | Hermes memory로 |
| 사용자 생성 skill | ~/.hermes/skills/openclaw-imports/로 복사 |
| 명령어 허용 목록 (승인 패턴) | 가져옴 |
| 메시징 설정 (플랫폼 설정, 허용 사용자, 작업 디렉터리) | 가져옴 |
| API key (Telegram, OpenRouter, OpenAI, Anthropic, ElevenLabs) | 프리셋 full일 때 가져옴 |
| TTS 자산 (워크스페이스 오디오 파일) | 가져옴 |
워크스페이스 AGENTS.md | --workspace-target과 함께 가져옴 |
agentskills.io에서 온 skill은 자동 재설치되지 않는다 — Hermes는 네가 허브를 다시 둘러보면서 hermes skills로 원하는 걸 새로 고를 거라고 가정한다. 의도된 동작이다: OpenClaw → Hermes 개명이 skills 허브 자체도 정비했고(v0.14.0에서 huggingface/skills가 신뢰 기본 tap이 됐다), 통째 끌고 오는 것보단 새로 고르는 게 더 깔끔하다.
5. 충돌 처리
이 머신에 Hermes 설정이 이미 있다면(예: OpenClaw가 있다는 걸 잊고 먼저 hermes setup을 돌린 경우), migrate 명령은 기본적으로 덮어쓰기를 거부한다. 두 가지 선택지:
- •
--overwrite— Hermes 설정을 OpenClaw 값으로 덮어쓴다 - •충돌 카테고리를 건너뛴다 — 충돌이 시크릿 쪽이면
--preset user-data를 쓴다
--overwrite는 --dry-run으로 OpenClaw 값이 정말 원하는 그것임을 확인한 뒤에만 쓴다.
6. 확인
hermes doctor
설치 후 헬스 체크를 돌린다. memory, skill, 허용 목록, 플랫폼 설정이 있어야 할 자리에 없으면, 구체적인 에러를 띄운다. 고치고, 다시 돌리고, 넘어간다.
대안: 에이전트가 안내하는 마이그레이션
CLI 플래그를 만지고 싶지 않다면, Hermes에 openclaw-migration skill이 들어 있다:
hermes
> /openclaw-migration
이 skill은 같은 마이그레이션을 대화형으로 안내한다 — 각 단계마다 --dry-run 미리보기를 보여준다.
자주 묻는 것
OpenClaw 데이터가 사라지지 않나? 아니다. 마이그레이터는 복사한다 — 옮기지 않는다. ~/.openclaw 디렉터리는 손대지 않는다. 뭔가 잘못되면 ~/.hermes를 지우고 OpenClaw로 돌아가면 된다.
둘 다 같이 돌려도 되나? 잠깐은 된다. HOME에 대한 가정을 공유해서, 같은 memory를 동시에 둘이 소유하는 건 가정되어 있지 않다. 길게 이중 운영하려면 커뮤니티 HermesClaw 브리지가 같은 WeChat 계정에서 OpenClaw와 Hermes 공존을 처리해준다.
내 skill이 깨지지 않을까? 사용자 생성 skill은 ~/.hermes/skills/openclaw-imports/로 복사되니까, 이사를 잘 견딘다. agentskills.io에서 받은 skill은 허브 쪽에 묶여 있고 로컬 설치에 묶여 있지 않다 — hermes skills로 다시 설치한다.
뭔가 잘못되면 어디서 도움을 받을 수 있나? 먼저 hermes doctor. 그다음은 Nous Research Discord 또는 GitHub Issues — 둘 다 README에서 링크된다.