升级OpenClaw 4.12踩坑实录:这几个问题提前知道

每次大版本升级，总有人踩坑。

4.12 也不例外。这篇把最容易遇到的问题整理出来，帮你提前绕开。

坑一：升级后 Discord 配置被 doctor --fix 改坏了

症状：运行 openclaw doctor --fix 之后，Discord 频道突然无法正常工作，手动看配置文件发现结构不对。

原因：旧版本 Discord 的 streaming 配置是扁平结构，4.12 之前的 doctor --fix 会错误地把它转换成新的嵌套格式，破坏旧格式兼容性。

解决方法：

或者直接重新运行配置检查，不要用 --fix：

注意：4.12 已经修了这个问题，但如果你在升级过程中跑了旧版本的 doctor --fix，需要手动检查配置。

坑二：Dreaming 任务跑了两遍

症状：Dreaming 日记重复生成，记忆里出现两条一样的内容，或者心跳任务执行了两次。

原因：旧版本的 Dreaming 模块对「心跳事件」的消费没有做幂等保护，同一个事件可能被处理两次。

解决方法：升级到 4.12 即可自动修复。如果升级后仍然出现：

同时检查 DREAMS.md 里是否有重复的日记条目，手动删除重复项即可。

坑三：Active Memory 开启后响应变慢

症状：开启新的 Active Memory 插件后，每条消息回复明显变慢了，因为多了一个记忆检索步骤。

原因：Active Memory 在主回复之前会先起一个子代理做记忆检索，这是正常行为，但如果记忆库很大或者模型较慢，延迟会比较明显。

优化方法：

如果不需要主动记忆，可以直接关闭：

坑四：LM Studio 接入后模型列表为空

症状：配置了 LM Studio provider，但 /status 里看不到本地模型，或者模型列表是空的。

原因：LM Studio 需要在软件里手动启动「本地服务器」，默认端口 1234，且需要至少加载一个模型。

解决方法：

坑五：升级后 openclaw update 命令报错

症状：运行 openclaw update 出现类似「Cannot find module dist/install.runtime-xxx.js」的错误。

原因：自更新之后，老的缓存 chunk 路径失效，需要从新入口重新启动。

解决方法：

这个 bug 在 4.12 里已经修复，以后 openclaw update 会自动从更新后的入口重启。

坑六：Memory wiki 中文标题目录冲突

症状：memory wiki 里有中文标题的条目，升级后发现部分条目消失，或者文件名变成乱码。

原因：旧版本对 Unicode 文件名的处理有 bug，中文字符在 slug 化过程中会被截断或溢出路径限制。

解决方法：升级到 4.12 会自动修复新写入的条目。已有的损坏条目：

升级前的标准操作流程