2026년 OpenClaw 워크스페이스 백업·복원: ~/.openclaw를 클라우드 Mac mini로 안전하게 옮기기

볼륨을 키우거나 임대 Mac mini를 다시 깔았거나, 다른 리전에 핫스탠바이 게이트웨이가 필요해졌습니다. 이제 토큰·스킬·LaunchAgent 경로를 망가뜨리지 않고 OpenClaw를 옮겨야 합니다. ~/.openclaw를 데이터베이스처럼 다루세요: 쓰기를 멈추고, 일관되게 스냅샷하고, 읽기를 검증합니다. 이 글은 tar와 rsync 트레이드오프, 키를 새지 않고 아카이브를 공유하는 방법, 트래픽 전환 전 openclaw doctor 점검을 다룹니다. 업그레이드 체크리스트, 환경 프로필 위생, 게이트웨이 진단과 함께 읽으면 깊이가 붙습니다.

백업에 무엇이 들어가나

최소한 ~/.openclaw, openclaw.json, skills 아래 설치된 스킬, 컴플라이언스가 90일 보관 미러를 요구하면 게이트웨이 로그, 커스텀 훅을 포함합니다. 에이전트가 ~/.agents나 프로젝트 수준 .agents에 있으면 매니페스트에 적어 복원 시 도구 정의가 조용히 빠지지 않게 하세요.

재빌드 방법을 문서화한 뒤에만 부피 큰 재생 가능 폴더를 제외합니다: npm 캐시, 임시 모델 다운로드, 자동화 스크린샷용 브라우저 프로필. 모델 없는 전형적 프로덕션 아카이브는 압축 시 120–400 MB입니다. 로컬 LLM 가중치가 있으면 백업을 나누세요—설정 tarball과 아티팩트 동기화를 분리해 티켓 이동을 쉽게 합니다.

tar 대 rsync

방법	적합	주의
tar czf	보안팀 또는 S3로의 시점 인수인계	게이트웨이 중지 확인; shasum -a 256 검증
rsync -aH	스테이징 호스트 간 증분 보정	xattr에 의존하면 보존; 끝 슬래시 주의
APFS 스냅샷	위험한 업그레이드 전 동일 머신 롤백	오프박스 재해 복구 대체는 아님

새 클라우드 Mac으로 이전할 때 체크섬이 있는 tarball은 가정용 업링크에서 반복 rsync보다 종종 더 빠릅니다. 두 호스트가 같은 VLAN에 있으면 250 MB 트리는 rsync로 6분 안에 끝나는 경우가 많습니다—교조가 아니라 네트워크로 고르세요.

비밀과 컴플라이언스

원본 .env를 티켓에 붙이지 마세요. 감사용으로는 파일명을 해시한 마스킹 트리 목록을 만들고 실제 비밀은 금고에 둡니다. 키를 옮겨야 한다면 이전 중 로테이션: 대상 호스트에서 새 Slack 봇 토큰과 Discord webhook을 발급하고 doctor 프로브가 성공한 뒤 이전 것을 폐기하세요.

SOC2를 염두에 둔 팀은 두 가지 산출물을 둡니다: (1) 비상용 암호화 풀 백업, (2) 엔지니어링 재현용 살균 아카이브. 보존 기간을 문서화—스타트업은 살균 사본 35일, 금고 객체 1년을 자주 택합니다.

새 Mac에서의 복원 순서

1. 이전 전에 기록한 것과 동일한 Node 22 LTS 마이너 설치; 여기서 드리프트하면 네이티브 모듈이 어긋납니다.
2. 서비스 사용자(대개 SSH 로그인)를 만들고 올바른 UID/GID로 홈에 풉니다.
3. 승인된 경로로 openclaw CLI를 전역 또는 패키지 매니저로 재설치.
4. LaunchAgent plist 또는 systemd에 상응하는 것을 다시 로드; macOS에서는 온보딩 문서대로 launchctl bootstrap.
5. TCC 권한(화면 기록, 자동화 등) 재부여—머신 로컬입니다.

클라우드 테넌트 간 이동 시 TCC 클릭에 15–25분의 사람 시간이 드는 경우가 많습니다. VNC 세션에서 한꺼번에 처리해 부분 승인을 피하세요.

검증 매트릭스

DNS 전환 전 아래를 수행하고 변경 티켓에 타임스탬프를 남깁니다:

• openclaw doctor가 0으로 종료하고 경고 예산은 소스 호스트와 같음.
• 채널 프로브가 30초 안에 합성 메시지 왕복을 완료.
• 모델이나 캐시를 푼 뒤 APFS 여유 공간이 20% 초과.
• 상위 10개 자동화 플로우를 재생하는 동안 CPU 유휴가 35% 미만.

