安装
快速安装（推荐）
Windows（PowerShell）：
下一步（如果你跳过了新手引导）：
系统要求
- 节点 >=22
- macOS、Linux 或通过 WSL2 的 Windows
pnpm仅在从源代码构建时需要
选择安装路径
1）安装器脚本（推荐）
通过 npm 全局安装 并运行新手引导。openclaw
安装器标志：
详情：安装器内部原理。非交互式（跳过新手引导）：
2）全局安装（手动）
如果你已经有 Node：
如果你全局安装了 libvips（macOS 上通过 Homebrew 安装很常见）且安装失败，请强制使用预构建二进制文件：sharp
如果你看到 ，要么安装构建工具（macOS：Xcode CLT + ），要么使用上面的 变通方法来跳过原生构建。sharp: Please add node-gyp to your dependenciesnpm install -g node-gypSHARP_IGNORE_GLOBAL_LIBVIPS=1或使用 pnpm：
PNPM 需要显式批准带有构建脚本的包。在首次安装显示“Ignored build scripts”警告后，运行 并选择列出的包，然后重新运行安装以执行 postinstall 脚本。pnpm approve-builds -g然后：
3）从源代码（贡献者/开发）
提示：如果你还没有全局安装，请通过 运行仓库命令。pnpm openclaw ...
4）其他安装选项
安装后
- 运行新手引导：
openclaw onboard --install-daemon - 快速检查：
openclaw doctor - 检查 Gateway 网关健康状态：
openclaw status+openclaw health - 打开仪表板：
openclaw dashboard
安装方式：npm vs git（安装器）
安装器支持两种方式：
npm（默认）：npm install -g openclaw@latestgit：从 GitHub 克隆/构建并从源代码 checkout 运行
CLI 标志
常用标志：
--install-method npm|git--git-dir <path>（默认：）~/openclaw--no-git-update（使用现有 checkout 时跳过 ）git pull--no-prompt（禁用提示;CI/自动化中必需）--dry-run（打印将要执行的操作；不做任何更改）--no-onboard（跳过新手引导）
环境变量
等效的环境变量（对自动化有用）：
OPENCLAW_INSTALL_METHOD=git|npmOPENCLAW_GIT_DIR=...OPENCLAW_GIT_UPDATE=0|1OPENCLAW_NO_PROMPT=1OPENCLAW_DRY_RUN=1OPENCLAW_NO_ONBOARD=1SHARP_IGNORE_GLOBAL_LIBVIPS=0|1（默认：;避免 针对系统 libvips 构建）1sharp
故障排除：找不到 （PATH）openclaw
快速诊断：
如果 （macOS/Linux）或 （Windows）不在 的输出中，你的 shell 无法找到全局 npm 二进制文件（包括 ）。$(npm prefix -g)/bin$(npm prefix -g)echo "$PATH"openclaw修复：将其添加到你的 shell 启动文件（zsh：，bash：）：~/.zshrc~/.bashrc
在 Windows 上，将 的输出添加到你的 PATH。npm prefix -g然后打开新终端（或在 zsh 中执行 / 在 bash 中执行 ）。rehashhash -r
更新/卸载
原创文章，作者：yun，如若转载，请注明出处：https://www.yundongfang.com/Yun394.html
