Start Upgrade Guide

OpenClaw Upgrade Guide

Keep your OpenClaw installation up to date with the latest features, security patches, and performance improvements. This guide covers upgrading from any version to the latest stable or beta release.

Quick Upgrade

# Upgrade to latest stable
openclaw upgrade

# Upgrade to latest beta
openclaw upgrade --beta

# Upgrade to a specific version
openclaw upgrade --version 3.2.0

Before You Upgrade

1. Back up your configuration: openclaw config export > backup-config.json
2. Check the changelog: Review breaking changes at github.com/openclaw/openclaw/releases
3. Verify compatibility: Ensure your Node.js version meets the new requirements
4. Test in staging: If running in production, test the upgrade in a staging environment first

Rollback

If the upgrade causes issues, roll back to the previous version:

# Rollback to previous version
openclaw upgrade --rollback

# Install a specific older version
openclaw upgrade --version 3.1.5

Version Channels

• Stable: Production-ready releases, thoroughly tested. Updated monthly.
• Beta: Preview features with enhanced testing. Updated weekly.
• Nightly: Cutting-edge builds from the main branch. May contain bugs. Updated daily.