如何安装OpenClaw

作者：工程师老罗
下面是用 npm i -g openclaw 安装 OpenClaw 的完整、可直接执行步骤（含常见问题修复）。
一、先检查/安装 Node.js（必须）

OpenClaw 要求 Node.js ≥ 22 LTS（推荐 22.16+）。

检查版本：
1. node-vnpm-v
复制代码
没装/版本太低：去 nodejs.org 下载安装，Windows 务必勾选 Add to PATH。

二、配置国内镜像（解决安装慢/超时）

1. # 切换到 npm 国内镜像npm config set registry https://registry.npmmirror.com

复制代码

三、全局安装 OpenClaw（核心命令）

1. 标准安装（推荐）

1. npminstall-g openclaw@latest

复制代码

2. 遇到 sharp 编译报错时用（常见）

1. SHARP_IGNORE_GLOBAL_LIBVIPS=1npminstall-g openclaw@latest

复制代码

3. macOS/Linux 权限不足时

1. sudonpminstall-g openclaw@latest

复制代码

4. Windows 权限不足

用 管理员身份 打开 PowerShell/CMD 再执行安装命令。
四、验证安装成功

1. openclaw --version# 应输出类似：openclaw 2026.3.13 (61d171a) @latest

复制代码

五、初始化配置（必须）

1. openclaw onboard --install-daemon

复制代码

按向导完成：

登录/注册配置网关（Gateway）安装守护进程（开机自启）

---

常见问题与修复

安装卡住/超时

已配置镜像仍慢：改用 pnpm（更快）
1. npminstall-gpnpmpnpmadd-g openclaw@latest
复制代码
sharp: Please add node-gyp to your dependencies



• 安装构建工具：
  1. # macOS
  2. xcode-select --installnpminstall-g node-gyp
  3. # Windows（管理员 PowerShell）npminstall-g windows-build-tools node-gyp

  复制代码
安装后命令找不到

重启终端检查 PATH 包含 npm 全局目录

权限错误（EACCES）

macOS/Linux：加 sudoWindows：用管理员终端

原文地址：https://blog.csdn.net/Lwjobs/article/details/159354454