OpenClaw 안전하게 업데이트하기

새로운 기능을 써보고 싶은데 업데이트 버튼을 누르기가 망설여진 적 있으시죠? 공들여 설정한 환경이 꼬이거나, 갑자기 서비스가 멈출까 봐 걱정되는 건 모든 개발자의 공통된 고민이에요. OpenClaw는 이런 불안함을 덜어주기 위해 안전하고 체계적인 업데이트 프로세스를 제공합니다.

설치 방식이나 채널에 상관없이 명령어 하나로 환경을 최신 상태로 유지할 수 있습니다.

필요한 것

• npm 또는 pnpm으로 설치된 OpenClaw
• git checkout 환경 (dev 채널로 전환하거나 소스에서 업데이트할 경우)

빠른 시작

5분 안에 업데이트를 끝내는 가장 빠른 방법은 wizard를 사용하는 것입니다. 대화형 인터페이스를 통해 채널을 고르고, 업데이트 후 Gateway를 재시작할지 직접 선택할 수 있습니다.

openclaw update wizard

특정 채널로 바로 이동하고 싶다면 다음 명령어를 사용하세요.

# beta 채널로 업데이트
openclaw update --channel beta

# 업데이트 확인만 하기
openclaw update status

업데이트 후 서비스가 자동으로 재시작되는 것을 원치 않는다면 --no-restart 옵션을 추가하면 됩니다.

openclaw update --no-restart

문제 해결

업데이트 중에 문제가 생겼나요? 소스 코드(git)를 직접 사용하는 경우에 자주 발생하는 상황입니다.

• Clean Worktree 필요: git을 통해 업데이트할 때는 커밋되지 않은 변경 사항이 없어야 합니다. 작업 중인 내용을 미리 스테이징하거나 커밋해 주세요.
• 타임아웃 문제: 네트워크 환경에 따라 설치 시간이 길어질 수 있습니다. 기본값인 1200초가 부족하다면 시간을 늘려보세요.
• 버전 다운그레이드: 이전 버전으로 돌아갈 때는 기존 설정이 깨질 수 있어 확인 절차가 필요합니다. 터미널의 안내 메시지를 확인해 주세요.

# 타임아웃 시간을 2000초로 늘려서 실행
openclaw update --timeout 2000

더 궁금한 점이 있다면 AI Setup Assistant에게 물어보세요.

다음 단계

• openclaw doctor: 업데이트 전후로 시스템 상태 점검하기
• Development channels: stable, beta, dev 채널의 차이점 알아보기
• Updating: 패키지 매니저를 통한 업데이트 가이드
• CLI reference: 전체 명령어 목록 확인하기