安装 ​

已经完成了快速入门？那你已经准备好了 — 本页面提供其他安装方式、平台特定说明和维护信息。

系统要求 ​

• Node 22+（安装脚本会在缺失时自动安装）
• macOS、Linux 或 Windows
• 仅从源码构建时需要 pnpm

注意： 在 Windows 上，我们强烈建议在 WSL2 下运行 OpenClaw。

安装方式 ​

💡 提示： 安装脚本是安装 OpenClaw 的推荐方式。它可以一步完成 Node 检测、安装和初始配置。

安装脚本 ​

下载 CLI，通过 npm 全局安装，并启动初始配置向导。

macOS / Linux / WSL2：

curl -fsSL https://clawd.org.cn/install.sh | bash

Windows (PowerShell)：

iwr -useb https://clawd.org.cn/install.ps1 | iex

就这样 — 脚本会自动处理 Node 检测、安装和初始配置。

如果想跳过初始配置，只安装二进制文件：

macOS / Linux / WSL2：

curl -fsSL https://clawd.org.cn/install.sh | bash -s -- --no-onboard

Windows (PowerShell)：

& ([scriptblock]::Create((iwr -useb https://clawd.org.cn/install.ps1))) -NoOnboard

查看所有参数、环境变量和 CI/自动化选项，请参阅安装脚本详解。

npm / pnpm ​

如果你已经有 Node 22+，并且想自行管理安装：

npm ​

npm install -g openclaw-cn@latest
openclaw-cn onboard --install-daemon

SHARP_IGNORE_GLOBAL_LIBVIPS=1 npm install -g openclaw-cn@latest

pnpm ​

pnpm add -g openclaw-cn@latest
pnpm approve-builds -g        # 批准 openclaw-cn、node-llama-cpp、sharp 等
openclaw-cn onboard --install-daemon

注意： pnpm 要求显式批准包含构建脚本的包。首次安装显示"Ignored build scripts"警告后，运行 pnpm approve-builds -g 并选择列出的包。

从源码构建 ​

适用于贡献者或想从本地代码运行的用户。

1. 克隆并构建

克隆 OpenClaw 仓库 并构建：

git clone https://github.com/jiulingyun/openclaw-cn.git
cd openclaw
pnpm install
pnpm ui:build
pnpm build

2. 链接 CLI

将 openclaw-cn 命令设为全局可用：

pnpm link --global

也可以跳过链接，在仓库内通过 pnpm openclaw-cn ... 运行命令。

3. 运行初始配置

openclaw-cn onboard --install-daemon

更深入的开发工作流，请参阅开发设置。

其他安装方式 ​

• Docker — 容器化或无头部署。
• Nix — 通过 Nix 声明式安装。
• Ansible — 自动化批量部署。
• Bun — 通过 Bun 运行时使用 CLI。

安装后 ​

验证一切正常运行：

openclaw-cn doctor         # 检查配置问题
openclaw-cn status         # 网关状态
openclaw-cn dashboard      # 打开浏览器管理界面

如果你需要自定义运行时路径，可以使用：

• OPENCLAW_HOME 设置基于主目录的内部路径
• OPENCLAW_STATE_DIR 设置可变状态的存储位置
• OPENCLAW_CONFIG_PATH 设置配置文件位置

详见环境变量了解优先级和完整说明。

故障排除：找不到 openclaw-cn 命令 ​

node -v
npm -v
npm prefix -g
echo "$PATH"

export PATH="$(npm prefix -g)/bin:$PATH"

更新 / 卸载 ​

• 更新 — 保持 OpenClaw 为最新版本。
• 迁移 — 迁移到新机器。
• 卸载 — 完全移除 OpenClaw。