OpenClaw 2.0 今天发布，我升级搞崩了

晚上，我把电脑上的 OpenClaw 升级到了 2026.8.1。

然后，它崩了。

对话直接报错：Legacy workspace setup state requires migration，翻译成人话就是——旧数据格式不认了，得迁移。系统还挺贴心，提示我跑一句 openclaw doctor --fix。

行，跑就跑。结果这一跑，折腾了我一个多小时。

今天就把这个过程原原本本写出来，顺便把 OpenClaw 2.0 到底更新了啥，给你扒清楚。

先说结论：2.0 到底是个啥

网上有人吵"OpenClaw 2.0 和 v2026.8.1 是不是两个版本"。

不是。就是同一个东西。

OpenClaw 2.0 是对外的产品代号，v2026.8.1 是 Git 仓库里的真实版本标签。类比一下：Windows 11 是产品名，22H2 是版本号，一个意思。

2026年8月31日正式发布，停更7周憋出来的大招，16000+ 个 PR，933 位贡献者。这是 OpenClaw 历史上最大的一次更新。

大到什么程度？大到我自己动手修了四轮才救回来。

踩坑实录

第一坑：修复被拒

跑 doctor --fix，系统直接拒绝：另一个 Gateway 进程占着数据库，不让动。

这逻辑其实没毛病——数据库正被占用时改结构，容易改坏。但提示信息里没直说，我自己查了进程才明白：得先把 Gateway 服务停了，再跑修复。

停了，再跑。

第二坑：静默失败

这回命令跑完了，退出码 1，啥也没干。

不报错、不提示、就愣着。这种最坑人，因为你不知道它到底卡在哪。

后来用 doctor --lint --json 跑了个诊断，才抓到真凶：一个 8 月 15 号留下的旧授权文件 exec-approvals.json，让安全检查直接抛异常，把整条迁移流水线卡死了。

我打开那文件一看，好家伙，177 字节，里面俩空对象。就这么个空壳文件，拦住了所有后续迁移。

把它改名挪走，再跑 doctor --fix——一口气跑完：agent 花名册、8 个模型凭证、心跳文件、141 行审计日志，全部迁进 SQLite。重启 Gateway，电脑上网页控制台和飞书上对话恢复正常。

我以为完事了。

第三坑：微信连不上了

微信发消息过去，没反应。查日志，微信通道在反复崩溃重启：

Package subpath './plugin-sdk/channel-runtime' is not defined

看明白了。微信插件依赖的 SDK 模块，在 2026.8.1 里不存在了。主程序大重构，把 channel-runtime 这个模块拆了，里面的函数挪去了别的模块，但腾讯的微信插件（2.4.6，6月份发的）还在按老地址找。

查了下 npm，2.4.6 就是最新版，官方适配版还没发。

怎么办？我对比了新旧版本的 SDK，发现它要的那个函数 createTypingCallbacks 在新模块 channel-outbound 里还活着，只是搬了家。于是手动改了插件里一行 import 路径，重启——微信通道活了。

一行代码，救活一个通道。

为什么 2.0 的坑这么多

不是我运气差，是这次更新动的手术太深。

会话数据从文件搬进 SQLite 数据库，这个动作贯穿了整个故障过程——我遇到的所有报错，本质上都是"旧文件格式要迁到新数据库"。停更 7 周，933 个贡献者改了 16000 多个 PR，底层的目录结构、模块划分、数据格式全动了。

主程序改得越狠，第三方插件跟得越辛苦。 微信插件那个坑就是这么来的。

那 2.0 到底更新了啥

骂归骂，这次更新是真有货。挑几个我自己觉得实在的：

安装引导重写了。 以前装 OpenClaw，配置项一大堆，新手直接劝退。现在会自动扫描你本机已有的 API Key、本地模型，而且是先验证模型能不能连通，再保存配置——不会出现配了半天发现 key 填错的尴尬。复杂配置全移出安装流程，边用边配。

网页控制台彻底重构。 改成对话优先的布局，会话在侧边栏，对话居中，像个正经聊天工具了。启动速度从 1.6 秒干到 575 毫秒，加载的 JS 请求从 140 个砍到 45 个。会话记录进了 SQLite，终于能搜索聊天历史了——这个我等了很久。

会话可以上云、跨设备了。 一个 Agent 会话能迁到云端 Worker，手机、平板、电脑接着聊，上下文不断。还能多人同时接入同一个会话。不过官方自己都警告了：这不是安全隔离边界，别拿来做多租户服务，自己团队内部用没问题。

安全体系大加固。 每个网关独立信任边界；API 密钥只能访问预先允许的主机，就算密钥泄露也出不去；新增一条 openclaw security audit 命令一键体检。默认只绑定本机回环地址，外部访问要配对码。这些改动方向是对的，本地跑 AI 最大的隐患从来不是模型笨，是密钥裸奔。

底层杂项。 内置记忆系统替代了旧的 QMD 插件；本地 llama.cpp 默认上下文拉到 64K；新增一批模型服务商和视频生成、搜索工具；Telegram、Discord、飞书这些频道的插件稳定性也改了。

升级建议

血泪教训，就三条：

第一，升级前备份。 配置文件和 SQLite 会话库都拷一份。这不是可选项，是必选项。我晚上每个动作前都先备份，这不是谨慎，是踩坑踩出来的肌肉记忆。

第二，普通用户直接升。 v2026.8.1 是正式稳定版，坑是有，但都能修，修完的体验提升是实打实的。别去装 beta 版，那玩意是给勇者测试用的。

第三，生产环境先在测试机跑。 尤其是自定义 skill 多、插件多的，一个一个验证兼容性再上线。微信插件这种坑，生产环境遇到就是事故。

至于怎么区分版本：终端里跑 openclaw --version，输出 2026.8.1 就是正式 2.0；带 beta 后缀的都是测试版。

最后

一个多小时，四轮排查，最后发现卡住全局的不过是个 177 字节的空文件。

这大概就是折腾 AI 工具的常态：吓人的报错，往往有个不起眼的原因。静下心一层一层剥，总能剥到核。

大版本升级没有不翻车的，区别只在于翻车之后你能不能自己爬起来。爬起来的次数多了，你对这套东西的理解就比只会点"一键升级"的人深一层。

这是 AI 时代普通人少数能建立的优势。

你升级 OpenClaw 2.0 了吗？踩了什么坑，评论区聊聊，我看看还有没有我没遇到的。

关于阿健

阿健，AI时代的普通人，公众号「2026阿健」主理人。不追风口，只动手。相信工具是折腾会的，不是看会的。不定期分享 AI 工具的实战体验和踩坑实录，欢迎关注，一起在 AI 时代笨拙但认真地折腾。