Markdown 源文件
https://clawd.org.cn/install/index.md
安装
已经完成了快速入门？那你已经准备好了 — 本页面提供其他安装方式、平台特定说明和维护信息。
系统要求
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@latestopenclaw-cn onboard --install-daemon
sharp 构建错误？
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
更深入的开发工作流，请参阅开发设置。
其他安装方式
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 命令
PATH 诊断与修复
更新 / 卸载
更新 — 保持 OpenClaw 为最新版本。
迁移 — 迁移到新机器。
卸载 — 完全移除 OpenClaw。
