Migrating from Claude
기준일: 2026-07-26
공식 기준: Migrating from Claude
Migrating from Claude 문서는 OpenClaw 공식 문서(install/migrating-claude)를 한국어로 정리한 가이드입니다. Move Claude Code and Claude Desktop local state into OpenClaw with a previewed import 명령·설정 키·코드 예시는 공식 문서를 그대로 보존하며, 해석과 절차 안내는 한국어로 제공합니다. 최종 동작은 설치된 CLI 버전과 공식 원문을 확인하세요.
핵심 요약
Move Claude Code and Claude Desktop local state into OpenClaw with a previewed import
한국어 가이드 범위: install/migrating-claude 경로의 설정·명령·제약·예시를 학습용으로 재구성합니다.
문서 구성
공식 문서의 주요 섹션은 다음과 같습니다.
- Two ways to import
- What gets imported
- What stays archive-only
- Source selection
- Recommended flow
- Conflict handling
- JSON output for automation
- 트러블슈팅
- 관련 문서
상세 내용
본문
OpenClaw imports local Claude state through the bundled Claude migration provider. The provider previews every item before changing state and redacts secrets in plans and reports. Standalone openclaw migrate creates a verified backup; the fresh onboarding path stages the import and publishes it only after verification succeeds.
위 내용은 공식 문서의 해당 섹션 요지입니다. 세부 플래그·기본값은 원문과
--help를 확인하세요.
Two ways to import
The wizard offers Claude when it detects local Claude state.
위 내용은 공식 문서의 해당 섹션 요지입니다. 세부 플래그·기본값은 원문과
--help를 확인하세요.
openclaw onboard --flow import
openclaw onboard --import-from claude --import-source ~/.claude
openclaw migrate claude --dry-run
openclaw migrate apply claude --yes
What gets imported
MCP server definitions are imported from project .mcp.json, Claude Code ~/.claude.json, and Claude Desktop claude_desktop_config.json when present.
위 내용은 공식 문서의 해당 섹션 요지입니다. 세부 플래그·기본값은 원문과
--help를 확인하세요.
주요 항목:
- Project
CLAUDE.mdand.claude/CLAUDE.mdcontent is copied or appended into the OpenClaw agent workspaceAGENTS.md. - User
~/.claude/CLAUDE.mdcontent is appended into workspaceUSER.md. - Claude skills with a
SKILL.mdfile are copied into the OpenClaw workspace skills directory. - Claude command Markdown files under
.claude/commands/or~/.claude/commands/are converted into OpenClaw skills withdisable-model-invocation: true.
What stays archive-only
The provider copies these into the migration report for manual review, but does not load them into live OpenClaw config:
위 내용은 공식 문서의 해당 섹션 요지입니다. 세부 플래그·기본값은 원문과
--help를 확인하세요.
주요 항목:
- Claude hooks
- Claude permissions and broad tool allowlists
- Claude environment defaults
CLAUDE.local.md.claude/rules/- Claude subagents under
.claude/agents/or~/.claude/agents/ - Claude Code caches, plans, and project history directories
- Claude Desktop extensions and OS-stored credentials
Source selection
Without --from, OpenClaw inspects the default Claude Code home at ~/.claude, the sampled Claude Code ~/.claude.json state file, and the Claude Desktop MCP config on macOS.
위 내용은 공식 문서의 해당 섹션 요지입니다. 세부 플래그·기본값은 원문과
--help를 확인하세요.
Recommended flow
The plan lists everything that will change, including conflicts, skipped items, and sensitive values redacted from nested MCP env or headers fields.
위 내용은 공식 문서의 해당 섹션 요지입니다. 세부 플래그·기본값은 원문과
--help를 확인하세요.
openclaw migrate claude --dry-run
openclaw migrate apply claude --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를 확인하세요.
JSON output for automation
--yes is required for migrate apply outside an interactive terminal; without it OpenClaw errors instead of applying, so scripts and CI must pass --yes explicitly. Preview first with --dry-run --json, then apply with --json --yes once the plan looks right.
위 내용은 공식 문서의 해당 섹션 요지입니다. 세부 플래그·기본값은 원문과
--help를 확인하세요.
openclaw migrate claude --dry-run --json
openclaw migrate apply claude --json --yes
트러블슈팅
Pass --from /actual/path (CLI) or --import-source /actual/path (onboarding).
위 내용은 공식 문서의 해당 섹션 요지입니다. 세부 플래그·기본값은 원문과
--help를 확인하세요.
관련 문서
주요 항목:
openclaw migrate: full CLI reference, plugin contract, and JSON shapes.- Migration guide: all migration paths.
- Migrating from Hermes: the other cross-system import path.
- Onboarding: wizard flow and non-interactive flags.
- Doctor: post-migration health check.
- Agent workspace: where
AGENTS.md,USER.md, and skills live.
실습 체크리스트
- 공식 문서와 로컬 버전을 대조합니다:
https://docs.openclaw.ai/install/migrating-claude - 관련 CLI는
openclaw --help및 하위 명령--help로 옵션을 확인합니다. - 설정 변경 시
openclaw config/openclaw doctor로 유효성을 검사합니다. - Gateway·채널·플러그인 변경 후에는 필요 시 Gateway를 재시작합니다.
자주 쓰는 명령·설정 예시
openclaw onboard --flow import
openclaw onboard --import-from claude --import-source ~/.claude
openclaw migrate claude --dry-run
openclaw migrate apply claude --yes
openclaw migrate claude --dry-run
openclaw migrate apply claude --yes
openclaw doctor
관련 링크
이 가이드는 공식 문서를 한국어 학습용으로 재구성한 것입니다. 옵션 기본값·플래그 이름은 설치 버전에 따라 달라질 수 있습니다.