Development 채널

마지막 업데이트: 2026-01-21

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

  • stable: npm dist-tag latest.
  • beta: npm dist-tag beta (테스트 중인 빌드).
  • dev: main의 이동 헤드 (git). npm dist-tag: dev (게시될 때).

우리는 beta에 빌드를 제공하고 테스트한 다음 검증된 빌드를 latest로 승격합니다 버전 번호를 변경하지 않고 — dist-tag가 npm 설치의 신뢰할 수 있는 소스입니다.

채널 전환

Git 체크아웃:

openclaw update --channel stable
openclaw update --channel beta
openclaw update --channel dev
  • stable/beta는 최신 일치 태그를 체크아웃합니다(종종 동일한 태그).
  • devmain으로 전환하고 업스트림에서 rebase합니다.

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를 병렬로 원하면 두 개의 클론을 유지하고 Gateway를 stable 클론으로 지정하세요.

Plugin 및 채널

openclaw update로 채널을 전환하면 OpenClaw도 plugin 소스를 동기화합니다:

  • dev는 git 체크아웃의 번들 plugin을 선호합니다.
  • stablebeta는 npm 설치된 plugin 패키지를 복원합니다.

태그 지정 모범 사례

  • git 체크아웃이 도달하기를 원하는 릴리스에 태그를 지정하세요(vYYYY.M.D 또는 vYYYY.M.D-<patch>).
  • 태그를 변경 불가능하게 유지: 태그를 이동하거나 재사용하지 마세요.
  • npm dist-tag는 npm 설치의 신뢰할 수 있는 소스로 유지됩니다:
    • latest → stable
    • beta → 후보 빌드
    • dev → main 스냅샷 (선택 사항)

macOS 앱 가용성

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

  • git 태그와 npm dist-tag는 여전히 게시될 수 있습니다.
  • 릴리스 노트 또는 변경 로그에서 "이 beta에 대한 macOS 빌드 없음"을 명시하세요.