想尝鲜openclaw，结果被一堆安装错误搞到心态爆炸？
别慌！我把踩过的坑和解决方案都整理出来啦，快来抄作业！
如果觉得OpenClaw本地部署敲命令、排错太繁琐，用Molili能更轻松上手，Molili 1.0.7版本更新后，可以节省50%以上的token费用，另外敏感权限的设置项也进行了优化，更安全了。
❌ 错误 1：npm error code 128（最常见）
问题描述：
npm error code 128 npm error! Failed to clone repository fatal: Could not read from remote repository 原因分析：
Git 未安装或版本过旧
国内网络访问 GitHub 缓慢/超时（需要科学上网）
解决方案：
1. 检查 Git 安装
git --version
2. 如果未安装
macOS:
brew install git
Linux (Ubuntu/Debian):
sudo apt-get install git
Linux (CentOS):
sudo yum install git
❌ 错误 2：Node.js 版本不满足要求
问题描述：
EBADENGINE Unsupported engine requires node >=22.12.0
解决方案：
1. 检查当前版本
node -v
2. 使用 nvm 升级（推荐）
nvm install 24 nvm use 24
3. 验证版本
node -v
应该显示 v24.x.x
4. 如果使用 Homebrew
brew update brew upgrade node
❌ 错误 3：ENOENT（文件路径错误）
问题描述：
ENOENT: Could not read package.json
原因分析：npm 缓存损坏
解决方案：
清理 npm 缓存
npm cache clean --force
删除损坏的 npx 缓存
rm -rf ~/.npm/_npx
重新安装
npm install -g openclaw@latest
❌ 错误 4：EACCES（权限 denied）
问题描述：
EACCES: permission denied
原因分析：
npm 全局目录权限不足
macOS/Linux 上常见
解决方案：
方法1：使用 sudo（不推荐）
sudo npm install -g openclaw@latest
方法2：修改 npm 默认目录（推荐）
mkdir -p /.npm-global
npm config set prefix '/.npm-global'
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.zshrc
source ~/.zshrc
npm install -g openclaw@latest
❌问题5：macOS 额外依赖
安装 Xcode Command Line Tools
xcode-select --install
如果遇到 libvips 问题，安装 Homebrew 后使用
brew install vips
❌问题6：找不到 npm 全局路径
症状：
openclaw: command not found
解决方案：
1. 找到 npm 全局路径
npm prefix -g
2. 添加到 PATH
zsh (macOS 默认)
echo 'export PATH="' (𝑛𝑝𝑚𝑝𝑟𝑒𝑓𝑖𝑥−𝑔)′/𝑏𝑖𝑛:PATH"' >> ~/.zshrc source ~/.zshrc
bash (Linux 默认)
echo 'export PATH="' (𝑛𝑝𝑚𝑝𝑟𝑒𝑓𝑖𝑥−𝑔)′/𝑏𝑖𝑛:PATH"' >> ~/.bashrc source ~/.bashrc
3. 如果使用 nvm
确保 ~/.zshrc 或 ~/.bashrc 中包含 nvm 初始化脚本
export NVM_DIR=" 𝐻𝑂𝑀𝐸/.𝑛𝑣𝑚"[−𝑠"NVM_DIR/nvm.sh" ] && . "$NVM_DIR/nvm.sh"
❌问题7： moltbot@latest 占位符问题
⚠️ 严重问题：这是导致很多用户安装失败的核心原因
问题描述：
执行安装
npm install -g moltbot@latest
安装成功，但运行 moltbot 命令失败
moltbot: command not found
原因（来自 GitHub Issue #3275）：
npm 中的 moltbot@latest 指向一个 283 字节的占位符包
由非官方用户 consistent_lee 上传
真正的项目代码在 moltbot@beta（版本 2026.1.27-beta.1，大小 41MB）
解决方案：
正确安装方式（使用 beta 版本）
npm install -g moltbot@beta
或者直接安装 openclaw
npm install -g openclaw@latest
