已经完成了快速入门？那你已经准备好了 — 本页面提供其他安装方式、平台特定说明和维护信息。
- Node 22+（安装脚本会在缺失时自动安装）
- macOS、Linux 或 Windows
- 仅从源码构建时需要
注意： 在 Windows 上，我们强烈建议在 WSL2 下运行 OpenClaw。
💡 提示： 安装脚本是安装 OpenClaw 的推荐方式。它可以一步完成 Node 检测、安装和初始配置。
下载 CLI，通过 npm 全局安装，并启动初始配置向导。
macOS / Linux / WSL2：
Windows (PowerShell)：
就这样 — 脚本会自动处理 Node 检测、安装和初始配置。
如果想跳过初始配置，只安装二进制文件：
macOS / Linux / WSL2：
Windows (PowerShell)：
查看所有参数、环境变量和 CI/自动化选项，请参阅安装脚本详解。
如果你已经有 Node 22+，并且想自行管理安装：
npm
sharp 构建错误？
如果你全局安装了 libvips（macOS 上通过 Homebrew 安装较常见）导致 构建失败，可以强制使用预构建二进制文件：
如果看到 ，可以安装构建工具（macOS: Xcode CLT + ）或使用上述环境变量。
pnpm
注意： pnpm 要求显式批准包含构建脚本的包。首次安装显示"Ignored build scripts"警告后，运行 并选择列出的包。
适用于贡献者或想从本地代码运行的用户。
1. 克隆并构建
克隆 OpenClaw 仓库 并构建：
2. 链接 CLI
将 命令设为全局可用：
也可以跳过链接，在仓库内通过 运行命令。
3. 运行初始配置
更深入的开发工作流，请参阅开发设置。
- Docker — 容器化或无头部署。
- Nix — 通过 Nix 声明式安装。
- Ansible — 自动化批量部署。
- Bun — 通过 Bun 运行时使用 CLI。
验证一切正常运行：
如果你需要自定义运行时路径，可以使用：
- 设置基于主目录的内部路径
- 设置可变状态的存储位置
- 设置配置文件位置
详见环境变量了解优先级和完整说明。
PATH 诊断与修复
快速诊断：
如果 （macOS/Linux）或 （Windows）不在你的 中，Shell 将无法找到全局 npm 二进制文件（包括 ）。
修复 — 将以下内容添加到你的 Shell 启动文件（ 或 ）：
在 Windows 上，将 的输出添加到 PATH 中。
然后打开一个新终端（或在 zsh 中执行 / 在 bash 中执行 ）。
- 更新 — 保持 OpenClaw 为最新版本。
- 迁移 — 迁移到新机器。
- 卸载 — 完全移除 OpenClaw。
版权声明：本文内容由互联网用户自发贡献，该文观点仅代表作者本人。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。如发现本站有涉嫌侵权/违法违规的内容，请联系我们，一经查实，本站将立刻删除。
如需转载请保留出处：https://51itzy.com/kjqy/211689.html