OpenClaw Backup 스킬 가이드

OpenClaw Backup 스킬 개요

Backup 스킬은 OpenClaw 에이전트에 전체 설정의 스냅샷 및 복원 기능을 제공합니다 — 스킬, 명령, 설정, MCP 통합, 컨텍스트, 템플릿 모두를 자연어 요청 하나로 처리할 수 있습니다. 잘못된 업데이트나 스킬 설정 오류로 작동 중인 설정을 잃어본 적이 있다면, 이것이 바로 필요한 안전망입니다.

OpenClaw 설정은 ~/.claude/ 아래의 여러 디렉토리와 파일에 분산되어 있습니다. 무엇이 변경되었는지 수동으로 추적하는 것은 번거롭고 오류가 발생하기 쉽습니다. OpenClaw Backup 스킬은 전체 프로세스를 자동화합니다: 타임스탬프가 포함된 tar.gz 아카이브를 생성하고, 선택적 백업 모드를 지원하며, Git, rsync 또는 Dropbox, Google Drive 같은 클라우드 스토리지를 통해 여러 기기 간에 설정을 동기화할 수 있습니다.

일반적인 워크플로:

1. 새 스킬을 설치하기 전에 OpenClaw에 현재 설정을 백업하도록 요청합니다.
2. 에이전트가 설정을 타임스탬프가 포함된 아카이브로 패키징하여 ~/openclaw-backups/에 저장합니다.
3. 문제가 발생하면 OpenClaw에 최신 백업에서 복원하도록 요청 — 몇 초 만에 작동 상태로 복구됩니다.

이 스킬은 설정 변경을 실시간으로 검증하는 Config Guardian 스킬과 잘 어울리며, 백업에 포함된 API 토큰을 안전하게 관리하는 1Password 스킬과도 자연스럽게 통합됩니다.

Backup 스킬 사전 요구 사항

Backup 스킬을 설치하기 전에 다음을 확인하세요:

• OpenClaw 설치 및 실행 중 (v1.0+)
• 백업 아카이브용 충분한 디스크 공간 (스킬 수에 따라 스냅샷당 일반적으로 5–50 MB)
• 스킬 관리용 clawhub CLI 설치됨
• Git (선택사항) — 버전 관리된 백업 이력이 필요한 경우에만

환경 확인:

# OpenClaw 버전 확인
openclaw --version

# 사용 가능한 디스크 공간 확인
df -h ~/openclaw-backups

# clawhub CLI 확인
clawhub --version

Backup 스킬 설치 방법

단일 명령으로 Backup 스킬을 설치합니다:

npx clawhub@latest install backup

설치 확인:

clawhub list

설치된 스킬 목록에 backup이 표시되어야 합니다. clawhub CLI로 설치하면 가장 빠릅니다.

Backup 스킬 구성

Backup 스킬은 합리적인 기본 설정으로 즉시 사용할 수 있습니다. 환경 변수로 동작을 사용자 지정할 수 있습니다.

환경 변수 설정

# 사용자 지정 백업 디렉토리 (기본값: ~/openclaw-backups)
export OPENCLAW_BACKUP_DIR="$HOME/openclaw-backups"

# 최대 백업 보관 수 (기본값: 7)
export OPENCLAW_BACKUP_RETENTION=7

# 업데이트 전 자동 백업 활성화 (기본값: true)
export OPENCLAW_BACKUP_AUTO=true

백업 대상

스킬은 기본적으로 다음 디렉토리와 파일을 아카이브합니다:

| 경로 | 내용 | |------|------| | ~/.claude/skills/ | 설치된 스킬 정의 | | ~/.claude/commands/ | 사용자 지정 명령 | | ~/.claude/settings.json | 에이전트 설정 및 환경설정 | | ~/.claude/mcp/ | MCP 서버 구성 | | ~/.claude/contexts/ | 세션 컨텍스트 | | ~/.claude/templates/ | 사용자 지정 템플릿 |

캐시와 로그 파일은 자동으로 제외됩니다 — 시작 시 재생성되므로 아카이브만 부풀릴 뿐입니다.

중요: 백업 아카이브에는 설정이나 MCP 구성에 저장된 API 토큰, 시크릿, 자격 증명이 포함될 수 있습니다. 백업은 안전한 위치에 저장하고 공개 리포지토리에는 절대 커밋하지 마세요.

Backup 스킬 사용 예시

1. 전체 백업 생성

사용자: "새 Kubernetes 스킬을 설치하기 전에 전체 OpenClaw 설정을 백업해줘."

