OpenClaw 2026.8.2 发布解读:哪几处真有后果,升之前先做什么

历史版本说明：本文回顾 2026.8.2，封面上的 Latest 徽章与下方通道表是发布时的快照。现在准备安装或升级，各渠道指向哪一版见《OpenClaw 稳定版、测试版、长期支持版装哪个，更新渠道怎么切换》，最新稳定版改了什么见《OpenClaw 2026.9.8 更新内容与升级失败的处理办法》，升级步骤见OpenClaw 升级、回滚与彻底卸载。

当时的通道提醒：误发的 2026.9.1-beta.1 不宜安装

OpenClaw 在 npm 上挂了三条 dist-tag,2026-09-02 这天各自指向:

2026.9.1-beta.1 是官方误发的版本号。官方在那个 release 里挂了警告:这个包实际上是 2026.8.1-beta.4,不应该被理解为比稳定版 2026.8.1 更新,稳定版用户应该装或升到 2026.8.1。

这次误发说明，版本号大，不代表内容比稳定版新。2026-09-02 的稳定通道已经指向 8.2；今天动手前，看当前通道和已安装版本：

npm view openclaw dist-tags
openclaw --version

命令行的通道名和 npm 的 tag 不是一套词

你在 openclaw update 里填的通道名,和 npm 上的 dist-tag 是两套命名。

CLI 的 stable 对应 npm 的 latest；上表记的是 2026-09-02 的值。不要把 npm tag 名直接填成 CLI 通道名。今天怎么选择通道、如何预演升级，见升级指引。

--tag 和 --channel 差在记不记住

按官方文档,--channel 在核心更新成功之后会持久化,--tag 只影响这一次更新,不改策略。所以你为了试个东西一次性装了 beta,已保存的 update.channel 仍然管着后面的前台更新和自动更新,下次照旧按老通道走。想真换策略,只能用 --channel。

# 以下为历史版本示例，并非当前推荐安装目标
# 只这一次装某个确切版本,策略不变
openclaw update --tag 2026.8.2
# 换策略,之后都按这条通道走
openclaw update --channel extended-stable
# 看当前生效的是哪条通道
openclaw update status

还有一条限制:extended-stable 是 package-only 的通道,它那个经过校验的确切目标版本是强制的,因此 --tag 不能和生效中的 extended-stable 通道一起用。服务器挂着这条通道又想临时装某个版本的,会在这儿卡住。

拿不准选哪条,openclaw update wizard 会带你交互式选通道、并确认要不要重启;升坏了有 openclaw update repair,它也接受 --channel。想先看计划再动,--dry-run 会打印通道、tag、目标版本和重启流程,不写配置、不安装、不同步插件、也不重启。要把结果喂给脚本,--json 输出的 UpdateRunResult 里带 postUpdate.plugins.warnings(托管插件需要修复时)和 postUpdate.plugins.integrityDrifts(检测到 npm 插件产物漂移时),走 beta 通道还会带插件回退的详情。

两条破坏性变更，决定了你的升级顺序

2026.8.1 带了两条 breaking change,迁移方式是同一条命令。

一,内置的 OpenProse 插件连同 /prose 命令被移除。官方给的处置是:跑 openclaw doctor --fix 清掉失效的配置,再按官方的 Agent Skill 迁移指引把功能接回来;已有的 .prose 源文件会保留,不会被删。

二,OpenAI route 迁移。同样走 openclaw doctor --fix。

# 升完立刻跑这一条,别等它自己好
openclaw doctor --fix

后果分两类。明面上那类是配置里还留着 OpenProse 的段落,升上来就成了失效配置,doctor 认得出来。隐蔽的那类更麻烦:你在某个 skill、某段自动化、某个定时任务里写死了 /prose,那条链路升完就断,而且不一定当场报错给你看,可能是某天早上发现产出没出来。升级前在工作区里搜一遍 prose 这个词,比升完慢慢排划算。

把 OpenProse 迁成 Agent Skill,写法跟装第三方 Skill 是同一套。不熟的话先看给龙虾装第一个 Skill,再对着官方的迁移页改。

