하드웨어 업그레이드, 클라우드 리전 이동, 재해 훈련은 모두 같은 OpenClaw 워크스페이스를 건드립니다. 마크다운 페르소나, 도구 매니페스트, 모델 캐시, launchd 경로가 한 덩어리로 맞아야 합니다. 홈 디렉터리 전체를 복사하면 오래된 시크릿과 필요 없는 120 GB 캐시까지 실어 나르기 쉽습니다. 이 2026년 가이드는 제외 규칙, SHA-256 검증, 순서가 정해진 일곱 단계, 이전·이후 체크리스트 표, 대용량 전송 대역 계산, DNS 전환 주의, 롤백 타임박스, 이전 뒤 게이트웨이가 루프 도는 FAQ형 문제 해결을 정의합니다.
데몬 기준선은 헤드리스 온보딩 수락으로, 시크릿은 키체인과 .env로, 업그레이드는 운영 런북으로 다룹니다. 이전 중 TCC 프롬프트를 눌러야 할 때는 VNC를 쓰고, SSH 키·연결 기대치는 도움말, 리전 비용은 요금 페이지와 함께 보십시오.
tar 전에 반드시 풀어야 할 세 가지 경로 의존성
- 워크스페이스 루트: plist에
WorkingDirectory가 박혀 있으면 대상 사용자나 plist가 맞아야 합니다—파일만 복사하는 것이 가장 흔한 실패 모드입니다. - 캐시: 모델·npm 캐시가 30~120 GB를 먹을 수 있습니다. 대역과 시간 창이 허용하지 않으면 제외하십시오.
- 바인드 주소: 특정 en0 IP에 묶인 게이트웨이는 DHCP가 바뀐 뒤 헬스 체크를 깨뜨립니다—트래픽을 자르기 전 의도한 바인드 모드를 문서화하십시오.
변경 티켓에 허용 가능한 드리프트를 적으십시오. 예를 들어 캐시가 데워지는 동안 첫 응답 지연이 기준선보다 20% 넘을 수는 있어도 도구 호출 실패율은 움직이면 안 됩니다. 새벽 두 시에는 숫자로 받아들이는 것이 "괜찮은 느낌" 논쟁보다 낫습니다.
아카이브 제외 지침
| 경로 패턴 | 포함? | 비고 |
|---|---|---|
| SOUL.md, TOOLS.md, AGENTS.md | 필수 | 보통 5 MB 미만 |
| **/node_modules | 대개 제외 | 재현성을 위해 npm ci로 재설치 |
| 모델 가중치 캐시 | 정책 선택 | 상행이 좁으면 컷오버 뒤 15분 워밍업을 받아들일 수 있음 |
대용량 전송과 재개 가능 동기화
50 GB를 넘기면 rsync --partial나 멀티파트 객체 업로드를 선호하고 양쪽 체크섬을 맞추십시오. 대칭 100 Mbps라면 80 GB는 이론상 약 110분—실제 WAN은 종종 두 배이므로 최악 창을 공유하십시오. 민감한 tar를 암호화 없는 범용 버킷으로 밀지 마십시오. 중간에 공급자 객체 저장소가 끼면 고객 KMS로 감싸십시오.
일곱 단계 이전 시퀀스
- 읽기 전용 스냅샷: 게이트웨이를 멈추거나 유지보수 라벨을 켜서 복사 중
MEMORY.md가 변하지 않게 합니다. - 아카이브와 해시: SHA-256을 티켓 본문에 남기고 채팅에만 두지 마십시오.
- 전송: 프라이빗 네트워크를 선호하고 임시 저장소 ACL을 조입니다.
- 최종 경로에 압축 해제: 소유권을 서비스 사용자에 맞춥니다.
- 의존성 설치: Node 마이너를 고정하고 락파일을 존중하십시오—조용한 메이저 점프는 "OpenClaw가 망가졌다"로 위장합니다.
- LaunchAgent 정렬:
ProgramArguments와EnvironmentVariables를 검증합니다. - 이중 수락: 연속 세 번 헬스 체크와 최소 도구 호출 한 번.
이전·이후 체크리스트 표
| 점검 | 이전 기준선 | 이후 기대 |
|---|---|---|
| openclaw semver | 기록된 삼중 버전 | 일치하거나 doctor 출력과 함께 의도적 업그레이드를 문서화 |
| API 키 지문 | 마지막 6자리 16진 | 키를 함께 회전하지 않았다면 일치 |
| 리스닝 포트 | lsof 캡처 |
일치하거나 보안 그룹 문서 갱신 |
롤백 타임박스: 이중 수락이 45분 안에 실패하면 이중 쓰기 대신 읽기 전용 구 게이트웨이로 되돌리는 것이 기본값입니다—분열 뇌 상태와 이중 과금이 지저분한 병렬 경로를 따릅니다. 컴플라이언스가 더 길게 요구하지 않는 한 읽기 전용 레거시는 72시간을 넘기지 마십시오.
컷오버 뒤 FAQ형 문제 해결
캐시 없이 구성만 이전해도 되나요?
네—종종 권장됩니다. 마크다운과 락파일만 가벼운 번들로 보내 대상에서 의존성을 다시 설치하고, 캐시가 다시 채워지는 동안 첫 응답이 2~4배 느려지는 것을 받아들이십시오. 저지연 SLA가 있으면 메인 아카이브와 같은 체크섬 규율로 캐시 디렉터리를 증분 rsync하십시오.
게이트웨이가 재시작 루프를 도나요?
복사-붙여넣기로 들어간 plist 환경 변수의 공백을 비교하십시오. 호스트마다 Node 절대 경로가 다른지 확인합니다. 잠시 포그라운드로 바이너리를 띄우고 마지막 200줄 stderr를 잡아 티켓에 붙이십시오—몇 달 뒤의 자신이 감사할 기록입니다.
스테이징이 프로덕션 디스크 레이아웃을 거울처럼 따라야 하나요?
예. 분기마다 비프로덕션 Mac mini에서 같은 경로·사용자명·plist 위치로 리허설하십시오. 노트북에서만 이전을 연습하는 팀은 마케팅 론칭 직전 금요일 밤에 경로 깜짝 발견을 합니다. 스테이징 드릴 비용이 임원 에스컬레이션보다 쌉니다.
DNS, 인그레스, 다중 게이트웨이 주의
여전히 구 인스턴스를 가리키는 인바운드 경로를 동결하십시오—Slack 이벤트 구독이나 IP 허용 목록이 그렇지 않으면 유휴로 생각한 호스트로 트래픽을 밀어 넣습니다. 이전 중 DNS TTL을 약 60초로 낮춰 롤백을 빠르게 하고, 24시간 안정 뒤에는 리졸버 잡음을 줄이려 TTL을 길게 되돌리십시오.
한 페이지짜리 이전 diff를 게시하십시오: 아카이브 바이트, 제외 목록, 구·신 포트, doctor 출력 diff. 검색 가능한 문서가 세 달 뒤 "왜 node_modules를 빼냈지"를 묻는 사람에게 Slack 스크롤보다 낫습니다.
자동화 훅: 스크립트화할 때와 수동을 유지할 때
첫 이전은 신중한 수동 체크포인트가 이득입니다—사람이 plist 따옴표 이상과 예기치 않은 파일 모드를 잡습니다. 같은 제외 목록으로 두 번 성공한 뒤에는 tar·해시·rsync 단계를 OpenClaw 버전으로 태그한 버전 관리 스크립트로 감싸십시오. 자동화가 체크섬 비교를 건너뛰게 두지 마십시오. 값싼 Wi-Fi에서의 조용한 비트 뒤집힘이 생각보다 많은 아카이브를 망가뜨렸습니다. 부분 실패 뒤 재실행해도 디렉터리가 중복되지 않게 멱등하게 만드십시오.
이전 일정을 캘린더와 엮으십시오: 첫 응답 SLO가 넓어질 수 있음을 하류 팀에 알리고, 롤백 명령 스니펫을 일정 설명에 붙이십시오. 여섯 달 뒤 메일함을 검색하는 운영자가 일시 채팅 스레드를 파헤치는 것보다 빠릅니다.
지연, 상주, 컴플라이언스
홍콩에서 도쿄로 옮기면 RTT가 25 ms에서 55 ms로 바뀌어 도구에 박힌 타임아웃이 드러납니다. 로그에 대화형 PII가 섞일 수 있으니 전송 중 아카이브를 암호화하고 ROPA에 처리를 등록하십시오. NodeMac은 홍콩·일본·한국·싱가포르·미국 리전으로 애플리케이션 코드를 다시 짓지 않고도 데이터 옆에 게이트웨이를 둘 수 있게 합니다.
Mac mini M4의 통합 메모리와 캐시 대역은 이전 뒤 의존성 재구축을 빠르게 하고, 네이티브 macOS는 컨테이너 경로 깜짝 이슈를 피합니다. NodeMac으로 전용 호스트를 임대하면 구 호스트에서 신 호스트까지 SSH/VNC 워크플로가 같아 하드웨어 이동이 일회성 영웅담이 아니라 반복 가능한 운영이 됩니다. 베어 메탈의 예측 가능성은 사고가 구성 드리프트인지 상류 모델 동작인지 논쟁할 때 이전·이후 표 비교를 신뢰할 만하게 만듭니다. 성공한 이전마다 재사용할 템플릿으로 취급하십시오.