Migrating from Hermes

기준일: 2026-07-26
공식 기준: Migrating from Hermes

Migrating from Hermes 문서는 OpenClaw 공식 문서(install/migrating-hermes)를 한국어로 정리한 가이드입니다. Move from Hermes to OpenClaw with a previewed, reversible import 명령·설정 키·코드 예시는 공식 문서를 그대로 보존하며, 해석과 절차 안내는 한국어로 제공합니다. 최종 동작은 설치된 CLI 버전과 공식 원문을 확인하세요.

핵심 요약

Move from Hermes to OpenClaw with a previewed, reversible import

한국어 가이드 범위: install/migrating-hermes 경로의 설정·명령·제약·예시를 학습용으로 재구성합니다.

문서 구성

공식 문서의 주요 섹션은 다음과 같습니다.

• Two ways to import
• What gets imported
• What stays archive-only
• Recommended flow
• Conflict handling
• Secrets
• JSON output for automation
• 트러블슈팅
• 관련 문서

상세 내용

본문

The bundled Hermes migration provider follows HERMES_HOME and the active Hermes profile, falling back to ~/.hermes on macOS/Linux or %LOCALAPPDATA%\hermes on Windows. It previews every change before applying and redacts secrets in plans and reports. Standalone openclaw migrate writes a verified backup; the fresh onboarding path stages config, credentials, and files and publishes them only after imported inference verifies. An explicit --from path always wins.

위 내용은 공식 문서의 해당 섹션 요지입니다. 세부 플래그·기본값은 원문과 --help를 확인하세요.

Two ways to import

Detects the active Hermes home/profile and shows a preview before applying.

위 내용은 공식 문서의 해당 섹션 요지입니다. 세부 플래그·기본값은 원문과 --help를 확인하세요.

openclaw onboard --flow import

openclaw onboard --import-from hermes --import-source ~/.hermes

openclaw migrate hermes --dry-run    # preview only
    openclaw migrate apply hermes --yes  # apply with confirmation skipped

What gets imported

MCP server definitions from mcp_servers or mcp.servers, including disabled state, timeouts, parallel-tool support, OAuth scope, compatible TLS fields, and native/resource/prompt tool policy. Literal environment variables and headers require credential-import consent. Hermes-only lifecycle, sampling, elicitation, preflight, keepalive, CA-bundle, password-protected client-key, and pre-registered OAuth-client settings become manual-review items instead of invalid OpenClaw config.

위 내용은 공식 문서의 해당 섹션 요지입니다. 세부 플래그·기본값은 원문과 --help를 확인하세요.

주요 항목:

• Default model selection from Hermes config.yaml.
• Configured model providers and custom endpoints from model, providers, and custom_providers, including current Hermes Chat Completions, Codex Responses, and Anthropic Messages transports.
• SOUL.md and AGENTS.md are copied into the OpenClaw agent workspace.
• memories/MEMORY.md and memories/USER.md are appended to the matching OpenClaw memory files instead of overwriting them.
• Memory-only surfaces behave differently: the onboarding memory page and the Control UI Memory import page copy these two files under memory/imports/hermes/ for indexed recall and leave existing workspace memory untouched.

What stays archive-only

The provider copies these into the migration report directory for manual review, but does not load them into live OpenClaw config or credentials:

위 내용은 공식 문서의 해당 섹션 요지입니다. 세부 플래그·기본값은 원문과 --help를 확인하세요.

주요 항목:

• plugins/
• sessions/
• logs/
• cron/
• mcp-tokens/
• plans/, workspace/, skins/, and kanban/
• pairing/ and platforms/ stores, plus gateway routing/process state
• state.db, hermes_state.db, projects.db, response_store.db, memory_store.db, verification_evidence.db, kanban.db, and retaindb_queue.db

Recommended flow

The plan lists everything that will change, including conflicts, skipped items, and sensitive items. Nested secret-looking keys are redacted in the output.

위 내용은 공식 문서의 해당 섹션 요지입니다. 세부 플래그·기본값은 원문과 --help를 확인하세요.

openclaw migrate hermes --dry-run

openclaw migrate apply hermes --yes

openclaw doctor

openclaw gateway restart
    openclaw status

Conflict handling

Apply refuses to continue when the plan reports conflicts (a file or config value already exists at the target).

위 내용은 공식 문서의 해당 섹션 요지입니다. 세부 플래그·기본값은 원문과 --help를 확인하세요.

Secrets

Interactive openclaw migrate asks whether to import detected auth credentials, with yes selected by default.

위 내용은 공식 문서의 해당 섹션 요지입니다. 세부 플래그·기본값은 원문과 --help를 확인하세요.

주요 항목:

• Accepting imports current Hermes OpenAI Codex OAuth entries, OpenCode OpenAI OAuth and GitHub Copilot entries, and the supported .env keys.
• Use --no-auth-credentials, or answer no at the prompt, to import non-secret state only.
• Use --include-secrets to import credentials in an unattended --yes run.
• Use the onboarding wizard's --import-secrets flag to import credentials from the wizard.

JSON output for automation

With --json and no --yes, apply prints the plan and does not mutate state — the safest mode for CI and shared scripts.

위 내용은 공식 문서의 해당 섹션 요지입니다. 세부 플래그·기본값은 원문과 --help를 확인하세요.

openclaw migrate hermes --dry-run --json
openclaw migrate apply hermes --json --yes

트러블슈팅

Inspect the plan output. Each conflict identifies the source path and the existing target. Decide per item whether to skip, edit the target, or rerun with --overwrite.

위 내용은 공식 문서의 해당 섹션 요지입니다. 세부 플래그·기본값은 원문과 --help를 확인하세요.

관련 문서

주요 항목:

• openclaw migrate: full CLI reference, plugin contract, and JSON shapes.
• Onboarding: wizard flow and non-interactive flags.
• Migrating: move an OpenClaw install between machines.
• Doctor: post-migration health check.
• Agent workspace: where SOUL.md, AGENTS.md, and memory files live.

실습 체크리스트

1. 공식 문서와 로컬 버전을 대조합니다: https://docs.openclaw.ai/install/migrating-hermes
2. 관련 CLI는 openclaw --help 및 하위 명령 --help로 옵션을 확인합니다.
3. 설정 변경 시 openclaw config / openclaw doctor로 유효성을 검사합니다.
4. Gateway·채널·플러그인 변경 후에는 필요 시 Gateway를 재시작합니다.

자주 쓰는 명령·설정 예시

openclaw onboard --flow import

openclaw onboard --import-from hermes --import-source ~/.hermes

openclaw migrate hermes --dry-run    # preview only
    openclaw migrate apply hermes --yes  # apply with confirmation skipped

openclaw migrate hermes --dry-run

openclaw migrate apply hermes --yes

openclaw doctor

관련 링크

• 공식 원문: install/migrating-hermes
• OpenClaw 문서 홈

이 가이드는 공식 문서를 한국어 학습용으로 재구성한 것입니다. 옵션 기본값·플래그 이름은 설치 버전에 따라 달라질 수 있습니다.