openclaw backup
OpenClaw 상태, config, 인증 프로필, 채널/제공자 자격 증명, 세션, 그리고 선택적으로 워크스페이스에 대한 로컬 백업 아카이브를 생성합니다.
참고
- 아카이브에는 확인된 소스 경로와 아카이브 레이아웃이 포함된
manifest.json파일이 포함됩니다. - 기본 출력은 현재 작업 디렉터리에 타임스탬프가 포함된
.tar.gz아카이브입니다. - 현재 작업 디렉터리가 백업 대상 소스 트리 내부에 있으면, OpenClaw는 기본 아카이브 위치로 홈 디렉터리를 대신 사용합니다.
- 기존 아카이브 파일은 절대 덮어쓰지 않습니다.
- 소스 상태/워크스페이스 트리 내부의 출력 경로는 자체 포함을 방지하기 위해 거부됩니다.
openclaw backup verify <archive>는 아카이브에 루트 manifest가 정확히 하나 포함되어 있는지 검증하고, traversal 스타일 아카이브 경로를 거부하며, manifest에 선언된 모든 페이로드가 tarball에 존재하는지 확인합니다.openclaw backup create --verify는 아카이브를 쓴 직후 해당 검증을 즉시 실행합니다.openclaw backup create --only-config는 활성 JSON config 파일만 백업합니다.
백업되는 항목
openclaw backup create는 로컬 OpenClaw 설치에서 백업 소스를 계획합니다:
- OpenClaw의 로컬 상태 확인자가 반환하는 상태 디렉터리(보통
~/.openclaw) - 활성 config 파일 경로
- 상태 디렉터리 밖에 존재하는 경우 확인된
credentials/디렉터리 --no-include-workspace를 전달하지 않는 한 현재 config에서 발견된 워크스페이스 디렉터리
agents/<agentId>/agent/auth-profiles.json에 포함되어 있으므로, 일반적으로
상태 백업 항목으로 포함됩니다.
--only-config를 사용하면 OpenClaw는 상태, 자격 증명 디렉터리, 워크스페이스 검색을 건너뛰고 활성 config 파일 경로만 아카이브합니다.
OpenClaw는 아카이브를 만들기 전에 경로를 정규화합니다. config, 자격 증명 디렉터리 또는 워크스페이스가 이미 상태 디렉터리 내부에 있으면, 별도의 최상위 백업 소스로 중복되지 않습니다. 누락된 경로는 건너뜁니다.
아카이브 페이로드는 해당 소스 트리의 파일 내용을 저장하며, 포함된 manifest.json은 확인된 절대 소스 경로와 각 자산에 사용된 아카이브 레이아웃을 기록합니다.
잘못된 config 동작
openclaw backup은 복구 중에도 도움을 줄 수 있도록 의도적으로 일반 config 사전 점검을 우회합니다. 하지만 워크스페이스 검색은 유효한 config에 의존하므로, 이제 openclaw backup create는 config 파일이 존재하지만 잘못되었고 워크스페이스 백업이 여전히 활성화되어 있으면 즉시 실패합니다.
그런 상황에서도 부분 백업을 원한다면 다음과 같이 다시 실행하세요:
--only-config도 config가 잘못된 경우에 작동합니다. 워크스페이스 검색을 위해 config 파싱에 의존하지 않기 때문입니다.
크기 및 성능
OpenClaw는 기본 제공 최대 백업 크기 또는 파일별 크기 제한을 강제하지 않습니다. 실질적인 제한은 로컬 머신과 대상 파일 시스템에서 결정됩니다:- 임시 아카이브 쓰기와 최종 아카이브를 위한 사용 가능한 공간
- 큰 워크스페이스 트리를 순회하고
.tar.gz로 압축하는 데 걸리는 시간 openclaw backup create --verify를 사용하거나openclaw backup verify를 실행할 때 아카이브를 다시 검사하는 시간- 대상 경로에서의 파일 시스템 동작. OpenClaw는 덮어쓰지 않는 하드 링크 게시 단계를 우선 사용하고, 하드 링크를 지원하지 않으면 배타적 복사로 대체합니다
--no-include-workspace를 사용하세요.
가장 작은 아카이브가 필요하면 --only-config를 사용하세요.