메인 콘텐츠로 건너뛰기

​
Development channels

최종 업데이트: 2026-01-21 OpenClaw는 세 가지 업데이트 채널을 제공합니다.
  • stable: npm dist-tag latest
  • beta: npm dist-tag beta (테스트 중인 빌드)
  • dev: main의 이동하는 헤드(git). 게시될 때는 npm dist-tag dev
새 빌드는 먼저 beta로 배포해 검증한 뒤, 버전 번호를 바꾸지 않고 latest로 승격합니다. npm 설치에서는 dist-tag가 기준입니다.

​
Switching channels

Git checkout: 
openclaw update --channel stable
openclaw update --channel beta
openclaw update --channel dev
  • stable/beta는 조건에 맞는 최신 태그를 체크아웃합니다. 두 채널이 같은 태그를 가리키는 경우도 많습니다.
  • dev는 main으로 전환한 뒤 upstream 기준으로 rebase합니다.
npm/pnpm global install: 
openclaw update --channel stable
openclaw update --channel beta
openclaw update --channel dev
해당 npm dist-tag(latest, beta, dev)를 통해 패키지를 업데이트합니다. --channel로 명시적으로 채널을 전환하면, OpenClaw는 설치 방식도 함께 맞춥니다.
  • dev는 git checkout(기본값 ~/openclaw, OPENCLAW_GIT_DIR로 변경 가능)을 준비하고 업데이트한 뒤, 그 checkout에서 전역 CLI를 다시 설치합니다.
  • stable/beta는 해당 dist-tag로 npm에서 설치합니다.
Tip: stable과 dev를 병행해 쓰고 싶다면 clone을 두 개 유지하고, gateway는 stable 쪽을 보도록 두세요.

​
Plugins and channels

openclaw update로 채널을 전환하면 플러그인 소스도 함께 동기화됩니다.
  • dev는 git checkout에 포함된 bundled plugins를 우선 사용합니다.
  • stable과 beta는 npm으로 설치된 plugin packages를 복원합니다.

​
Tagging best practices

  • git checkout이 도달해야 하는 릴리스에는 태그를 붙이세요. 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-tags는 npm 설치의 기준입니다.
    • latest → stable
    • beta → candidate build
    • dev → main snapshot (선택 사항)

​
macOS app availability

beta와 dev 빌드에는 macOS 앱 릴리스가 없을 수도 있습니다. 이는 정상입니다.
  • git tag와 npm dist-tag는 그대로 게시할 수 있습니다.
  • macOS 빌드가 빠졌다면 릴리스 노트나 changelog에 “no macOS build for this beta”라고 명시하세요.