Install on 编程那些事儿

Node.js

Fri, 03 Apr 2026 12:29:05 +0800

OpenClaw requires Node 22.14 or newer. Node 24 is the default and recommended runtime for installs, CI, and release workflows. Node 22 remains supported via the active LTS line. The installer script will detect and install Node automatically — this page is for when you want to set up Node yourself and make sure everything is wired up correctly (versions, PATH, global installs).

OpenClaw 需要 Node 22.14 或更高版本。Node 24 是安装、持续集成（CI）和发布工作流的默认且推荐运行时。Node 22 仍通过长期支持（LTS）主线获得支持。安装脚本会自动检测并安装 Node —— 本页面适用于你想手动设置 Node 并确保所有配置（版本、环境变量 PATH、全局安装）均正确的情况。

Installer Internals

Fri, 03 Apr 2026 11:29:30 +0800

Installer Internals

OpenClaw ships three installer scripts, served from openclaw.ai.

OpenClaw 附带三个安装脚本，均从 openclaw.ai 提供。

Script	Platform	What it does
`install.sh`	macOS / Linux / WSL	Installs Node if needed, installs OpenClaw via npm (default) or git, and can run onboarding. 如有需要则安装 Node，通过 npm（默认）或 git 安装 OpenClaw，并可运行onboarding流程。
`install-cli.sh`	macOS / Linux / WSL	Installs Node + OpenClaw into a local prefix (`~/.openclaw`). No root required. 将 Node 与 OpenClaw 安装到本地前缀（`~/.openclaw`）。无需 root 权限。
`install.ps1`	Windows (PowerShell)	Installs Node if needed, installs OpenClaw via npm (default) or git, and can run onboarding. 如有需要则安装 Node，通过 npm（默认）或 git 安装 OpenClaw，并可运行onboarding流程。

Quick commands

1

curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash

1

curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash -s -- --help

1

curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install-cli.sh | bash

1

curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install-cli.sh | bash -s -- --help

1

iwr -useb https://openclaw.ai/install.ps1 | iex

1

& ([scriptblock]::Create((iwr -useb https://openclaw.ai/install.ps1))) -Tag beta -NoOnboard -DryRun

If install succeeds but openclaw is not found in a new terminal, see Node.js troubleshooting.

Migrating

Fri, 03 Apr 2026 11:12:24 +0800

Migration Guide 迁移指南

This guide moves an OpenClaw gateway to a new machine without redoing onboarding.

本指南可将 OpenClaw gateway 迁移到新机器，且无需重新完成 onboarding配置。

What Gets Migrated 需要迁移的内容

When you copy the state directory (~/.openclaw/ by default) and your workspace, you preserve:

Uninstall

Fri, 03 Apr 2026 09:40:49 +0800

Uninstall

Two paths:

两种方法：

Easy path if openclaw is still installed.
- 简易方法（前提是 openclaw 仍已安装）
Manual service removal if the CLI is gone but the service is still running.
- 手动移除服务，适用于 CLI 已消失但服务仍在运行的情况。

Easy path (CLI still installed)

Recommended: use the built-in uninstaller:

Updating

Fri, 03 Apr 2026 09:36:17 +0800

Updating

Keep OpenClaw up to date.

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.

最快的更新方式。它会检测你的安装类型（npm 或 git），获取最新版本，运行 openclaw doctor 并重启网关。

Install on 编程那些事儿

Node.js

Installer Internals

Installer Internals

Quick commands

Migrating

Migration Guide 迁移指南

What Gets Migrated 需要迁移的内容

Uninstall

Uninstall

Easy path (CLI still installed)

Updating

Updating

Recommended: openclaw update

Recommended: `openclaw update`