메인 콘텐츠로 건너뛰기
OpenClaw는 번들된 마이그레이션 제공자를 통해 Hermes 상태를 가져옵니다. 제공자는 상태를 변경하기 전에 모든 내용을 미리 보여 주고, 계획과 보고서에서 비밀 정보를 마스킹하며, 적용 전에 검증된 백업을 만듭니다.
가져오기에는 새 OpenClaw 설정이 필요합니다. 이미 로컬 OpenClaw 상태가 있다면 먼저 구성, 자격 증명, 세션, 작업 영역을 초기화하거나, 계획을 검토한 뒤 --overwrite와 함께 openclaw migrate를 직접 사용하세요.

​
가져오기 방법 두 가지

가장 빠른 경로입니다. 마법사는 ~/.hermes에서 Hermes를 감지하고 적용 전에 미리보기를 표시합니다.
openclaw onboard --flow import
또는 특정 소스를 지정합니다.
openclaw onboard --import-from hermes --import-source ~/.hermes

​
가져오는 항목

  • Hermes config.yaml의 기본 모델 선택.
  • providers 및 custom_providers의 구성된 모델 제공자와 사용자 지정 OpenAI 호환 엔드포인트.
mcp_servers 또는 mcp.servers의 MCP 서버 정의.
  • SOUL.md와 AGENTS.md는 OpenClaw 에이전트 작업 영역으로 복사됩니다.
  • memories/MEMORY.md와 memories/USER.md는 덮어쓰지 않고 일치하는 OpenClaw 메모리 파일에 추가됩니다.
OpenClaw 파일 메모리의 메모리 구성 기본값입니다. Honcho 같은 외부 메모리 제공자는 의도적으로 옮길 수 있도록 아카이브 또는 수동 검토 항목으로 기록됩니다.
skills/<name>/ 아래에 SKILL.md 파일이 있는 Skills는 skills.config의 Skills별 구성 값과 함께 복사됩니다.
대화형 openclaw migrate는 인증 자격 증명을 가져오기 전에 묻고, 기본적으로 예가 선택됩니다. 허용되는 가져오기에는 OpenCode auth.json의 OpenCode OpenAI OAuth 자격 증명, OpenCode auth.json의 OpenCode 및 GitHub Copilot 항목, 지원되는 .env 키가 포함됩니다. Hermes auth.json OAuth 항목은 레거시 상태이며, 라이브 인증으로 가져오지 않고 수동 재인증/doctor 작업으로 표시됩니다. 비대화형 openclaw migrate 자격 증명 가져오기에는 --include-secrets를 사용하고, 건너뛰려면 --no-auth-credentials를 사용하며, 온보딩 마법사에서 가져올 때는 온보딩 --import-secrets를 사용하세요.

​
아카이브 전용으로 유지되는 항목

제공자는 수동 검토를 위해 다음 항목을 마이그레이션 보고서 디렉터리에 복사하지만, 라이브 OpenClaw 구성이나 자격 증명으로 로드하지는 않습니다.
  • plugins/
  • sessions/
  • logs/
  • cron/
  • mcp-tokens/
  • state.db
OpenClaw는 형식과 신뢰 가정이 시스템 간에 달라질 수 있으므로 이 상태를 자동으로 실행하거나 신뢰하지 않습니다. 아카이브를 검토한 뒤 필요한 항목을 수동으로 옮기세요.

​
권장 흐름

1

계획 미리보기

openclaw migrate hermes --dry-run
계획에는 충돌, 건너뛴 항목, 민감한 항목을 포함해 변경될 모든 항목이 나열됩니다. 계획 출력은 중첩된 비밀 정보처럼 보이는 키를 마스킹합니다.
2

백업과 함께 적용

openclaw migrate apply hermes --yes
OpenClaw는 적용 전에 백업을 만들고 검증합니다. 이 비대화형 예시는 비밀 정보가 아닌 상태를 가져옵니다. 자격 증명 프롬프트에 답하려면 --yes 없이 실행하거나, 무인 실행에서 지원되는 자격 증명을 포함하려면 --include-secrets를 추가하세요.
3

