Release channels

기준일: 2026-07-26
공식 기준: Release channels

Release channels 문서는 OpenClaw 공식 문서(install/development-channels)를 한국어로 정리한 가이드입니다. Stable, extended-stable, beta, and dev channels: semantics, switching, pinning, and tagging 명령·설정 키·코드 예시는 공식 문서를 그대로 보존하며, 해석과 절차 안내는 한국어로 제공합니다. 최종 동작은 설치된 CLI 버전과 공식 원문을 확인하세요.

핵심 요약

Stable, extended-stable, beta, and dev channels: semantics, switching, pinning, and tagging

한국어 가이드 범위: install/development-channels 경로의 설정·명령·제약·예시를 학습용으로 재구성합니다.

문서 구성

공식 문서의 주요 섹션은 다음과 같습니다.

• Switching channels
• One-off version or tag targeting
• Install a specific version
• Install from the beta dist-tag (one-off, does not persist)
• Switch to the moving GitHub main checkout (persistent)
• Install a specific npm package spec
• Install from GitHub main once without persisting the channel
• Dry run
• Plugins and channels
• Checking current status
• Tagging best practices
• macOS app availability
• 관련 문서

상세 내용

본문

supported-month package channel. It is package-only, and installation is foreground-only. A stored selection receives read-only update hints when update.checkOnStart is enabled, but never applies automatically.

위 내용은 공식 문서의 해당 섹션 요지입니다. 세부 플래그·기본값은 원문과 --help를 확인하세요.

주요 항목:

• stable: npm dist-tag latest. Recommended for most users.
• extended-stable: npm dist-tag extended-stable. A net-new, trailing
• beta: npm dist-tag beta. Falls back to latest when beta is missing
• dev: moving head of main (git). npm dist-tag dev when published. main

Switching channels

--channel persists the choice to update.channel in config and drives both install paths:

위 내용은 공식 문서의 해당 섹션 요지입니다. 세부 플래그·기본값은 원문과 --help를 확인하세요.

Channel	npm/package installs	git installs
stable	dist-tag latest	latest stable git tag (excludes -alpha.N, -beta.N, -rc.N, -dev.N, -next.N, -preview.N, -canary.N, -nightly.N, and other named prerelease suffixes)
extended-stable	resolves the public npm extended-stable selector, verifies the exact selected package, and installs that exact version. Fails closed with no fallback to latest, beta, or dev.	unsupported: OpenClaw leaves the checkout unchanged and asks you to use a package installation
beta	dist-tag beta, falling back to latest when beta is missing or older	latest beta git tag, falling back to the latest stable git tag when beta is missing or older
dev	dist-tag dev (rare; most dev users run git installs)	fetches, rebases the checkout on the upstream main branch, builds, and reinstalls the global CLI

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

One-off version or tag targeting

Use --tag to target a specific dist-tag, version, or package spec for a single update without changing the persisted channel:

위 내용은 공식 문서의 해당 섹션 요지입니다. 세부 플래그·기본값은 원문과 --help를 확인하세요.

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

Switch to the moving GitHub main checkout (persistent)

openclaw update --channel dev

Install a specific npm package spec

openclaw update --tag openclaw@2026.4.1-beta.1

위 내용은 공식 문서의 해당 섹션 요지입니다. 세부 플래그·기본값은 원문과 --help를 확인하세요.

Install from GitHub main once without persisting the channel

for that one run. For a persistent moving main install, use openclaw update --channel dev (package installs switch to a git checkout) or reinstall with the installer's git method: curl -fsSL https://openclaw.ai/install.sh | bash -s -- --install-method git --version main. The npm install path rejects GitHub/git source targets outright and points you at the git method instead.

위 내용은 공식 문서의 해당 섹션 요지입니다. 세부 플래그·기본값은 원문과 --help를 확인하세요.

주요 항목:

• --tag applies to package (npm) installs only; git installs ignore it.
• The tag is not persisted; the next openclaw update uses the configured
• --tag main maps to the npm-compatible spec github:openclaw/openclaw#main
• Downgrade protection: if the target version is older than the current
• Extended-stable always uses its verified exact package target. It is not a
• --channel beta differs from --tag beta: the channel flow can fall back

Dry run

Preview what openclaw update would do without making changes:

위 내용은 공식 문서의 해당 섹션 요지입니다. 세부 플래그·기본값은 원문과 --help를 확인하세요.

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

Plugins and channels

Switching channels with openclaw update also syncs plugin sources:

위 내용은 공식 문서의 해당 섹션 요지입니다. 세부 플래그·기본값은 원문과 --help를 확인하세요.

주요 항목:

• dev switches installed plugins that have a bundled counterpart back to
• stable and beta restore npm-installed or ClawHub-installed plugin
• extended-stable resolves eligible official npm plugins with bare/default
• npm-installed plugins are updated after the core update completes.

Checking current status

Shows the active channel (with the source that decided it: config, git tag, git branch, installed version, or default), install kind (git or package), current version, and update availability.

위 내용은 공식 문서의 해당 섹션 요지입니다. 세부 플래그·기본값은 원문과 --help를 확인하세요.

openclaw update status

Tagging best practices

vYYYY.M.PATCH-beta.N for beta. Named prerelease suffixes such as -alpha.N, -rc.N, and -next.N are not stable or beta targets.

위 내용은 공식 문서의 해당 섹션 요지입니다. 세부 플래그·기본값은 원문과 --help를 확인하세요.

주요 항목:

• Tag releases you want git checkouts to land on: vYYYY.M.PATCH for stable,
• Legacy numeric stable tags such as vYYYY.M.PATCH-1 and v1.0.1-1 are still
• vYYYY.M.PATCH.beta.N (dot-separated) is also recognized for compatibility;
• Keep tags immutable: never move or reuse a tag.
• npm dist-tags remain the source of truth for npm installs:
• latest -> stable
• extended-stable -> trailing supported-month package release
• beta -> candidate build or beta-first stable build
• dev -> main snapshot (optional)

macOS app availability

Beta and dev builds may not include a macOS app release. That is fine:

위 내용은 공식 문서의 해당 섹션 요지입니다. 세부 플래그·기본값은 원문과 --help를 확인하세요.

주요 항목:

• The git tag and npm dist-tag can still publish on their own.
• Call out "no macOS build for this beta" in release notes or changelog.

관련 문서

주요 항목:

• Updating
• Installer internals

실습 체크리스트

1. 공식 문서와 로컬 버전을 대조합니다: https://docs.openclaw.ai/install/development-channels
2. 관련 CLI는 openclaw --help 및 하위 명령 --help로 옵션을 확인합니다.
3. 설정 변경 시 openclaw config / openclaw doctor로 유효성을 검사합니다.
4. Gateway·채널·플러그인 변경 후에는 필요 시 Gateway를 재시작합니다.

자주 쓰는 명령·설정 예시

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

# 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

# Switch to the moving GitHub main checkout (persistent)
openclaw update --channel dev

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

# Install from GitHub main once without persisting the channel
openclaw update --tag main

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 status

관련 링크

• 공식 원문: install/development-channels
• OpenClaw 문서 홈

이 가이드는 공식 문서를 한국어 학습용으로 재구성한 것입니다. 옵션 기본값·플래그 이름은 설치 버전에 따라 달라질 수 있습니다.