반응형
OpenClaw 새 머신으로 옮기기 완전 정리
(cmd by cmd + 폴더 구조 + 사전 체크리스트 + device approve까지)
노트북을 새로 샀거나, 서버를 옮겨야 할 때 “OpenClaw를 통째로 그대로 옮길 수 없을까?” 싶은 순간이 있습니다. 다시 온보딩하고, 채널 로그인(텔레그램/왓츠앱 등) 다시 하고, 세션 날려먹고… 이런 건 최대한 피하고 싶죠.
다행히 OpenClaw는 구조만 이해하면 “state 디렉토리 + workspace” 두 가지만 잘 옮기면 깔끔하게 마이그레이션이 가능합니다.
이 글에서는:
- 새 머신으로 옮기기 전에 무엇을 설치/확인해야 하는지
- 하나하나 cmd by cmd 예시와 그 명령이 뭘 하는지
- 폴더 구조가 어떻게 생겼는지
- device approve(디바이스 승인)을 까먹지 않기 위해 무엇을 기억해야 하는지
까지 전부 정리해 보겠습니다.
1. 개념 먼저: OpenClaw가 어디에 무엇을 저장하는가?
OpenClaw를 옮길 때 핵심은 두 폴더입니다.
- State 디렉토리 (
) – 기본값:~/.openclaw/ - Workspace 디렉토리 – 기본값:
~/.openclaw/workspace/
이 두 개를 그대로 새 머신으로 가져가면:
- 기존 세션, 기억, 설정, 채널 로그인까지 대부분 그대로 유지
- 사실상 “같은 OpenClaw를 다른 머신에서 이어 쓰는 느낌”으로 사용할 수 있습니다.
2. 폴더 구조 한 번 찍어보기
2-1. 구 폴더 구조 확인
ls -R ~/.openclaw
그리고 워크스페이스는:
ls ~/.openclaw/workspace
3. 본격 마이그레이션 전에: 새 머신 사전 체크리스트
3-1. OS & 권한
- macOS / Linux / WSL2 / (서버의 경우 보통 Ubuntu LTS 권장)
- 새 머신의 사용자 계정이 정상적으로 홈 디렉토리를 가지고 있는지
3-2. Node & OpenClaw 설치 가능 여부
curl -fsSL https://openclaw.ai/install.sh | bash
openclaw status
3-3. ssh / scp / rsync 준비
3-4. (중요) 노드/디바이스 승인 흐름 이해해 두기
마이그레이션 이후, 새 머신에서 처음으로 폰/다른 장비가 연결을 시도하면 승인(approve) 단계를 반드시 한 번 거쳐야 합니다.
4. 구 머신에서 할 일 (Step 0 ~ Step 2)
Step 0 — 게이트웨이 먼저 멈추기
openclaw gateway stop
Step 1 — state 디렉토리 아카이브하기
cd ~
tar -czf openclaw-state.tgz .openclaw
Step 2 — workspace 아카이브하기
cd ~
tar -czf openclaw-workspace.tgz .openclaw/workspace
Step 3 — 새 머신으로 파일 복사
scp openclaw-state.tgz openclaw-workspace.tgz newuser@newhost:~
5. 새 머신에서 할 일 (Step 1 ~ Step 3)
Step 1 — OpenClaw 설치
curl -fsSL https://openclaw.ai/install.sh | bash
openclaw status
Step 2 — 아카이브 풀어서 덮어쓰기
cd ~
tar -xzf openclaw-state.tgz
tar -xzf openclaw-workspace.tgz
sudo chown -R ysyoo:ysyoo ~/.openclaw
Step 3 — Doctor로 마이그레이션 마무리
openclaw doctor
openclaw gateway restart
openclaw status
6. 흔한 함정(Footguns)과 회피 방법
6-1. 프로필 / state-dir 불일치
openclaw --profile work status
openclaw --profile work doctor
6-2. openclaw.json만 복사한 경우
반드시 ~/.openclaw 전체를 그대로 가져가야 합니다.
6-3. 권한 문제
sudo chown -R ysyoo:ysyoo ~/.openclaw
7. device approve(디바이스 승인) 잊지 않기
7-1. 왜 다시 승인이 필요할 수 있을까?
마이그레이션 후에는 게이트웨이 호스트가 바뀌었거나 세션이 리셋되면서, 노드 연결이 “새로운 연결”로 인식될 수 있습니다.
7-2. 체크리스트
openclaw status로 게이트웨이가 정상인지 확인- 대시보드에서 기존 세션/메모가 잘 보이는지 확인
- 폰/다른 장비에서 한 번 요청해 보고 승인 메시지가 오는지 확인
- 보이면 Web UI 또는 CLI에서 해당 디바이스 승인
8. 최종 마이그레이션 체크리스트
openclaw status가 정상- 대시보드에서 기존 세션/메모 확인
- 채널 로그인 상태(텔레그램/WhatsApp 등) 유지 여부
~/.openclaw/workspace안에 기존 파일들 존재- 필요 시 노드/디바이스 승인 완료
반응형
댓글