OpenClaw 升级指南：本地安装 vs 全局安装，一篇搞懂

你的龙虾升级了吗？

你的龙虾自己升级崩溃了吗？

📚 OpenClaw 的两种安装方式

1. 全局安装

# 安装npm install -g openclaw@latest# 更新openclaw update# 或npm update -g openclaw

特点：

• 安装在系统目录（/usr/lib/node_modules/）
• 命令自动在 PATH，谁都能用
• 全局只能有一个版本
• 适合个人开发机

2. 本地安装

# 安装cd /opt/openclawnpm install openclaw@latest# 更新（直接覆盖安装）npm install openclaw@latest

特点：

• 安装在项目目录（./node_modules/）
• 需要手动软链接才能全局使用
• 不同项目可以用不同版本
• 适合服务器部署

我用的就是这种方式。

🔄 本地安装完整升级流程

第一步：备份（重要！）

# 备份配置文件cp -r /opt/openclaw/.openclaw /opt/openclaw/.openclaw.backup# 或者打包cd /opt/openclawtar -czf openclaw-backup-$(date +%Y%m%d).tar.gz .openclaw

备份什么：

• .openclaw/ 目录（配置、会话记录）
• 自定义的 skills
• 修改过的配置文件

不用备份：

• node_modules/（可以重新安装）
• 临时文件

第二步：升级

cd /opt/openclawnpm install openclaw@latest

就这么简单，不需要卸载旧的。

npm 会自动：

1. 下载新版本
2. 覆盖旧版本
3. 处理依赖

第三步：重启网关

openclaw gateway restart

第四步：验证

openclaw --versionopenclaw status

🚨 更新失败怎么回退？

场景 1：npm install 失败

# 清理缓存重试npm cache clean --forcenpm install openclaw@latest

场景 2：升级后启动失败

# 1. 恢复备份cd /opt/openclawrm -rf node_modulesnpm install openclaw@2026.3.3  # 指定旧版本# 2. 恢复配置cp -r .openclaw.backup/* .openclaw/# 3. 重启openclaw gateway restart

场景 3：彻底回退

# 删除当前安装sudorm -rf /opt/openclaw# 重新安装旧版本sudomkdir -p /opt/openclawsudochown admin:admin /opt/openclawcd /opt/openclawnpm init -ynpm install openclaw@2026.3.3  # 指定旧版本sudoln -sf /opt/openclaw/node_modules/.bin/openclaw /usr/local/bin/openclaw# 恢复配置cp -r /path/to/backup/.openclaw.backup/* .openclaw/# 重启openclaw gateway restart

💡 常见问题

Q1：openclaw update 报错怎么办？

原因： 这个命令主要支持全局安装，本地安装不识别。

解决： 直接用 npm install openclaw@latest

Q2：需要卸载旧版本吗？

不需要。 npm 会自动覆盖安装。

Q3：权限问题怎么办？

# 确保目录权限正确sudochown -R admin:admin /opt/openclaw

Q4：内存不足导致安装中断？

原因： 服务器内存小，npm install 占用高。

解决： 重试一次，或者 swap 调大一点。

📝 总结

全局安装：

npm install -g openclaw@latestopenclaw update

本地安装：

cd /opt/openclawnpm install openclaw@latestopenclaw gateway restart

核心就一句：本地安装更新就是直接 npm install，不需要卸载，不需要删除，覆盖安装就行。

🥚 彩蛋

彩蛋：龙虾给自己升级，失败 N 次后终于成功了

关注我，带你养龙虾🦞