개발 채널
최종 업데이트: 2026-01-21
OpenClaw는 세 가지 업데이트 채널을 제공합니다:
- stable: npm dist-tag
latest. - beta: npm dist-tag
beta(테스트 중인 빌드). - dev:
main의 최신 HEAD (git). npm dist-tag:dev(퍼블리시된 경우).
빌드를 beta에 배포하고, 테스트를 거친 뒤, 검증된 빌드를 latest로 승격합니다. 버전 번호 변경 없이 dist-tag가 npm 설치의 기준이 됩니다.
채널 전환
Git 체크아웃:
openclaw update --channel stable
openclaw update --channel beta
openclaw update --channel devstable/beta는 최신 일치 태그를 체크아웃합니다(동일한 태그인 경우가 많습니다).dev는main으로 전환하고 업스트림에 리베이스합니다.
npm/pnpm 전역 설치:
openclaw update --channel stable
openclaw update --channel beta
openclaw update --channel dev해당하는 npm dist-tag(latest, beta, dev)를 통해 업데이트합니다.
--channel로 명시적으로 채널을 전환하면 OpenClaw가 설치 방법도 함께 맞춥니다:
dev는 git 체크아웃을 보장하고(기본값~/openclaw,OPENCLAW_GIT_DIR로 변경 가능), 업데이트 후 해당 체크아웃에서 전역 CLI를 설치합니다.stable/beta는 일치하는 dist-tag로 npm에서 설치합니다.
팁: stable과 dev를 동시에 사용하고 싶다면, 클론을 두 개 유지하고 게이트웨이를 stable 쪽으로 연결하세요.
플러그인과 채널
openclaw update로 채널을 전환하면 OpenClaw가 플러그인 소스도 동기화합니다:
dev는 git 체크아웃의 번들 플러그인을 우선 사용합니다.stable과beta는 npm으로 설치된 플러그인 패키지를 복원합니다.
태깅 모범 사례
- 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→ stablebeta→ 후보 빌드dev→ main 스냅샷 (선택사항)
macOS 앱 가용성
Beta 및 dev 빌드에는 macOS 앱 릴리스가 포함되지 않을 수 있습니다. 괜찮습니다:
- git 태그와 npm dist-tag는 여전히 퍼블리시할 수 있습니다.
- 릴리스 노트나 변경 로그에 “이 beta에는 macOS 빌드 없음”을 명시하세요.