OpenClaw Version Manager

Reproducible OpenClaw versions per project.

ocvm is an nvm-style CLI for installing OpenClaw, pinning project versions, switching quickly, and rolling back local environment metadata when an upgrade goes wrong.

Install GitHub

$ ocvm install stable
resolved openclaw@latest
verified: openclaw --version
activated: ~/.ocvm/versions/2026.3.28

$ ocvm pin 2026.3.28
wrote .openclaw-version

$ ocvm exec -- openclaw --version
OpenClaw 2026.3.28

Install

Install the current pinned release.

The installer downloads the v0.1.1 GitHub Release asset for your platform, verifies the checksum when one is available, and installs ocvm into your local bin directory.

View release Release guide

curl -fsSL \
  https://raw.githubusercontent.com/PerfectPan/ocvm/v0.1.1/install.sh | sh

Project pinning

Commit .openclaw-version and every shell in the repo resolves the same OpenClaw version before falling back to user defaults.

Stable and exact installs

Install stable, latest, nightly, or an exact version from npm today, with release manifests ready for GitHub Release assets.

Snapshot and rollback

Capture current default and session metadata before upgrades, then rollback that state without deleting installed versions.

Doctor checks

Inspect PATH, shims, defaults, project pins, and installed executables when a local OpenClaw environment behaves strangely.

Release verification

Staged installs validate openclaw --version, and release manifests can verify executable SHA-256 before activation.

Docker E2E

The npm OpenClaw install path is tested in Docker so verification does not mutate the host environment.

Daily flow

Install once, pin where it matters, verify before switching.

InstallUse npm or release manifests as the source of OpenClaw builds.
PinCommit `.openclaw-version` for each repo that needs stability.
RecoverSnapshot before upgrades and rollback metadata if needed.