安装
已经完成了快速入门？那你已经准备好了 — 本页面提供其他安装方式、平台特定说明和维护信息。
系统要求
注意： 在 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@latestopenclaw-cn onboard --install-daemon
sharp 构建错误？
如果你全局安装了 libvips（macOS 上通过 Homebrew 安装较常见）导致 sharp 构建失败，可以强制使用预构建二进制文件：
SHARP_IGNORE_GLOBAL_LIBVIPS=1 npm install -g openclaw-cn@latest
如果看到 sharp: Please add node-gyp to your dependencies，可以安装构建工具（macOS: Xcode CLT + npm install -g node-gyp）或使用上述环境变量。
pnpm
pnpm add -g openclaw-cn@latestpnpm 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.gitcd openclawpnpm installpnpm ui:buildpnpm build
2. 链接 CLI
将 openclaw-cn 命令设为全局可用：
pnpm link --global
也可以跳过链接，在仓库内通过 pnpm openclaw-cn ... 运行命令。
3. 运行初始配置
openclaw-cn onboard --install-daemon
更深入的开发工作流，请参阅开发设置。
其他安装方式
安装后
验证一切正常运行：
openclaw-cn doctor # 检查配置问题openclaw-cn status # 网关状态openclaw-cn dashboard # 打开浏览器管理界面
如果你需要自定义运行时路径，可以使用：
OPENCLAW_HOME设置基于主目录的内部路径OPENCLAW_STATE_DIR设置可变状态的存储位置OPENCLAW_CONFIG_PATH设置配置文件位置
详见环境变量了解优先级和完整说明。
故障排除：找不到 openclaw-cn 命令
PATH 诊断与修复
快速诊断：
node -vnpm -vnpm prefix -gecho "$PATH"
如果 $(npm prefix -g)/bin（macOS/Linux）或 $(npm prefix -g)（Windows）不在你的 $PATH 中，Shell 将无法找到全局 npm 二进制文件（包括 openclaw-cn）。
修复 — 将以下内容添加到你的 Shell 启动文件（~/.zshrc 或 ~/.bashrc）：
export PATH="$(npm prefix -g)/bin:$PATH"
在 Windows 上，将 npm prefix -g 的输出添加到 PATH 中。
然后打开一个新终端（或在 zsh 中执行 rehash / 在 bash 中执行 hash -r）。
