2.2 安装 OpenClaw

本节介绍如何在你选择的环境中安装 OpenClaw。官方推荐使用一键安装脚本以获得最佳体验，也可通过 npm 等包管理器进行安装。

2.2.1 官方推荐：一键安装脚本 （CLI）

最简单快捷的安装方式是执行官方的一键安装脚本。该脚本会自动处理依赖并安装最新版 OpenClaw CLI。

macOS / Linux

在终端中运行以下命令：

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

Windows (PowerShell)

在 PowerShell 中运行以下命令：

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

2.2.2 替代方案：使用 npm 安装

如果你熟悉 Node 生态，或者需要在特定流程中进行精确版本控制，也可以直接使用 npm 或者 pnpm 进行全局安装。

# npm 全局安装
npm install -g openclaw@latest

# pnpm 全局安装
pnpm add -g openclaw@latest

建议：测试与生产环境不要长期依赖 latest。更稳妥的做法是固定到明确版本，并把版本号写进交付文档与回归清单。

npm install -g openclaw@<version>

2.2.3 验证安装结果

安装后建议立即做一次最小验证（确保命令可用且 PATH 正确）：

openclaw --version
openclaw --help

2.2.4 版本升级与治理

要升级到新版本，如果你使用的是一键脚本安装，可以重新运行脚本；如果使用的是包管理器，只需重新运行全局安装命令并指定 <version> 标签（或 @latest）即可。

npm install -g openclaw@<version>

升级策略的目标不是单纯用上新版本，而是确保升级可验证、可回滚：

• 先回归再升级：每次升级后，至少覆盖 health、status、渠道探针与模型探针。

• 出问题先回滚：如果新版本异常，直接全局安装上一稳定版本（例如 npm install -g openclaw@<旧版本号>），再做差异定位。