Clawdbot 安装报错处理指南

安装 Clawdbot（或 Moltbot / Clawdbot 系列）时，很多人都会遇到以下报错：

npm install failed; cleaning up and retrying

看起来像是 npm 本身的问题，但实际上 80% 的情况并不是 npm 真坏了，而是安装脚本中某一步失败，被统一兜成了这句话。

下面是一个实战可复现、可定位、可解决的处理流程。

---

一、第一步：打开详细日志（非常关键）

默认安装脚本会隐藏大量关键信息，必须先把 npm 日志级别拉满。

执行以下命令：

curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh \
  | CLAWDBOT_NPM_LOGLEVEL=verbose bash -s -- --verbose

这条命令做了三件事：

1. CLAWDBOT_NPM_LOGLEVEL=verbose
   👉 强制 npm 输出完整日志

2. --verbose
   👉 让安装脚本本身也进入详细模式

3. 保留所有 error / warning / stack trace

执行效果：

完成后，你会看到真正的报错原因，而不是一句模糊的 “npm install failed”。

---

二、第二步：把 error 日志交给大模型分析

当你拿到完整日志后，不要急着自己硬啃。

正确姿势：

1. 找到日志里的核心 error

通常是以下几种之一：

• fatal: could not read from remote repository
• Permission denied (publickey)
• git@github.com: Permission denied
• npm ERR! code 128

2. 提取关键信息

把 error 段 + 上下文 20～50 行 复制出来

3. 提交给大模型分析

可以这样问：

“帮我分析这个 Clawdbot 安装日志，告诉我真正失败的原因和解决方式”

💡 为什么这么做？

大模型在日志定位 + 根因判断这件事上，比人快很多。

---

三、常见原因：Git Key 问题（高频）

典型特征：

日志中出现：

• git@github.com
• Permission denied (publickey)
• npm ERR! code 128

根本原因：

• npm 表面失败，但根因在 git clone 私有仓库
• Git SSH Key 没配置 / 配错了

---

四、解决步骤

1. 检查 SSH Key 配置

# 查看现有 SSH Key
ls -la ~/.ssh

# 测试 GitHub 连接
ssh -T git@github.com

2. 生成或配置 SSH Key

如果没有 SSH Key：

# 生成新的 SSH Key
ssh-keygen -t ed25519 -C "your_email@example.com"

# 将公钥添加到 GitHub
cat ~/.ssh/id_ed25519.pub

3. 将公钥添加到 GitHub

1. 复制公钥内容
2. 登录 GitHub → Settings → SSH and GPG keys → New SSH key
3. 粘贴公钥并保存

4. 再次安装

curl -fsSL --proto '=https' --tlsv1.2 https://molt.bot/install.sh \
  | CLAWDBOT_NPM_LOGLEVEL=verbose bash -s -- --verbose

---

五、其他常见问题

1. 网络问题

# 配置 npm 镜像（如果在中国大陆）
npm config set registry https://registry.npmmirror.com

2. Node 版本不兼容

# 检查 Node 版本
node -v

# 推荐使用 nvm 管理 Node 版本
nvm install 24
nvm use 24

---

六、总结

遇到 npm install failed 报错时，记住：

1. 一定要用详细日志（--verbose + CLAWDBOT_NPM_LOGLEVEL=verbose）
2. 把错误日志交给大模型分析，不要自己硬啃
3. 检查 Git SSH Key 配置，这是最常见的原因
4. 逐项排查网络、Node 版本

遵循这个流程，90% 的安装问题都能快速定位并解决。

---

文档版本： v1.0
最后更新： 2026-01-30