OpenClaw 更新翻车？用命令代替面板就稳了
最近遇到 OpenClaw 直接在面板更新后"变砖"的问题，排查后发现是因为依赖没装上。今天总结一下经验，顺便告诉大家怎么更新最稳妥。
问题回顾
在管理面板上直接更新 OpenClaw 后，服务起不来，控制台一片空白。
错误原因：缺少 @larksuiteoapi/node-sdk 依赖包
这种情况其实挺常见的——更新时某些可选依赖（比如飞书、Discord 等渠道的 SDK）没有自动安装，对应功能就直接挂掉了。
为什么面板更新容易出问题？
| 对比项 | 命令行更新 | 面板更新 |
|---|---|---|
| 依赖处理 | ✅ 完整，不容易漏装 | ❌ 可能只更新主程序 |
| 日志输出 | ✅ 能看到完整安装过程 | ❌ 出错时看不到详细日志 |
| 权限处理 | ✅ 正常 | ⚠️ 某些环境有问题 |
| 排查难度 | 低 | 高 |
正确的更新姿势
推荐走命令行，流程如下：
# 1. 备份配置（大版本更新前必做）
cp -r ~/.openclaw ~/.openclaw.backup
# 2. 强制更新
npm install -g openclaw@latest --force
# 3. 重启服务
openclaw gateway restart
# 4. 检查状态
openclaw status
遇到问题怎么办？
如果已经翻车了，按这个顺序排查：
- 看日志
openclaw gateway logs
# 或
journalctl -u openclaw-gateway -n 50
- 查版本
openclaw --version
node --version
- 补依赖
npm install
- 最后手段
npm install -g openclaw@latest --force
一句话总结
能走命令行的别点面板，依赖完整、日志清晰、排查省心。
本文基于真实踩坑经验整理，希望能帮你少走弯路~