2026.8.2 的升级过程改了什么：失败后自动恢复 Gateway

2026.8.2 的 Highlights 里有一条叫「更安全的升级」,拆开是三件事:保留较新的配置;在宣告成功之前中止没做完的会话迁移;升级失败之后,当已安装的包或者回滚被验证是安全的,再把之前停掉的 Gateway 恢复起来。

三件针对的是同一种情况:升级跑到一半挂了,Gateway 停在那儿不回来。第三条把「恢复 Gateway」放在了「验证安全」之后。

配套还有一条清理命令:

# 先看它打算删什么
openclaw update cleanup --dry-run

它列出迁移过程中留下的原始文件,你看过之后再显式删除,而且删的时候所选的 Gateway 得处于停止状态。这个前置条件是有意加的限制,别绕。

新版把失败恢复做得更周到,备份照样要做:升级前 openclaw backup create --verify 打一份归档、openclaw --version 记下当前版本号。回滚和卸载的完整走法见OpenClaw 升级、回滚与彻底卸载。

Linux 桌面端：x86-64 的 .deb 和 AppImage

2026.8.2 给 x86-64 Linux 补上了桌面客户端:装 .deb 或者 AppImage,连本地或者远端的 Gateway,从系统托盘或者 X11 快捷键开 Quick Chat。更新方式两种装法不一样——AppImage 的更新经过签名校验,.deb 仍然归你的包管理器管。官方文档页是 docs.openclaw.ai/platforms/linux。

Gateway 跑在云服务器上的,桌面端可以直接连过去。服务器那头怎么跑,看云服务器部署 OpenClaw;三个平台的装法在本地部署教程里。

两处边界别自己脑补:官方点名的是 x86-64,ARM 机器(树莓派、ARM 云主机)这次的说明里没提;快捷键那句写的是 X11,Wayland 桌面下什么行为官方没写。装之前先确认机器和桌面环境对得上,不然快捷键不响会以为是自己配坏了。

2026.8.2 修了哪些行为：回答收尾、语音、浏览器控制

2026.8.2 里有一组是修行为的:

• 回答能收尾了。官方的说法是:工具活干完之后返回最终答案,并且在已接受的轮次之后暴露失败。工具真调不动的情况,排查顺序看工具调用失败排查清单。
• 语音更稳。三件:把内部推理挡在语音之外(不再把思考过程念给你听)、保住工具生成的音频、通话建立之后后续的 browser Talk 轮次仍然可用。
• Home agent 能停靠在侧边。Cmd/Ctrl+Shift+H 把它开到右侧或者底部,当前页面保持可见;它抓走的工作上下文快照可以预览、也可以移除,还能把你选中的一段文字附给消息。看得见它拿了什么、并且能把不想给的那份撤掉,这点比多一个侧边栏重要。
• 没跑 Gateway 也能控浏览器。受支持的 macOS/Linux Chrome 扩展构建可以唤醒配对的本地 relay,给已经认证过的 CDP 客户端用。前提官方也写了:要更新过的 native host,以及带 relay 唤醒支持的扩展构建,缺一个都不成。浏览器自动化那条线的基础用法在用 OpenClaw 抓网页：内置 browser 工具怎么用，要不要另装 Skill。
• 四个新外观:CRT、Manuscript、Rosé、Miami。主题选择离线也保留,重载时不再闪一下错的主题。

安全相关的两条：私密凭据请求和重复操作只批一次

2026.8.1 里有两条是冲着「权限交出去之后怎么收得回来」去的。

私密凭据请求。agent 通过打码的提示向你要凭据,值不会进聊天记录,也不会进模型上下文;另有一个可选开启的代理,把受保护密钥的替换限制在批准过的目的地。

重复性工作只批一次。给某个确切的操作授予自动化权限,之后可以查看、也可以吊销;作业或者操作一旦变了,就要求重新批准。

风险大小主要还是看你给它开了多大的目录范围、能不能执行任意 shell,这一层怎么配见沙箱、白名单和网关认证怎么配。之后的版本还改了两处默认值:2026.9.2 起会话默认跨 agent 可见,2026.9.5 起本地 onboarding 在没设过 profile 时默认选 Full 工具,收窄的写法在同一页。