어느 단계든 실패하면 DNS를 롤백하고 옛 게이트웨이를 유지—전환 직전 스냅샷했다면 클라우드 Mac 되돌리기는 약 5분입니다.

자동화 팁

각 아카이브 옆에 BACKUP_MANIFEST.txt를 두고 OpenClaw 버전, Node 버전, OS 빌드, 체크섬을 적습니다. 미래의 당신과 새벽 2시 당직이 고마워합니다. 매니페스트 생성은 LaunchAgent 시리즈에서 설명한 주간 cron에 묶을 수 있습니다.

무분별 복제를 피할 때

소스 머신이 침해됐다면 홈 트리 전체를 복사하지 말고 알려진 양호 설정에서 재구축하세요. 살균 아카이브와 새로 로테이션한 자격 증명을 사용합니다. 속도를 택해 LaunchAgent를 그대로 복제하다 악성 지속성을 남긴 팀의 사례가 있습니다.

대역폭과 시간 창

이론상 400 MB tarball을 25 Mbps 업링크로 올리면 약 2.5분—TLS와 재전송을 더하면 대개 두 배입니다. webhook이 많은 시간대를 피하고, 전환 창에는 게이트웨이를 두드리는 마케팅 자동화를 멈추세요. APAC 팀은 UTC 02:00을 자주 고릅니다—미국 트래픽은 낮고 EU 아침 피크는 아직입니다.

다중 호스트 함대는 서명된 아티팩트 파이프라인을 씁니다: tar를 SSE-KMS 내부 객체 스토리지에 올리고, 새 Mac은 60분 만료 일회용 URL로 받은 뒤 객체를 삭제합니다. 장수명 공개 링크를 싫어하는 감사에 맞습니다.

복원 후 스킬과 플러그인

~/.openclaw/skills의 고정 스킬은 그대로 나타나야 하지만 openclaw skills list로 매니페스트와 개수를 비교하세요. 플러그인이 설치 시 바이너리를 받았다면 Apple Silicon 대상과 아키텍처가 맞는지 확인합니다. 불일치는 보통 처음 세 가지 자동 작업 안에 로그에서 spawn ENOEXEC로 드러납니다—고객 채널이 다시 붙기 전에 잡으세요.

분기별 「소방 훈련」을 문서화: 지난주 백업을 새 mini에 복원해 doctor를 돌린 뒤 철거합니다. 분기 90분을 투자하는 팀은 실제 이전 시 Sev-2가 약 40% 줄었다고 보고합니다(MacHTML 테넌트 사후 검토)—대개 매니페스트가 정직했기 때문입니다.

관측 가능성도 맹목 이전하지 마세요. 옛 호스트가 로컬 파일에 로그를 쌓는다면 전환 전 싱크 설정을 복제하지 않으면 첫 시간은 눈가림입니다. filebeat나 macOS 친화 에이전트를 같은 Elasticsearch 인덱스로 보내 새 host.name 라벨로 48시간 오류율을 나란히 비교하세요.

마지막으로 종이 runbook PDF를 남기세요—클라우드 업체라도 아이러니입니다. DNS와 VPN이 망가지면 오프라인 체크리스트가 열리지 않는 위키를 이깁니다. PDF 버전 문자열을 OpenClaw semver 옆에 두면 감사가 문서와 실행 코드를 대응시킬 수 있습니다.

FAQ

Dropbox로 ~/.openclaw를 동기화해도 되나요?

강력 비권장—파일 워처가 게이트웨이와 경쟁하고, 클라우드 동기화가 JSON 저장 중간에 끼어든 사례가 있습니다. 명시적 스케줄 백업을 쓰세요.

같은 호스트명이 필요한가요?

일부 webhook URL에 호스트명이 박혀 있습니다. 호스트명이 바뀌면 허용 출처와 콜백 URL을 갱신하세요. 채널을 프로브하면 doctor가 불일치를 빨리 드러냅니다.

Apple Silicon과 Intel 아카이브는 호환되나요?

설정은 옮겨집니다. 스킬 의존의 네이티브 바이너리는 재빌드가 필요할 수 있습니다. 아키텍처를 넘나들 때 npm rebuild에 약 20분을 잡으세요.

OpenClaw는 밑바닥 Mac이 안정적이고 상시 가동하며 스냅샷하기 쉬울 때 빛납니다. Apple Silicon Mac mini는 네이티브 키체인 동작, 예측 가능한 USB 보안 키 지원, 24/7 게이트웨이용 조용한 써멀을 제공합니다—사고마다 새 하드웨어를 살 필요가 없습니다. MacHTML은 SSH/VNC가 있는 베어메탈 임대를 제공해 일회용 호스트에서 백업/복원 훈련을 하고, 승리한 이미지를 승격한 뒤 나머지를 폐기할 수 있습니다. 책상 아래 유휴 장비를 두는 것보다 탄력 있는 Mac 용량이 낫습니다.