版本 · 解读

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

钳叔 · 龙虾AI 编辑部 · 2026-09-02 发布 · 2026-09-02 更新 · 约 8 分钟

OpenClaw 的最新稳定版是 2026.8.2,2026-09-01 发布。上一个稳定版 2026.8.1 发在 2026-08-31,两版只隔一天。这篇不逐条翻译官方的发布说明,只挑对自己装、自己维护的人真有后果的几处讲。最要紧的两句放最前面:一,你在 npm 上看到的 2026.9.1-beta.1 不是比稳定版更新的版本,官方自己挂了警告;二,从 2026.7 或更早升上来的,openclaw doctor --fix 不是可选项,2026.8.1 带的两条破坏性变更要靠它迁移。

因为 8.1 和 8.2 中间只隔一天,大多数人是一步跨过两版,所以下面按「你升完会拿到什么」来组织,每条标明出自哪一版。全文按官方仓库的发布说明和官方文档整理,链接放在文末,以你打开时官方页面显示的为准。

先说通道:npm 上那个 2026.9.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。

坑在于版本号长得像日期。9.1 看着比 8.2 大,npm 又不会替你纠正。最容易发生的一幕是:有人瞄一眼 npm 页面看到 9.1,以为自己该装那个,结果按官方的说法,那个包的内容落在 8.1 之前——往回走了一步,还顺手进了 beta 通道。现在稳定通道已经推到 2026.8.2,什么都不用想,走 latest 就是最新的。动手前确认一眼:

npm view openclaw dist-tags
openclaw --version

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

第二层容易混的地方在这儿:你在 openclaw update 里填的通道名,和 npm 上的 dist-tag 是两套命名。

记一句就够:CLI 的 stable 对应 npm 的 latest,当前都指向 2026.8.2。CLI 里没有 latest 这个通道名,npm 上也没有 stable 这个 tag——看到有人写 --channel latest,那是记混了。站内升级那篇讲的「默认 stable、服务器建议 extended-stable」,说的是 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 的 Highlights 里有一条叫「更安全的升级」,拆开是三件事:保留较新的配置;在宣告成功之前中止没做完的会话迁移;升级失败之后,当已安装的包或者回滚被验证是安全的,再把之前停掉的 Gateway 恢复起来。

三件针对的是同一种翻车——升级跑到一半挂了,Gateway 停在那儿不回来,你还以为升成功了。第三条尤其值得注意:它把「恢复 Gateway」放在了「验证安全」之后,而不是无条件重启一个可能半残的版本。

配套还有一条清理命令:

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

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

Linux 终于有桌面端了

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

「连远端 Gateway」这半句是重点。不少人是把 Gateway 跑在一台云服务器上,本地只有终端和浏览器;现在桌面端能直接连过去,喊一句话不用再开一层 SSH。服务器那头怎么跑,看云服务器部署那篇;三个平台的装法在本地部署教程里。

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

这几条修的是你以前会当成 bug 去查的毛病

2026.8.2 里有一组是修行为的,标题看着淡,但每条都对应一种排障时的困惑。

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

安全那两条,值得回头把配置再收一收

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

私密凭据请求。agent 通过打码的提示向你要凭据,值不会进聊天记录,也不会进模型上下文;另有一个可选开启的代理,把受保护密钥的替换限制在批准过的目的地。说人话:以前给它一个 token 只能贴进对话里,贴完那个 token 就躺在会话历史和上下文里了,现在有条不落地的通道。

重复性工作只批一次。给某个确切的操作授予自动化权限,之后可以查看、也可以吊销;作业或者操作一旦变了,就要求重新批准。价值在后半句——授权绑的是「这个确切操作」,不是「这类操作」,所以它不会被悄悄扩大。

这两条是机制,不是免死金牌。真正决定风险大小的还是你给它开了多大的目录范围、能不能执行任意 shell。这一层怎么配,安全与沙箱那篇写过一遍,升完可以照着回头再过一遍。

会话不再绑死在一台机器上

这组横跨两版,合起来看才完整。

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

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

该不该升,对号入座

动作顺序建议这样走:

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. 不对劲就退回你记下的那个版本号。回滚步骤在升级、回滚与彻底卸载那篇,升级过程中的报错对照看装不上?报错对照。

这篇没法替你回答的

• 官方这次没给任何性能数字或者兼容性矩阵,所以「升完会不会更快」这类问题,这里不编答案。
• ARM 架构的 Linux、Wayland 桌面下的快捷键行为,官方说明里都没写,本站也没有可核实的信息。
• 本站没有做过这次升级的实机记录。以上全部是按官方发布说明和文档整理的判断,不是实测结论;你的机器上会不会遇到别的情况,只有自己跑一遍才知道。

时效声明:版本号、发布日期、dist-tag 指向、通道参数和变更清单,都是 2026-09-02 从官方仓库、官方文档和 npm 上核的。这个项目发版很快,一天两版都出现过,动手前请自己再对一眼——官方 Releases 页、update 命令文档、Linux 桌面端文档、OpenProse 迁移指引。跟本站写的对不上,以官方页面当时显示的为准。

常见问题

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

不是。官方在那个 release 里挂了警告,说这个包实际上是 2026.8.1-beta.4,不应该被理解为比稳定版 2026.8.1 更新,稳定版用户应该装或升到 2026.8.1。它是一次误发的版本号,日期式的 9.1 看着比 8.2 大,内容却落在 8.1 之前。现在 latest 这条 dist-tag 指向 2026.8.2,普通用户走 latest 就行,不用管 beta 那条上挂的数字。

从 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 这个词最省事。

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

不急着跟。2026.8.1 和 2026.8.2 之间只隔一天,让新版本在别人的机器上多跑几天没坏处。想更保守就锁到 extended-stable,命令是 openclaw update --channel extended-stable,--channel 会被记住,以后的更新都按这条走;代价是它现在还停在 2026.6.34,按版本先后推,8.1 和 8.2 这两版的东西都还没轮到它,包括 Linux 桌面端和升级失败恢复,而且这条通道下 --tag 用不了。真要升,先备份、记下当前版本号,升完立刻跑 doctor --fix。

Linux 上怎么装桌面端?

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