에이전트가 타임스탬프가 포함된 아카이브(예: openclaw-2026-03-13_1045.tar.gz)를 생성하여 모든 설정 파일을 포함합니다. 완료 시 아카이브 경로, 파일 크기, 항목 수를 보고합니다.

2. 스킬만 선택적 백업

사용자: "설치된 스킬만 백업해줘, 몇 개 삭제 테스트하고 싶어."

에이전트가 스킬 전용 백업을 실행하여 ~/.claude/skills/ 디렉토리만 아카이브합니다. 스킬 정의만 보호하면 될 때 더 빠르고 작은 파일을 생성합니다.

3. 백업에서 복원

사용자: "업데이트 후 뭔가 고장났어. 최신 백업에서 복원해줘."

에이전트가 사용 가능한 백업을 나열하고, 가장 최근 것의 타임스탬프와 내용을 보여주며, 복원 전에 확인을 요청합니다. 먼저 아카이브 무결성을 검증한 후 에이전트를 중지하고 현재 설정을 교체한 후 재시작합니다 — 작동 상태가 복구됩니다.

4. 백업 목록 및 관리

사용자: "내 모든 백업과 차지하는 공간을 보여줘."

에이전트가 백업 디렉토리의 모든 아카이브를 날짜순으로 파일 크기와 함께 나열합니다. 보관 기간을 초과한 오래된 백업에 플래그를 지정하고 정리를 제안합니다.

5. 원격으로 백업 동기화

사용자: "최신 백업을 Git 백업 리포에 푸시해줘."

에이전트가 최신 아카이브를 설정된 Git 리포지토리에 커밋하고 원격으로 푸시합니다. 이를 통해 버전 이력과 다중 기기 접근이 가능해집니다 — 다른 머신에서 리포지토리를 클론하여 모든 스냅샷에서 복원할 수 있습니다.

Backup 보안 및 모범 사례

백업 아카이브에는 완전한 OpenClaw 설정이 포함되어 있으며 민감한 데이터가 포함될 수 있습니다. 안전을 위해 다음 가이드라인을 따르세요:

• 민감한 백업을 암호화. 설정에 API 키나 토큰이 포함된 경우 클라우드 스토리지에 저장하기 전에 아카이브를 암호화하세요. gpg 또는 시크릿 매니저를 사용하세요.
• 파일 권한을 제한. 백업 파일을 현재 사용자만 읽을 수 있도록: chmod 700 ~/openclaw-backups.
• 백업을 공개 리포에 커밋하지 마세요. ~/openclaw-backups/를 전역 .gitignore에 추가하여 실수로 노출되는 것을 방지하세요.
• 오래된 백업을 로테이션. OPENCLAW_BACKUP_RETENTION을 설정하여 오래된 아카이브를 자동 정리. 대부분의 설정에서 7개 백업이 합리적인 기본값입니다.
• 정기적으로 복원을 검증. 실제로 필요하기 전에 복원 프로세스를 테스트하세요. 임시 디렉토리에 복원하여 아카이브 무결성을 확인하세요.
• Config Guardian과 Backup을 함께 사용. Config Guardian은 실시간으로 변경을 검증하고, Backup은 특정 시점 복구를 제공합니다. 함께 사용하면 완전한 안전망을 형성합니다. 안전 체크리스트에서 OpenClaw 일반 보안 가이드를 확인하세요.

Backup 일반적인 오류 해결

"No backups found in ~/openclaw-backups"

백업 디렉토리가 비어있거나 존재하지 않습니다.

1. 디렉토리 존재 확인:

ls -la ~/openclaw-backups

2. 경로를 사용자 지정한 경우 OPENCLAW_BACKUP_DIR이 올바르게 설정되어 있는지 확인:

echo $OPENCLAW_BACKUP_DIR

3. OpenClaw에 첫 번째 백업을 생성하도록 요청: "지금 바로 설정을 백업해줘."

"Permission denied when creating backup archive"

백업 디렉토리에 쓰기 권한이 없습니다.

# 권한 수정
chmod 700 ~/openclaw-backups

# 또는 누락된 디렉토리 생성
mkdir -p ~/openclaw-backups && chmod 700 ~/openclaw-backups

"Backup archive is corrupted — restore failed"

아카이브가 저장 또는 전송 중에 손상되었습니다.

1. 아카이브 무결성 테스트:

tar -tzf ~/openclaw-backups/openclaw-2026-03-13_1045.tar.gz > /dev/null

2. 손상된 경우 보관 목록의 이전 백업을 시도하세요.
3. Git 동기화 백업의 경우 이전 커밋에 정상적인 아카이브가 있는지 확인: 백업 리포에서 git log --oneline 실행.