릴리스 채널

• stable: npm dist-tag latest. 대부분의 사용자에게 권장됩니다.
• extended-stable: npm dist-tag extended-stable. 새롭게 추가된 후행 지원 월 패키지 채널입니다. 패키지 전용이며, 포그라운드에서만 설치할 수 있습니다. update.checkOnStart가 활성화되어 있으면 저장된 선택 항목에 읽기 전용 업데이트 안내가 표시되지만, 자동으로 적용되지는 않습니다.
• beta: npm dist-tag beta. beta가 없거나 현재 안정 릴리스보다 오래된 경우 latest로 대체됩니다.
• dev: main의 이동식 최신 헤드(git)입니다. 게시된 경우 npm dist-tag는 dev입니다. main은 실험과 활발한 개발을 위한 것으로, 불완전한 기능이나 호환성을 깨뜨리는 변경 사항이 포함될 수 있습니다. 프로덕션 Gateway에서는 실행하지 마세요.

​

채널 전환

openclaw update --channel stable
openclaw update --channel extended-stable
openclaw update --channel beta
openclaw update --channel dev

​

일회성 버전 또는 태그 지정

# 특정 버전 설치
openclaw update --tag 2026.4.1-beta.1

# beta dist-tag에서 설치(일회성이며 영구 저장되지 않음)
openclaw update --tag beta

# 이동하는 GitHub main 체크아웃으로 전환(영구적)
openclaw update --channel dev

# 특정 npm 패키지 사양 설치
openclaw update --tag openclaw@2026.4.1-beta.1

# 채널을 영구 저장하지 않고 GitHub main에서 한 번 설치
openclaw update --tag main

• --tag는 패키지(npm) 설치에만 적용되며, git 설치에서는 무시됩니다.
• 태그는 영구 저장되지 않습니다. 다음 openclaw update는 구성된 채널을 사용합니다.
• --tag main은 해당 한 번의 실행에 대해 npm 호환 사양 github:openclaw/openclaw#main으로 매핑됩니다. 계속 이동하는 main 설치를 영구적으로 사용하려면 openclaw update --channel dev를 사용하거나(패키지 설치가 git 체크아웃으로 전환됨), 설치 프로그램의 git 방식으로 다시 설치하세요. curl -fsSL https://openclaw.ai/install.sh | bash -s -- --install-method git --version main. npm 설치 경로는 GitHub/git 소스 대상을 완전히 거부하고 대신 git 방식을 안내합니다.
• 다운그레이드 보호: 대상 버전이 현재 버전보다 오래된 경우 OpenClaw이 확인을 요청합니다(--yes로 생략 가능).
• extended-stable은 항상 검증된 정확한 패키지 대상을 사용합니다. 이는 --tag extended-stable의 일회성 별칭이 아니며, --tag는 유효한 extended-stable 채널과 함께 사용할 수 없습니다.
• --channel beta는 --tag beta와 다릅니다. 채널 흐름은 beta가 없거나 더 오래된 경우 stable/latest로 대체할 수 있지만, --tag beta는 항상 해당 한 번의 실행에서 원시 beta dist-tag를 대상으로 합니다.

​

시험 실행

openclaw update --dry-run
openclaw update --channel beta --dry-run
openclaw update --tag 2026.4.1-beta.1 --dry-run
openclaw update --dry-run --json

​

Plugin과 채널

• dev는 번들 대응 항목이 있는 설치된 Plugin을 해당 번들(git 체크아웃) 소스로 다시 전환합니다.
• stable과 beta는 npm 또는 ClawHub에서 설치된 Plugin 패키지를 복원합니다.
• extended-stable은 기본값 또는 latest 의도로 지정된 적격 공식 npm Plugin을 정확히 설치된 코어 버전으로 확인합니다. 런타임에 Plugin @extended-stable 태그를 조회하지 않습니다.
• npm으로 설치된 Plugin은 코어 업데이트가 완료된 후 업데이트됩니다.

​

현재 상태 확인

openclaw update status

​

태그 지정 모범 사례

• git 체크아웃의 도착점으로 사용할 릴리스에 태그를 지정하세요. 안정 버전은 vYYYY.M.PATCH, 베타는 vYYYY.M.PATCH-beta.N입니다. -alpha.N, -rc.N, -next.N과 같은 명명된 사전 릴리스 접미사는 안정 또는 베타 대상이 아닙니다.
• vYYYY.M.PATCH-1 및 v1.0.1-1과 같은 레거시 숫자형 안정 태그도 호환성을 위해 안정 git 태그로 계속 인식됩니다.
• vYYYY.M.PATCH.beta.N(점으로 구분)도 호환성을 위해 인식되지만, -beta.N을 사용하는 것이 좋습니다.
• 태그는 변경할 수 없도록 유지하세요. 태그를 이동하거나 재사용하지 마세요.
• npm 설치에서는 npm dist-tag가 계속 신뢰할 수 있는 기준입니다.
  • latest -> stable
  • extended-stable -> 후행 지원 월 패키지 릴리스
  • beta -> 후보 빌드 또는 베타 우선 안정 빌드
  • dev -> main 스냅샷(선택 사항)

​

macOS 앱 제공 여부

• git 태그와 npm dist-tag는 각각 독립적으로 게시할 수 있습니다.
• 릴리스 노트 또는 변경 로그에 “이 베타에는 macOS 빌드가 없음”을 명시하세요.

​

관련 문서

• 업데이트
• 설치 프로그램 내부 구조