一周前 X 上网友们还在讨论，Openclaw是不是要彻底凉凉了， 就在整个 AI 圈几乎默认"OpenClaw 已死"。结果它突然带着 2.0 杀回来了——官方称这是史上最大更新，933 名贡献者参与，569 人首次提交，合并 PR 超 1.6万个，约等于历史总合并量的一半。对于一名去年底就开始用 Openclaw 的资深玩家，虽然4月底就弃用转去了 Hermes。但这波更新确实有点东西，于是连夜让 Claude 装上 8.1 正式版，不出意外果然出意外——Gateway反复重启十几次，一度死锁到进程完全没反应，折腾一小时才救回来。踩坑实录如下：
1️⃣新旧版本打架
npm-global 和 nvm 两个路径各装了一份，命令走旧的、服务跑新的，互相不认账。
坑：装新版前先 which -a 查一下有没有残留旧安装。
2️⃣命令并发直接死锁
几条维护命令一起跑，全部卡死不报错。这类工具共用一个 SQLite 状态文件，多命令抢写会锁死。坑：一条跑完再跑下一条，别并发。
3️⃣多 Agent 系统要求显式指定默认接收者
挂了 10 个 Agent，新版必须显式声明"谁是默认接收者"，不然直接拒绝启动，老版本是隐式默认的。
4️⃣会话存储大迁移，10 个 Agent 要逐个手动倒数据
会话记录整个换成 SQLite，官方修复工具只检测不处理，报错也说不清。最后发现得对每个 Agent 单独跑一次迁移命令，漏一个那个 Agent 直接启动失败。
5️⃣飞书官方插件没被自动检测到该更新
飞书插件是官方发的，但不在 OpenClaw 自己那份插件版本检测名单里——那份名单只认自家命名空间下的插件，"平台方官方出品"反而被漏检，直到插件自己崩了才发现。深挖是三层套娃：接口路径被拆分重命名、一处隐藏语法触发新版"文件类型误判"、一个方法名被偷偷改了。改一个报下一个，活脱脱"找个 Agent 来修 Agent"。
6️⃣最阴间：报错提示是"假警报"
系统一直提示"有旧数据没迁移，请修复"，以为是无害唠叨，结果背后是消息处理直接失败——发消息真收到了，处理到一半崩溃，表现就是"发了不理你"。深挖发现是官方自己漏了：这段迁移代码压根没接到本地这条路上，跑一百遍修复命令都没用。自己手动补跑了一次官方写好但没接上的代码，才真正活过来。
#openclaw #踩坑日志 #升级指南