릴리스 채널

OpenClaw은 네 가지 업데이트 채널을 제공합니다.

• 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에서는 실행하지 마세요.

안정 빌드는 일반적으로 먼저 beta로 출시되어 검증된 후, 버전 변경 없이 latest로 승격됩니다. 유지관리자가 latest에 직접 게시할 수도 있습니다. npm 설치에서는 dist-tag가 신뢰할 수 있는 기준입니다.

채널 전환

openclaw update --channel stableopenclaw update --channel extended-stableopenclaw update --channel betaopenclaw update --channel dev

--channel은 선택 사항을 구성의 update.channel에 영구 저장하고 두 설치 경로 모두를 제어합니다.

dev git 설치의 기본 체크아웃 위치는 ~/openclaw이며(OPENCLAW_HOME이 설정된 경우 $OPENCLAW_HOME/openclaw), OPENCLAW_GIT_DIR로 재정의할 수 있습니다.

일회성 버전 또는 태그 지정

영구 저장된 채널을 변경하지 않고 단일 업데이트에서 특정 dist-tag, 버전 또는 패키지 사양을 대상으로 지정하려면 --tag를 사용하세요.

# 특정 버전 설치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가 수행할 작업을 미리 확인합니다.

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

시험 실행에서는 유효한 채널, 대상 버전, 예정된 작업 및 다운그레이드 확인이 필요한지 여부를 보고합니다.

Plugin과 채널

openclaw update로 채널을 전환하면 Plugin 소스도 동기화됩니다.

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

현재 상태 확인

openclaw update status

활성 채널(결정 출처: 구성, git 태그, git 브랜치, 설치된 버전 또는 기본값), 설치 유형(git 또는 패키지), 현재 버전 및 업데이트 가능 여부를 표시합니다.

태그 지정 모범 사례

• 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 앱 제공 여부

베타 및 dev 빌드에는 macOS 앱 릴리스가 포함되지 않을 수 있습니다. 이는 정상입니다.

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

관련 문서

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