下面是用npm i -g openclaw安装 OpenClaw 的完整、可直接执行步骤含常见问题修复。一、先检查/安装 Node.js必须OpenClaw 要求Node.js ≥ 22 LTS推荐 22.16。检查版本node-vnpm-v没装/版本太低去 nodejs.org 下载安装Windows 务必勾选Add to PATH。二、配置国内镜像解决安装慢/超时# 切换到 npm 国内镜像npmconfigsetregistry https://registry.npmmirror.com三、全局安装 OpenClaw核心命令1. 标准安装推荐npminstall-gopenclawlatest2. 遇到 sharp 编译报错时用常见SHARP_IGNORE_GLOBAL_LIBVIPS1npminstall-gopenclawlatest3. macOS/Linux 权限不足时sudonpminstall-gopenclawlatest4. Windows 权限不足用管理员身份打开 PowerShell/CMD 再执行安装命令。四、验证安装成功openclaw--version# 应输出类似openclaw 2026.3.13 (61d171a) latest五、初始化配置必须openclaw onboard --install-daemon按向导完成登录/注册配置网关Gateway安装守护进程开机自启常见问题与修复安装卡住/超时已配置镜像仍慢改用pnpm更快npminstall-gpnpmpnpmadd-gopenclawlatestsharp: Please add node-gyp to your dependencies安装构建工具# macOSxcode-select--installnpminstall-gnode-gyp# Windows管理员 PowerShellnpminstall-gwindows-build-tools node-gyp安装后命令找不到重启终端检查PATH包含npm全局目录权限错误EACCESmacOS/Linux加sudoWindows用管理员终端