OpenClaw 安装教程：从零开始快速上手
系统要求
在开始之前，先确认一下你的系统是否满足要求：
- Node.js 22 或更高版本（如果没有，安装脚本会自动帮你装上）
- 操作系统：macOS、Linux 或 Windows
- pnpm：只有从源码构建时才需要
特别提醒 Windows 用户：我们强烈建议在 WSL2 环境下运行 OpenClaw，体验会好很多。
推荐安装方式：使用安装脚本
安装脚本是最省心的方式，它会自动检测 Node 环境、完成安装，还会引导你完成初始配置。
如果你用的是 VPS 或云主机，尽量避免使用第三方的"一键安装"镜像。最好选择一个干净的基础系统镜像（比如 Ubuntu LTS），然后自己用安装脚本来装。
macOS / Linux / WSL2 用户
打开终端，运行这条命令：
curl -fsSL https://openclaw.ai/install.sh | bash
就这么简单！脚本会自动处理 Node 检测、安装和配置向导。
如果你只想安装二进制文件，跳过配置向导，可以加上 --no-onboard 参数：
curl -fsSL https://openclaw.ai/install.sh | bash -s -- --no-onboard
Windows 用户（PowerShell）
在 PowerShell 中运行：
iwr -useb https://openclaw.ai/install.ps1 | iex
跳过配置向导的版本：
& ([scriptblock]::Create((iwr -useb https://openclaw.ai/install.ps1))) -NoOnboard
想了解更多安装脚本的参数、环境变量和 CI/自动化选项？可以查看 Installer internals 文档。
其他安装方式
使用 npm 或 pnpm
如果你已经装好了 Node 22+，也可以自己管理安装过程。
使用 npm：
npm install -g openclaw@latest
openclaw onboard --install-daemon
遇到 sharp 构建错误？如果你的系统全局安装了 libvips（macOS 用 Homebrew 装的话很常见），可能会导致 sharp 构建失败。这时候可以强制使用预编译的二进制文件：
SHARP_IGNORE_GLOBAL_LIBVIPS=1 npm install -g openclaw@latest
如果看到 sharp: Please add node-gyp to your dependencies 的错误，要么安装构建工具（macOS 需要 Xcode Command Line Tools + npm install -g node-gyp），要么用上面的环境变量。
使用 pnpm：
pnpm add -g openclaw@latest
pnpm approve-builds -g # 批准 openclaw、node-llama-cpp、sharp 等包
openclaw onboard --install-daemon
pnpm 对有构建脚本的包需要显式批准。第一次安装时如果看到"Ignored build scripts"警告，运行 pnpm approve-builds -g 并选择列出的包就行。
从源码构建
这个方式适合贡献者或者想从本地代码运行的朋友。
1. 克隆并构建
git clone https://github.com/openclaw/openclaw.git
cd openclaw
pnpm install
pnpm ui:build
pnpm build
2. 链接 CLI
让 openclaw 命令全局可用：
pnpm link --global
或者跳过链接，直接在仓库目录里用 pnpm openclaw ... 运行命令。
3. 运行配置向导
openclaw onboard --install-daemon
想深入了解开发工作流？可以看看 Setup 文档。
其他安装方法
OpenClaw 还支持以下安装方式：
- Docker：适合容器化或无头部署
- Podman：无根容器，运行一次
setup-podman.sh，然后用启动脚本 - Nix：通过 Nix 声明式安装
- Ansible：自动化批量部署
- Bun：通过 Bun 运行时使用 CLI
安装后的验证
装好之后，验证一下是否正常工作：
openclaw doctor # 检查配置问题
openclaw status # 查看网关状态
openclaw dashboard # 打开浏览器界面
如果需要自定义运行时路径，可以使用这些环境变量：
OPENCLAW_HOME：基于主目录的内部路径OPENCLAW_STATE_DIR：可变状态存储位置OPENCLAW_CONFIG_PATH：配置文件位置
详细的优先级和说明可以查看 Environment vars 文档。
遇到"openclaw not found"？
快速诊断
运行这些命令来诊断问题：
node -v
npm -v
npm prefix -g
echo "$PATH"
如果 $(npm prefix -g)/bin（macOS/Linux）或 $(npm prefix -g)（Windows）不在你的 $PATH 里，shell 就找不到全局 npm 安装的二进制文件（包括 openclaw）。
解决方法
把它添加到你的 shell 启动文件（~/.zshrc 或 ~/.bashrc）：
export PATH="$(npm prefix -g)/bin:$PATH"
Windows 用户需要把 npm prefix -g 的输出添加到系统 PATH 环境变量。
然后打开一个新终端（或者在 zsh 里运行 rehash，bash 里运行 hash -r）。
更新与卸载
- 更新：保持 OpenClaw 最新版本
- 迁移：迁移到新机器
- 卸载：完全移除 OpenClaw
具体操作可以参考官方文档的相关章节。
希望这篇教程能帮你顺利安装 OpenClaw。如果遇到问题，记得先运行 openclaw doctor 检查一下，大部分常见问题都能自动诊断出来。