OpenClaw 복구 모드 가이드

OpenClaw 설정에 문제가 생겼을 때 복구 모드로 서비스를 빠르게 복원하세요

복구 모드 사용 방법

로그인한 뒤 상단 사용자 메뉴를 클릭하고 "My OpenClaw"를 선택해 인스턴스 관리 페이지로 이동합니다.

인스턴스 관리 페이지 상단의 "Rescue Mode" 탭을 클릭합니다. 복구 모드 안내와 "Load Configuration Backups" 버튼이 표시됩니다.

복구 모드는 백업 목록을 자동으로 조회하지 않으므로 버튼을 직접 클릭해야 합니다

OpenClaw는 최근 5개 설정 버전의 백업을 자동으로 보관합니다

"Load Configuration Backups" 버튼을 클릭합니다. 시스템이 OpenClaw 인스턴스에 연결해 사용 가능한 모든 백업 파일을 나열합니다. 보통 1~5개의 백업 버전이 표시됩니다.

"Current Config"로 표시된 첫 번째 항목이 현재 사용 중인 버전입니다

다른 버전은 최신 항목이 먼저 오도록 시간 역순으로 정렬됩니다

백업 목록을 살펴보며 각 버전의 수정 시간, OpenClaw 버전 번호, 파일 크기를 확인합니다. 복원하려는 버전을 찾으면 오른쪽의 "Select This Version" 버튼을 클릭합니다.

일반적으로 마지막으로 정상 작동했던 설정을 선택합니다

확실하지 않다면 최신 백업부터 시도하세요

버전을 선택하면 페이지 하단에 "Execute Rescue Restore" 버튼이 나타납니다. 클릭하면 현재 설정이 교체되고 Gateway가 재시작된다는 확인 대화상자가 표시됩니다(약 2분).

복원 작업은 현재 설정을 완전히 교체하며 되돌릴 수 없습니다

Gateway 재시작 중에는 진행 중인 모든 대화가 중단됩니다

복원 후 다시 연결하기 전에 약 2분 정도 기다려야 합니다

복원을 확인하면 시스템이 자동으로 설정 파일을 교체하고 Gateway 서비스를 재시작합니다. 페이지에는 설정 복원이 성공했다는 메시지와 2분 후 새로고침하라는 안내가 표시됩니다.

재시작 중에는 페이지를 닫거나 다른 작업을 하지 마세요

2분 후 페이지를 새로고침해 Gateway 상태를 확인하세요

여전히 접근할 수 없다면 더 이전 버전으로 복원해 보세요

Gateway 재시작이 완료되면 Control UI를 열고 기본 기능을 테스트합니다. 복원이 성공했다면 Web UI에 정상적으로 접근하고 채팅 기능을 사용할 수 있어야 합니다.

모델 설정이 예상한 상태로 복원되었는지 확인하세요

대화를 한 번 테스트해 API 호출이 정상 동작하는지 확인하세요

문제가 계속되면 더 이전 버전으로 복원해야 할 수 있습니다