doctor 실행

openclaw doctor
Doctor는 보류 중인 구성 마이그레이션을 다시 적용하고 가져오기 중에 발생한 문제를 확인합니다.
4

다시 시작하고 확인

openclaw gateway restart
openclaw status
Gateway가 정상이고 가져온 모델, 메모리, Skills가 로드되었는지 확인하세요.

​
충돌 처리

계획이 충돌을 보고하면 적용은 계속 진행하지 않습니다. 충돌은 대상에 파일 또는 구성 값이 이미 존재한다는 뜻입니다.
기존 대상을 교체하려는 의도가 명확할 때만 --overwrite로 다시 실행하세요. 제공자는 덮어쓴 파일에 대해 마이그레이션 보고서 디렉터리에 항목 수준 백업을 계속 작성할 수 있습니다.
새 OpenClaw 설치에서는 충돌이 드뭅니다. 일반적으로 이미 사용자 편집이 있는 설정에서 가져오기를 다시 실행할 때 나타납니다. 적용 도중 충돌이 발생하면, 예를 들어 구성 파일에서 예상치 못한 경합이 발생하면 Hermes는 남은 종속 구성 항목을 부분적으로 작성하는 대신 blocked by earlier apply conflict 이유와 함께 skipped로 표시합니다. 마이그레이션 보고서는 각 차단된 항목을 기록하므로 원래 충돌을 해결하고 가져오기를 다시 실행할 수 있습니다.

​
비밀 정보

대화형 openclaw migrate는 감지된 인증 자격 증명을 가져올지 묻고, 기본적으로 예가 선택됩니다.
  • 프롬프트를 수락하면 OpenCode auth.json의 OpenCode OpenAI OAuth 자격 증명, OpenCode auth.json의 OpenCode 및 GitHub Copilot 항목, 지원되는 .env 키를 가져옵니다. Hermes auth.json OAuth 항목은 수동 OpenAI 재인증 또는 doctor 복구 대상으로 보고됩니다.
  • 비밀 정보가 아닌 상태만 가져오려면 --no-auth-credentials를 사용하거나 프롬프트에서 아니요를 선택하세요.
  • --yes로 무인 실행할 때는 --include-secrets를 사용하세요.
  • 온보딩 마법사에서 자격 증명을 가져올 때는 온보딩 --import-secrets를 사용하세요.
  • SecretRef로 관리되는 자격 증명의 경우 가져오기가 완료된 뒤 SecretRef 소스를 구성하세요.

​
자동화를 위한 JSON 출력

openclaw migrate hermes --dry-run --json
openclaw migrate apply hermes --json --yes
--json을 사용하고 --yes를 사용하지 않으면 적용은 계획을 출력하고 상태를 변경하지 않습니다. 이는 CI와 공유 스크립트에 가장 안전한 모드입니다.

​
문제 해결

계획 출력을 확인하세요. 각 충돌은 소스 경로와 기존 대상을 식별합니다. 항목별로 건너뛸지, 대상을 편집할지, --overwrite로 다시 실행할지 결정하세요.
--from /actual/path(CLI) 또는 --import-source /actual/path(온보딩)를 전달하세요.
온보딩 가져오기는 새 설정이 필요합니다. 상태를 초기화하고 다시 온보딩하거나, --overwrite와 명시적 백업 제어를 지원하는 openclaw migrate apply hermes를 직접 사용하세요.
대화형 openclaw migrate는 자격 증명 프롬프트를 수락한 경우에만 API 키를 가져옵니다. 비대화형 --yes 실행에는 --include-secrets가 필요하고, 온보딩 가져오기에는 --import-secrets가 필요합니다. 지원되는 .env 키만 인식되며, .env의 다른 변수는 무시됩니다.

​
관련 항목