OpenClaw 安装教程
概述
本文档提供了 OpenClaw 的安装方法、平台特定说明和维护指南。
系统要求
- Node 22+(安装脚本会自动安装，如果缺少)
- macOS, Linux, 或 Windows
- 仅当从源代码构建时才需要
pnpm
注意：在 Windows 上，强烈建议在 WSL2 下运行 OpenClaw。
安装方法
提示：推荐使用安装脚本来安装 OpenClaw。它一步到位地处理 Node 检测、安装和入门引导。
警告：对于 VPS/云主机，尽可能避免使用第三方“一键”市场镜像。优先选择干净的基础操作系统镜像（例如 Ubuntu LTS），然后使用安装脚本自行安装 OpenClaw。
1. 安装脚本 (推荐)
下载 CLI，通过 npm 全局安装，并启动入门引导向导。
macOS / Linux / WSL2:
curl-fsSLhttps://openclaw.ai/install.sh|bashWindows (PowerShell):
iwr-useb https://openclaw.ai/install.ps1|iex跳过入门引导，仅安装二进制文件：
macOS / Linux / WSL2:
curl-fsSLhttps://openclaw.ai/install.sh|bash-s-- --no-onboardWindows (PowerShell):
&([scriptblock]::Create((iwr-useb https://openclaw.ai/install.ps1)))-NoOnboard2. npm / pnpm
如果你已经安装了 Node 22+ 并希望自己管理安装：
npm:
npminstall-gopenclaw@latest openclaw onboard --install-daemonpnpm:
pnpmadd-gopenclaw@latestpnpmapprove-builds-g# 批准 openclaw, node-llama-cpp, sharp 等openclaw onboard --install-daemon注意：pnpm 需要明确批准带有构建脚本的包。首次安装显示“Ignored build scripts”警告后，运行
pnpm approve-builds -g并选择列出的包。
3. 从源代码安装
适用于贡献者或希望从本地检出运行的用户。
- 克隆并构建:
克隆 OpenClaw 仓库 并构建：gitclone https://github.com/openclaw/openclaw.gitcdopenclawpnpminstallpnpmui:buildpnpmbuild - 链接 CLI:
使openclaw命令全局可用：
或者，跳过链接，在仓库内部通过pnpmlink--globalpnpm openclaw ...运行命令。 - 运行入门引导:
openclaw onboard --install-daemon
其他安装方法
- Docker:容器化或无头部署。
- Podman:无根容器：运行
setup-podman.sh一次，然后运行启动脚本。 - Nix:通过 Nix 进行声明式安装。
- Ansible:自动化集群配置。
- Bun:仅通过 Bun 运行时使用 CLI。
安装后
验证一切正常：
openclaw doctor# 检查配置问题openclaw status# 网关状态openclaw dashboard# 打开浏览器 UI如果你需要自定义运行时路径，请使用：
OPENCLAW_HOME用于基于主目录的内部路径OPENCLAW_STATE_DIR用于可变状态位置OPENCLAW_CONFIG_PATH用于配置文件位置
故障排除：openclaw命令未找到
快速诊断：
node-vnpm-vnpmprefix-gecho"$PATH"如果$(npm prefix -g)/bin(macOS/Linux) 或$(npm prefix -g)(Windows)不在你的$PATH中，你的 shell 将无法找到全局 npm 二进制文件（包括openclaw）。
修复方法 — 将其添加到你的 shell 启动文件（~/.zshrc或~/.bashrc）：
exportPATH="$(npmprefix-g)/bin:$PATH"在 Windows 上，将npm prefix -g的输出添加到你的 PATH 中。
然后打开一个新的终端（或在 zsh 中运行rehash/ 在 bash 中运行hash -r）。
更新 / 卸载
- 更新：保持 OpenClaw 最新。
- 迁移：迁移到新机器。
- 卸载：完全移除 OpenClaw。
