OpenClaw 업데이트 채널 관리: Stable, Beta, Dev 전환 가이드

새로운 기능을 누구보다 먼저 써보고 싶지만, 운영 중인 시스템이 망가질까 봐 걱정된 적 많으시죠? 개발을 하다 보면 안정적인 버전과 최신 기능을 담은 실험적인 버전 사이에서 고민하게 되는 순간이 꼭 오기 마련이에요.

OpenClaw는 사용자의 환경에 맞춰 선택할 수 있는 세 가지 업데이트 채널을 제공해요.

• stable: npm dist-tag latest를 사용해요. 대부분의 사용자에게 권장하는 채널이에요.
• beta: npm dist-tag beta를 사용하며, 현재 테스트 중인 빌드예요.
• dev: main 브랜치(git)의 최신 상태를 따라가요. npm dist-tag는 배포 시 dev를 사용해요. main 브랜치는 실험과 활발한 개발이 이루어지는 곳이라 미완성 기능이나 breaking changes가 포함될 수 있어요. 프로덕션 Gateway에는 사용하지 마세요.

우리는 beta에 빌드를 배포하고 테스트를 거친 뒤, 검증된 빌드를 버전 번호 변경 없이 latest로 승격시켜요. npm 설치 시에는 dist-tag가 최종적인 기준이 된답니다.

채널 전환하기

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

--channel 옵션을 사용하면 선택한 채널이 설정(update.channel)에 저장되고, 그에 맞춰 설치 방식이 정렬돼요.

• stable/beta (package 설치): 일치하는 npm dist-tag를 통해 업데이트해요.
• stable/beta (git 설치): 일치하는 최신 git tag를 체크아웃해요.
• dev: git 체크아웃을 보장하고(기본값 ~/openclaw, OPENCLAW_GIT_DIR로 변경 가능), main 브랜치로 전환한 뒤 upstream을 기반으로 rebase하고 빌드해요. 그 다음 해당 체크아웃에서 글로벌 CLI를 설치해요.

팁을 하나 드리자면, stable과 dev를 동시에 사용하고 싶다면 두 개의 클론을 유지하면서 Gateway가 stable 버전을 가리키도록 설정하면 돼요.

일회성 버전 또는 태그 지정

설정된 채널을 바꾸지 않고 한 번만 특정 dist-tag, 버전 또는 package spec을 대상으로 업데이트하고 싶다면 --tag를 사용하세요.

# Install a specific version
openclaw update --tag 2026.4.1-beta.1

# Install from the beta dist-tag (one-off, does not persist)
openclaw update --tag beta

# Install from GitHub main branch (npm tarball)
openclaw update --tag main

# Install a specific npm package spec
openclaw update --tag openclaw@2026.4.1-beta.1

참고할 점:

• --tag는 package (npm) 설치에만 적용돼요. Git 설치 시에는 무시돼요.
• 태그는 저장되지 않아요. 다음번에 openclaw update를 실행하면 평소처럼 설정된 채널을 사용해요.
• 다운그레이드 보호: 대상 버전이 현재 버전보다 낮으면 OpenClaw가 확인 메시지를 띄워요. --yes로 생략할 수 있어요.

드라이 런

변경 사항을 실제로 적용하기 전에 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

드라이 런을 실행하면 적용될 채널, 대상 버전, 계획된 작업, 그리고 다운그레이드 확인이 필요한지 여부를 보여줘요.

플러그인과 채널

openclaw update로 채널을 전환하면 OpenClaw가 플러그인 소스도 함께 동기화해요.

• dev 채널은 git 체크아웃에 포함된 번들 플러그인을 선호해요.
• stable과 beta 채널은 npm으로 설치된 플러그인 패키지를 복구해요.
• npm으로 설치된 플러그인은 코어 업데이트가 완료된 후에 업데이트돼요.

현재 상태 확인하기

openclaw update status

현재 활성화된 채널, 설치 유형(git 또는 package), 현재 버전, 그리고 소스(config, git tag, git branch 또는 기본값)를 확인할 수 있어요.

태그 지정 권장 사항

• git 체크아웃이 타겟팅할 릴리스에 태그를 지정하세요 (stable은 vYYYY.M.D, beta는 vYYYY.M.D-beta.N).
• vYYYY.M.D.beta.N 형식도 호환성을 위해 인식하지만, -beta.N 형식을 더 권장해요.
• 예전에 사용하던 vYYYY.M.D-<patch> 태그도 여전히 stable(비베타)로 인식돼요.
• 태그의 불변성을 유지하세요. 한 번 만든 태그를 옮기거나 재사용하면 안 돼요.
• npm 설치 시에는 npm dist-tag가 여전히 기준이 돼요.
  • latest -> stable
  • beta -> 후보 빌드
  • dev -> main 스냅샷 (선택 사항)

macOS 앱 가용성

beta 및 dev 빌드에는 macOS 앱 릴리스가 포함되지 않을 수 있어요. 하지만 걱정하지 마세요.

• git tag와 npm dist-tag는 여전히 배포될 수 있어요.
• 릴리스 노트나 변경 로그에 “이번 beta 버전에는 macOS 빌드가 없음”이라고 안내해 주세요.

AI Setup Assistant