OpenClaw 安装教程：从零开始快速上手

科技前沿 • 2026-03-31 08:57 • 阅读 1

大家好，我是讯享网，很高兴认识大家。这里提供最前沿的Ai技术和互联网信息。

在开始之前，先确认一下你的系统是否满足要求：

特别提醒 Windows 用户：我们强烈建议在 WSL2 环境下运行 OpenClaw，体验会好很多。

安装脚本是最省心的方式，它会自动检测 Node 环境、完成安装，还会引导你完成初始配置。

如果你用的是 VPS 或云主机，尽量避免使用第三方的"一键安装"镜像。最好选择一个干净的基础系统镜像（比如 Ubuntu LTS），然后自己用安装脚本来装。

打开终端，运行这条命令：

就这么简单！脚本会自动处理 Node 检测、安装和配置向导。

如果你只想安装二进制文件，跳过配置向导，可以加上参数：

在 PowerShell 中运行：

跳过配置向导的版本：

想了解更多安装脚本的参数、环境变量和 CI/自动化选项？可以查看 Installer internals 文档。

如果你已经装好了 Node 22+，也可以自己管理安装过程。

使用 npm：

遇到 sharp 构建错误？如果你的系统全局安装了 libvips（macOS 用 Homebrew 装的话很常见），可能会导致 sharp 构建失败。这时候可以强制使用预编译的二进制文件：

如果看到的错误，要么安装构建工具（macOS 需要 Xcode Command Line Tools + ），要么用上面的环境变量。

使用 pnpm：

pnpm 对有构建脚本的包需要显式批准。第一次安装时如果看到"Ignored build scripts"警告，运行并选择列出的包就行。

这个方式适合贡献者或者想从本地代码运行的朋友。

1. 克隆并构建

2. 链接 CLI

让命令全局可用：

或者跳过链接，直接在仓库目录里用运行命令。

3. 运行配置向导

想深入了解开发工作流？可以看看 Setup 文档。

OpenClaw 还支持以下安装方式：

装好之后，验证一下是否正常工作：

如果需要自定义运行时路径，可以使用这些环境变量：

详细的优先级和说明可以查看 Environment vars 文档。

运行这些命令来诊断问题：

如果（macOS/Linux）或（Windows）不在你的里，shell 就找不到全局 npm 安装的二进制文件（包括 openclaw）。

把它添加到你的 shell 启动文件（或）：

Windows 用户需要把的输出添加到系统 PATH 环境变量。

然后打开一个新终端（或者在 zsh 里运行，bash 里运行）。

具体操作可以参考官方文档的相关章节。

希望这篇教程能帮你顺利安装 OpenClaw。如果遇到问题，记得先运行检查一下，大部分常见问题都能自动诊断出来。