Official reference documentation: https://docs.openclaw.ai/zh-CN/install/updating

OpenClaw is developing rapidly with frequent updates, regularly releasing new versions to introduce new features, improve performance, and fix known issues. To ensure you can enjoy the latest features and the best user experience, it is recommended to update OpenClaw regularly.

Pre-Update Preparation

Before updating, please be sure to confirm the following information and create backups:

• Configuration file: ~/.openclaw/openclaw.json
• Credentials: ~/.openclaw/credentials/
• Workspace data: ~/.openclaw/workspace

Recommended Update Method: Re-run Installer (In-Place Upgrade)

This is the simplest and preferred update path. The installer will automatically detect existing installation, perform an in-place upgrade, and run openclaw doctor for health check if needed.

curl -fsSL https://openclaw.ai/install.sh | bash

Note:

• If you don't want to run the new user guide wizard again, you can add the --no-onboard parameter.
• For global installation users, the script will automatically execute npm install -g openclaw@latest.

After the update installation is complete, it will automatically enter the guide interface for related configuration, or you can skip it.

◇  Tighten permissions on ~/.openclaw to 700?
│  Yes

◇  Enable systemd lingering for lckfb?
│  Yes

◇  Enable bash shell completion for openclaw?
│  Yes

◇  Restart gateway service now?
│  Yes

Global Installation Update (npm/pnpm)

If you installed globally via npm or pnpm, you can directly run one of the following commands:

# Using npm
npm i -g openclaw@latest

# Or using pnpm
pnpm add -g openclaw@latest

After the update is complete, be sure to run the following commands to check the status and restart the gateway:

openclaw doctor
openclaw gateway restart
openclaw health

AI Update Method

We can tell OpenClaw: "OpenClaw, help me update to the latest version". OpenClaw will automatically help us complete the update operation.

FAQ

use HTTPS or localhost secure context, or UI interface cannot be accessed or displays abnormally

Because the new version of OpenClaw has updated related settings, just reconfigure:

# 1. Set network access mode to LAN
openclaw config set gateway.bind lan

# 2. Set HTTP access downgrade to true, allow insecure HTTP access (if this parameter is not set, HTTP access is prohibited by default)
openclaw config set gateway.controlUi.allowInsecureAuth true
openclaw config set gateway.controlUi.dangerouslyDisableDeviceAuth true
openclaw config set gateway.controlUi.dangerouslyAllowHostHeaderOriginFallback true

# 3. Restart OpenClaw gateway to apply the configuration
openclaw gateway restart