OpenClaw 2.0 升级指南:8 个新能力 + 2 个破坏性变更实测

OpenClaw 2.0 升级指南：8 个新能力 + 2 个破坏性变更实测

OpenClaw 2026.8.1 正式发布，官方口径的 2.0——933 位贡献者、16000+ PR，史上最大更新。升级前必读这篇实测报告：8 个新能力值不值得升，以及升级路上你会踩到的 2 个坑和解决方法。

这次更新来了什么？

官方称这次为 OpenClaw 2.0，是项目历史上规模最大的更新。933 位贡献者参与开发，其中 569 位是首次贡献；合并了超过 16000 个 PR，相当于 OpenClaw 历史上全部 PR 总量的一半左右。

团队花了两三个月时间做了一次大版本迭代，核心聚焦在八个方向：

• 会话搜索——按精确词句搜索对话历史，直接从搜索结果回到上下文消息。会话攒多了之后，这个是刚需。

• 跨设备/云端会话——把会话工作区搬到配对设备或云端 worker 上，暖机机器和项目种子可复用。相当于 agent 不再被绑死在一台机器上。

• 会话进度卡片——持久化的进度卡跨重载保留，子 agent 活动和累积编辑在 Web 和原生客户端都能跟踪。挂后台跑长任务时心里有数了。

• 私密凭据请求——agent 需要凭据时通过掩码提示输入，值不进聊天记录和模型上下文。可选代理把受保护密钥的替换限制在已批准目标。

• 自动化一次性授权——为精确操作授予自动化权限，事后可审查、可撤销，任务或操作变了要求重新批准。

• 更丰富的音视频——媒体在上传、生成回复、播放、重载全链路保持关联，Apple 和 Android 客户端支持原生播放控制和视频上传。

• 结构化提问——agent 的结构化问题通过卡片、按钮或纯文本回答，支持自由输入和显式跳过。交互不再是一问一答的聊天气泡。

• 交互组件与仪表盘——聊天里可以用 widget，钉到会话仪表盘，授予指定动作或网络来源，还能导出成图片。

除此之外还有：官方 provider 包改为按需安装；OpenAI 长上下文改为显式配置；前台并发按 CPU 自动伸缩；团队角色、共享凭据库、1Password broker 等偏团队/运维的能力也都进来了。

两个破坏性变更，升级前必看

这次更新有两个 breaking change，如果不处理直接升级，配置会被改坏。我踩了一下，整理如下：

变更一：OpenProse 插件移除

内置的 OpenProse 插件和 /prose 命令被移除了。升级后跑 openclaw doctor --fix 会清理残留配置。

处理方法：.prose 源文件会保留，按官方迁移指引走上游 Agent Skill 即可。如果你没有使用 OpenProse，这一步可以忽略。

变更二：OpenAI 路由迁移

所有 codex/*、openai-codex/* 的模型引用、provider 配置、存储会话和自动化路由会被迁到 openai/*。Codex 运行时意图保留，冲突会被标记出来等人工处理。

处理方法：运行 openclaw doctor --fix 自动迁移，大部分情况会自动完成。如果有冲突标记，需要手动决定走哪条路由。

关键提醒：9 月 1 日起有一波插件 SDK 子路径导入的弃用门槛。自己写了外部插件的，本周内把子路径导入迁到 openclaw/plugin-sdk/ 的新接口，免得下个版本直接不可用。

升级步骤与踩坑记录

我实测升级后遇到的坑和解决方法，整理如下：

坑一：升级后 OpenProse 插件失效

运行 openclaw update 后，终端弹出报错，提示 OpenProse 插件加载失败。跑 openclaw doctor --fix 清理残留配置，源文件保留，需要重新配置 Agent Skill。

坑二：模型路由配置冲突

之前用的 codex/* 前缀配置，升级后 doctor --fix 自动迁到 openai/*，但有几个冲突被标记需要手动处理。建议在升级前备份配置，升级后逐个检查冲突项。

坑三：插件 SDK 子路径导入警告

部分自定义插件使用旧版 SDK 子路径导入，升级后出现弃用警告。需要迁移到 openclaw/plugin-sdk/ 新接口，迁移指南见官方文档。

标准升级流程（照抄）：1. 备份配置：cp -r ~/.openclaw ~/.openclaw.bak-$(date +%F)2. 升级：openclaw update3. 迁移+清理：openclaw doctor --fix4. 验证：openclaw doctor5. 补装 provider：openclaw update repair6. 重启 Gateway：openclaw restart

升级建议：要不要升？

• 纯使用者：升级后体验是纯增益，会话搜索和进度卡片感知最强。默认会话跨天保留、自动自学习默认开启，注意这些默认值是否符合你的预期，不合适都有显式开关。

• 自托管玩家：这次的凭据掩码、共享凭据库、可恢复备份、外部监管模式基本是自托管党的刚需，生产化程度又上一档。可以升级，记得先备份。

• 插件作者：9 月 1 日 SDK 弃用门槛是硬时间点，本周内把子路径导入迁到 openclaw/plugin-sdk/ 新接口，否则下个版本直接不可用。

我的判断：这次的凭据安全设计是同类产品里少见的认真，自托管党可以放心把 agent 接进工作流了。2 个破坏性变更都有官方迁移通道，风险可控，但"先备份再 doctor --fix"这个顺序不能反。

关于"用 OpenClaw 构建 OpenClaw"

这次更新有个有趣的背景：团队两个月前启动了"用 OpenClaw 构建 OpenClaw"——全员迁移到共享 agent 上协作开发，多人编码 + 云端节点/会话的无限算力彻底改变了他们的开发方式。

这次 2.0 里的多人协作和云端会话能力，就是他们自己吃着狗粮做出来的。创始人 steipete 发推确认，团队的原话是"本地 coding harness 现在像老古董了"。

"用 OpenClaw 造 OpenClaw"本身就是这次更新最硬的实测报告——933 人、16000 个 PR 的开发过程全程跑在自己的多人协作架构上，出问题他们自己先炸，这比任何宣传都有说服力。

你的 OpenClaw 升级顺利吗？

• 升级过程中有没有遇到 doctor --fix 报迁移冲突？• 会话搜索、云端 worker、凭据掩码，哪个是你最想要的？• 你把 agent 接入工作流时，最担心什么？安全？成本？还是稳定性？

— END —

关注获取更多 OpenClaw 实战指南