会话可以跑在配对设备和云端 worker 上

这组改动横跨两版:

• 会话跑到 Gateway 之外(8.1):会话可以在配对设备或者云端 worker 上跑,会话工作区跟着走;后续的云会话还能复用热机与项目种子。
• 不切页就开工(8.2):在 New Session 里直接创建并运行后台会话,它选定的本地、云端或者配对设备位置会被保留,跑完从提示里点开。
• 会话搜索(8.1):按精确的词或者短语搜可见的对话文本,从命中的结果重开上下文。
• 进度看得见(8.1):会话进度卡跨重载保持,能跟看子 agent 的活动和累积的改动。

还有一组是交互形态的变化:结构化提问(网页或原生卡片、消息按钮、纯文本作答,带自由文本备选和明确的 Skip)、聊天里的交互式 widget(可以钉到会话仪表板,可以只授予特定动作或网络来源,渲染结果能导出成图片),以及音视频在上传、生成回复、播放、重载之间都留在对话里,Apple 与 Android 客户端支持原生播放控件和视频上传。这些不改你的配置,看一眼知道有就行。

2026.8.2 发布时，哪些情况该升

动作顺序建议这样走:

1. 在工作区里搜一遍 prose,看有没有写死的调用。
2. openclaw --version 记下当前版本号,openclaw backup create --verify 打一份备份。
3. openclaw update --dry-run 先看它打算做什么,再真升。
4. 升完立刻 openclaw doctor --fix。官方给那两条破坏性变更指的迁移方式就是它,别指望升级过程替你做完。
5. 跑一条你平时最常跑的任务验一遍,再用 openclaw update cleanup --dry-run 看看要不要清残留文件。
6. 出现问题先保留更新报告与备份。降级包不会逆转数据迁移，是否能退回旧版要先做兼容检查，见升级、回滚与彻底卸载。安装报错对照看装不上?报错对照。

官方资料:官方 Releases 页、update 命令文档、Linux 桌面端文档、OpenProse 迁移指引。

常见问题

npm 上的 2026.9.1-beta.1 是不是比 2026.8.2 新？

不是。2026.9.1-beta.1 是当时有官方误发警告的包，内容对应 2026.8.1-beta.4。今天的 beta 通道指向哪一版，运行 npm view openclaw dist-tags 看。

从 2026.7 升上来，一定要跑 openclaw doctor --fix 吗？

要。2026.8.1 带了两条破坏性变更,内置的 OpenProse 插件连同 /prose 命令被移除,还有 OpenAI route 的迁移,官方给这两条指的处置方式都是 openclaw doctor --fix,它会清掉失效的配置。跑完之后 OpenProse 的功能还要按官方的 Agent Skill 迁移指引接回来,这一步 doctor 替不了你。

/prose 没了，我以前写的 .prose 文件白写了吗？

没白写。官方明说已有的 .prose 源文件会保留。没了的是内置插件和 /prose 这个命令,功能要按官方的迁移指引改成 Agent Skill 的形式接回来。真要留意的是写死了 /prose 调用的地方,比如 skill、自动化脚本、定时任务,升完这些链路会断,而且不一定当场报错。升级前在工作区里搜一遍 prose 这个词最省事。

服务器上的机器要不要跟这一版？

现在不该再装 8.2，装当前稳定版。各渠道现在指向哪一版、服务器该走哪条渠道，见《OpenClaw 稳定版、测试版、长期支持版装哪个，更新渠道怎么切换》。

Linux 上怎么装桌面端？

官方这次给的是 x86-64 Linux 的 .deb 和 AppImage 两种装法,装完可以连本地或者远端的 Gateway,从系统托盘或者 X11 快捷键开 Quick Chat。更新方式分两套:AppImage 的更新经过签名校验,.deb 仍然由你的包管理器管。官方文档在 docs.openclaw.ai/platforms/linux。ARM 机器和 Wayland 下的快捷键行为,官方这次的说明里没写。