릴리스 채널

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

• stable: npm dist-tag latest. 대부분의 사용자에게 권장됩니다.
• beta: 최신 상태일 때 npm dist-tag beta를 사용합니다. beta가 없거나 최신 stable 릴리스보다 오래된 경우, 업데이트 흐름은 latest로 대체됩니다.
• dev: main의 이동하는 최신 헤드(git)입니다. npm dist-tag: dev(게시된 경우). main 브랜치는 실험과 활발한 개발을 위한 것입니다. 완료되지 않은 기능이나 호환성을 깨는 변경 사항이 포함될 수 있습니다. 프로덕션 Gateway에는 사용하지 마세요.

일반적으로 stable 빌드를 먼저 beta로 배포하고, 그곳에서 테스트한 다음, 검증된 빌드를 버전 번호 변경 없이 latest로 이동하는 명시적 승격 단계를 실행합니다. 유지관리자는 필요할 때 stable 릴리스를 latest에 직접 게시할 수도 있습니다. dist-tag는 npm 설치의 신뢰할 수 있는 기준입니다.

# 채널 전환

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

--channel은 선택 사항을 config(update.channel)에 저장하고 설치 방식을 맞춥니다.

• stable(패키지 설치): npm dist-tag latest를 통해 업데이트합니다.
• beta(패키지 설치): npm dist-tag beta를 우선 사용하지만, beta가 없거나 현재 stable 태그보다 오래된 경우 latest로 대체됩니다.
• stable(git 설치): 최신 stable git 태그를 체크아웃합니다.
• beta(git 설치): 최신 beta git 태그를 우선 사용하지만, beta가 없거나 오래된 경우 최신 stable git 태그로 대체됩니다.
• dev: git 체크아웃(기본값 ~/openclaw, OPENCLAW_GIT_DIR로 재정의 가능)을 보장하고, main으로 전환한 뒤 upstream에 리베이스하고, 빌드하고, 해당 체크아웃에서 전역 CLI를 설치합니다.

# 일회성 버전 또는 태그 지정

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

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

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

# GitHub main 브랜치에서 설치(npm tarball)
openclaw update --tag main

# 특정 npm 패키지 spec 설치
openclaw update --tag [email protected]

참고:

• --tag는 패키지(npm) 설치에만 적용됩니다. git 설치는 이를 무시합니다.
• 태그는 저장되지 않습니다. 다음 openclaw update는 평소처럼 구성된 채널을 사용합니다.
• 다운그레이드 보호: 대상 버전이 현재 버전보다 오래된 경우, OpenClaw가 확인을 요청합니다(--yes로 건너뛰기).
• --channel beta는 --tag beta와 다릅니다. 채널 흐름은 beta가 없거나 오래된 경우 stable/latest로 대체될 수 있지만, --tag beta는 해당 한 번의 실행에 대해 원시 beta dist-tag를 대상으로 합니다.

# 드라이런

변경하지 않고 openclaw update가 수행할 작업을 미리 확인하세요.

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과 채널

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

• dev는 git 체크아웃의 번들 Plugin을 우선 사용합니다.
• stable과 beta는 npm으로 설치된 Plugin 패키지를 복원합니다.
• npm으로 설치된 Plugin은 코어 업데이트가 완료된 후 업데이트됩니다.

# 현재 상태 확인

openclaw update status

활성 채널, 설치 종류(git 또는 패키지), 현재 버전, 그리고 소스(config, git 태그, git 브랜치 또는 기본값)를 표시합니다.

# 태그 지정 모범 사례

• git 체크아웃이 도달해야 하는 릴리스에 태그를 지정하세요(stable은 vYYYY.M.D, beta는 vYYYY.M.D-beta.N).
• 호환성을 위해 vYYYY.M.D.beta.N도 인식되지만, -beta.N을 권장합니다.
• 기존 vYYYY.M.D-<patch> 태그는 여전히 stable(비-beta)로 인식됩니다.
• 태그를 변경 불가능하게 유지하세요. 태그를 이동하거나 재사용하지 마세요.
• npm dist-tag는 npm 설치의 신뢰할 수 있는 기준으로 유지됩니다.
  • latest -> stable
  • beta -> 후보 빌드 또는 beta-first stable 빌드
  • dev -> main 스냅샷(선택 사항)

# macOS 앱 사용 가능 여부

Beta 및 dev 빌드는 macOS 앱 릴리스를 포함하지 않을 수 있습니다. 괜찮습니다.

• git 태그와 npm dist-tag는 계속 게시할 수 있습니다.
• 릴리스 노트 또는 변경 로그에 "이 beta에는 macOS 빌드 없음"이라고 명시하세요.

# 관련 항목

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