OpenClaw를 새 장비로 이전하기

새 컴퓨터를 장만하거나 작업 환경을 바꿀 때, 기존에 공들여 설정한 개발 환경을 다시 세팅하는 일은 꽤 번거로운 작업이에요. 특히 API 키를 다시 입력하고, 채널 로그인을 새로 하고, 이전의 세션 기록이 사라지는 상황은 피하고 싶을 거예요.

OpenClaw는 복잡한 재설정 없이도 쓰던 상태 그대로 새 장비로 옮길 수 있어요. 핵심은 state directory와 workspace 두 가지만 제대로 복사하는 거예요. 이 가이드를 통해 데이터 손실 없이 안전하게 이전을 마칠 수 있도록 도와드릴게요.

필요한 것

이전을 시작하기 전에 다음 항목들이 준비되었는지 확인해 주세요.

기존 장비의 OpenClaw 상태 디렉토리 ($OPENCLAW_STATE_DIR, 기본값: ~/.openclaw/)
기존 장비의 워크스페이스 폴더 (기본값: ~/.openclaw/workspace/)

Quick Start (5분 완성)

가장 빠르게 이전을 완료하는 4단계 과정이에요.

Step 0 — 기존 장비에서 백업하기

데이터가 복사되는 중에 변경되지 않도록 기존 장비에서 Gateway를 먼저 멈춰주세요.

openclaw gateway stop

그 다음, 상태 디렉토리와 워크스페이스를 압축합니다.

# 프로필이나 커스텀 경로를 사용하는 경우 경로를 수정하세요
cd ~
tar -czf openclaw-state.tgz .openclaw
tar -czf openclaw-workspace.tgz .openclaw/workspace

Step 1 — 새 장비에 OpenClaw 설치하기

새 장비에서 CLI를 설치해 주세요. (Node.js가 필요할 수 있어요)

참고: Install

이 단계에서 온보딩으로 인해 새로운 ~/.openclaw/가 생성되어도 괜찮아요. 다음 단계에서 덮어쓸 예정이니까요.

Step 2 — 데이터 복사 및 덮어쓰기

압축한 파일들을 새 장비로 옮긴 후 풀어주세요. scp나 rsync, 또는 외부 드라이브를 사용하면 돼요. 복사 후에는 다음 두 가지를 꼭 확인하세요.

.openclaw/ 같은 숨겨진 디렉토리가 모두 포함되었는지 확인하세요.
파일 소유권이 Gateway를 실행할 사용자 계정으로 되어 있는지 확인하세요.

Step 3 — Doctor 실행 및 확인

새 장비에서 다음 명령어를 실행하여 설정을 복구하고 서비스를 최적화하세요.

openclaw doctor

문제가 없다면 Gateway를 다시 시작하고 상태를 확인합니다.

openclaw gateway restart
openclaw status

문제 해결

이전 과정에서 자주 발생하는 문제와 해결 방법이에요.

프로필(profile) 또는 상태 디렉토리 불일치

기존 장비에서 특정 --profile을 사용했는데 새 장비에서 기본 설정으로 실행하면 설정이 적용되지 않거나 세션이 비어 보일 수 있어요.

해결책: 기존과 동일한 프로필 이름을 지정해서 Gateway를 실행하고 다시 openclaw doctor를 실행하세요.

`openclaw.json` 파일만 복사한 경우

설정 파일 하나만으로는 부족해요. API 키나 세션 데이터는 별도의 폴더에 저장되기 때문이에요.

해결책: 반드시 $OPENCLAW_STATE_DIR 폴더 전체를 복사해야 합니다.

권한 및 소유권 문제

root 권한으로 복사하거나 사용자가 달라진 경우 Gateway가 데이터를 읽지 못할 수 있어요.

해결책: 상태 디렉토리와 워크스페이스의 소유권이 현재 사용자에게 있는지 확인하세요.

백업 파일 내 보안 정보

상태 디렉토리에는 API 키, OAuth 토큰 등 민감한 정보가 들어있어요.

해결책: 백업 파일을 안전하게 보관하고, 유출이 의심된다면 즉시 키를 교체하세요.

Verification Checklist

이전이 잘 되었는지 마지막으로 점검해 보세요.

openclaw status에서 Gateway가 정상 작동하는지 확인하세요.
연결했던 채널(예: WhatsApp)이 재인증 없이 유지되는지 확인하세요.
대시보드에서 이전 세션 기록이 그대로 보이는지 확인하세요.
워크스페이스의 메모리와 설정 파일들이 제대로 있는지 확인하세요.

도움이 더 필요하신가요? AI Setup Assistant에게 물어보세요!

다음 단계

OpenClaw Expert

아직 막혀 있나요?

이 문서에서 답을 못 찾았다면 OpenClaw Expert에게 바로 물어보세요.