Skip to content
OpenClaw Docs

Updating

Updating

Section titled “Updating”

Keep OpenClaw up to date.

Section titled “Recommended: openclaw update”

The fastest way to update. It detects your install type (npm or git), fetches the latest version, runs openclaw doctor, and restarts the gateway.

Terminal window
openclaw update

To switch channels or target a specific version:

Terminal window
openclaw update --channel beta
openclaw update --tag main
openclaw update --dry-run   # preview without applying

See Development channels for channel semantics.

Alternative: re-run the installer

Section titled “Alternative: re-run the installer”
Terminal window
curl -fsSL https://openclaw.ai/install.sh | bash

Add --no-onboard to skip onboarding. For source installs, pass --install-method git --no-onboard.

Alternative: manual npm or pnpm

Section titled “Alternative: manual npm or pnpm”
Terminal window
npm i -g openclaw@latest
Terminal window
pnpm add -g openclaw@latest

Auto-updater

Section titled “Auto-updater”

The auto-updater is off by default. Enable it in ~/.openclaw/openclaw.json:

{
  update: {
    channel: "stable",
    auto: {
      enabled: true,
      stableDelayHours: 6,
      stableJitterHours: 12,
      betaCheckIntervalHours: 1,
    },
  },
}
ChannelBehavior
stableWaits stableDelayHours, then applies with deterministic jitter across stableJitterHours (spread rollout).
betaChecks every betaCheckIntervalHours (default: hourly) and applies immediately.
devNo automatic apply. Use openclaw update manually.

The gateway also logs an update hint on startup (disable with update.checkOnStart: false).

After updating

Section titled “After updating”

    Rollback

    Section titled “Rollback”

    Pin a version (npm)

    Section titled “Pin a version (npm)”
    Terminal window
    npm i -g openclaw@<version>
    openclaw doctor
    openclaw gateway restart

    Tip: npm view openclaw version shows the current published version.

    Pin a commit (source)

    Section titled “Pin a commit (source)”
    Terminal window
    git fetch origin
    git checkout "$(git rev-list -n 1 --before=\"2026-01-01\" origin/main)"
    pnpm install && pnpm build
    openclaw gateway restart

    To return to latest: git checkout main && git pull.

    If you are stuck

    Section titled “If you are stuck”
    Section titled “Related”