openclaw update

OpenClaw를 안전하게 업데이트하고 안정/베타/개발 채널 간에 전환하세요.

npm/pnpm(전역 설치, git 메타데이터 없음)을 통해 설치한 경우 업데이트의 패키지 관리자 흐름을 통해 업데이트가 발생합니다.

사용법

openclaw update
openclaw update status
openclaw update wizard
openclaw update --channel beta
openclaw update --channel dev
openclaw update --tag beta
openclaw update --no-restart
openclaw update --json
openclaw --update

옵션

• --no-restart: 업데이트 성공 후 게이트웨이 서비스 재시작을 건너뜁니다.
• --channel <stable|beta|dev>: 업데이트 채널을 설정합니다(git + npm; 구성에 유지됨).
• --tag <dist-tag|version>: 이 업데이트에 대해서만 npm dist-tag 또는 버전을 재정의합니다.
• --json: 기계가 읽을 수 있는 UpdateRunResult JSON을 인쇄합니다.
• --timeout <seconds>: 단계당 시간 초과(기본값은 1200초).

참고: 이전 버전에서는 구성이 중단될 수 있으므로 다운그레이드하려면 확인이 필요합니다.

update status

활성 업데이트 채널 + git tag/branch/SHA(소스 체크아웃용) 및 업데이트 가용성을 표시합니다.

openclaw update status
openclaw update status --json
openclaw update status --timeout 10

옵션:

• --json: 기계가 읽을 수 있는 상태 JSON을 인쇄합니다.
• --timeout <seconds>: 검사 시간 초과(기본값은 3초)

update wizard

업데이트 채널을 선택하고 게이트웨이를 다시 시작할지 여부를 확인하는 대화형 흐름 업데이트 후(기본값은 다시 시작) Git 체크아웃 없이 dev를 선택하면 만들겠다고 제안합니다.

기능

명시적으로 채널을 전환하면(--channel ...) OpenClaw는 설치 방법 정렬:

• dev → git 체크아웃을 보장합니다(기본값: ~/openclaw, OPENCLAW_GIT_DIR로 재정의), 이를 업데이트하고 해당 체크아웃에서 전역 CLI를 설치합니다.
• stable/beta → 일치하는 dist-tag를 사용하여 npm에서 설치합니다.

Git 체크아웃 흐름

채널:

• stable: 최신 비베타 태그를 확인한 다음 빌드 + 닥터.
• beta: 최신 -beta 태그를 확인한 후 빌드 + 닥터.
• dev: main를 체크아웃한 다음 가져오기 + 리베이스합니다.

상위 수준:

1. 깨끗한 작업 트리가 필요합니다(커밋되지 않은 변경 사항 없음).
2. 선택한 채널(태그 또는 브랜치)로 전환합니다.
3. 업스트림을 가져옵니다(개발자에게만 해당).
4. 개발자 전용: 임시 작업 트리에서 프리플라이트 Lint + TypeScript 빌드; 팁이 실패하면 최대 10개의 커밋을 다시 확인하여 최신 클린 빌드를 찾습니다.
5. 선택한 커밋을 기준으로 리베이스합니다(개발자만 해당).
6. deps를 설치합니다(pnpm 선호, npm fallback).
7. 컨트롤 UI를 빌드하고 빌드합니다.
8. 최종 "안전한 업데이트" 확인으로 openclaw doctor를 실행합니다.
9. 플러그인을 활성 채널에 동기화하고(개발자는 번들 확장을 사용하고 stable/beta는 npm을 사용함) npm이 설치된 플러그인을 업데이트합니다.

--update 속기

openclaw --update는 openclaw update로 다시 작성됩니다(셸 및 실행 프로그램 스크립트에 유용함).

참고하세요

• openclaw doctor (git 체크아웃 시 업데이트를 먼저 실행하도록 제안)
• 개발 채널
• 업데이트 중
• CLI 참조