OpenClaw 在 2026 年 9 月 8 日 发布了 v2026.9.3 版本(由维护者 steipete 签名发布)。这是一个以「更安全的更新机制、性能优化与协作/分享能力」为核心的功能版本,重点引入了更新前的隔离预演(rehearsal)机制、会话公开分享、可搜索会议库与可选团队报告,同时包含若干破坏性(Breaking)变更需要重点关注。
核心亮点
- 更安全的更新(Safer updates):在激活前,可在隔离的候选状态中对核心与插件变更进行「预演(rehearsal)」;支持符合条件的 2026.9.2 迁移;并能在无需停止健康网关的情况下恢复被遗弃的更新记录。
- 性能提升:保留预热提示缓存(prompt cache),减少冷启动会话更新与内存搜索中的冗余工作,并在多个会话间复用 worker 构建。
- 技能工坊(Skill Workshop):技能现归属于单一、跨工作区持久的「智能体所有」集合,支持对比完整技能指令,并可通过 Doctor 安全地淘汰缺失草稿的建议。
- 浏览器标签页(实时与原生):可实时观看智能体页面重绘,并在 macOS 上以原生标签页打开外部链接,且标签页在切换聊天时仍保留在其窗口内。
- 提供商账户统一管理:可直接在「Models 设置」中管理已连接的账户及其优先级。
- 分享所选会话:可显式发布某个会话现有及未来对话文本的可撤销只读视图,任何持有公开链接的人都可访问。
- 可搜索的会议库:浏览已保存笔记、全文检索转录内容、下载完整的 Markdown 或 JSONL 归档,并在 Control UI 中管理采集源。
- 可选团队活动报告(Team Reports):安装并启用后可浏览经身份验证的 GitHub 活动及显式配置的 Discord 讨论,含历史记录存储与可选的模型摘要。
破坏性变更(升级前必读)
- Node 运行时要求:需 Node 24.16.0+(24.x)或 Node 26.1.0+,推荐 Node 26。必须在升级 OpenClaw 前先升级 Node,以防 SQLite 文本截断。Node 22、Node 25 及更早的 24.x/26.x 均不再支持。
- execution-policy SDK:原
infra-runtime中已废弃的 exec-mode 与比较器辅助函数迁移至openclaw/plugin-sdk/agent-harness-runtime的execPolicy,改用resolveExecModePolicy。 - approval SDK:账户解析辅助函数需从
approval-native-runtime导入,会话过滤需适配完整的matchesApprovalRequestFilters契约。 - SDK 别名:
channel-inbound.buildChannelTurnMediaPayload更名为buildChannelInboundMediaPayload;移除具名类型AbortAndDrainAgentHarnessRunResult(改为推断其返回结果)。 - 搜索结果回调:Find/Grep 的受限文本改从
details.content读取,而非details.truncation.content。 - 目录结果回调:改用
LsToolDetails.content与可选的nextAfter(替代已废弃的truncation与entryLimitReached)。 - 智能体所有的 Workshop 技能:以「每智能体单一可写集合」取代工作区所有权,废弃
skills.workshop.allowSymlinkTargetWrites;启动及openclaw doctor --fix会自动迁移旧技能。
主要功能变更
- 受限更新修复:候选校验失败可在一次性预演状态中借助配置的推理进入受限修复阶段,仅经独立验证后激活;无法恢复时保留失败或回滚结果。
- 代码模式(Code Mode):在快速工具回复间保留运行中的 JavaScript 环境,新增可选 TypeScript 检查、原始源码错误定位,并提供沙箱化、可跨等待/恢复存活的
TextEncoder/TextDecoder。 - 仓库驱动的云会话:可从仓库 URL 与 ref 创建带检出、setup 及可恢复检查点的会话。
- 提供商账户控制 / 模型回退选择器:可从可搜索下拉框中选择有序回退模型,支持移除选项与自定义引用。
- 移动端与桌面端:iOS 语音快捷指令、Android 折叠屏布局适配、原生嵌入式设置、ARM64 Linux AppImage 打包、Apple Watch 语音设置。
- CLI 与诊断:
openclaw docs --limit限制文档结果、默认展示支持创建的 CLI 智能体、暴露 GC 时长指标、捆绑openclaw-mac网关控制 CLI。 - Telegram 相册:将连续的符合条件照片归入最多十张的原生相册,保留顺序、说明与回复目标。
主要修复
- 更新恢复与回滚:无需停止健康匹配的网关即可恢复被遗弃的更新记录;在隔离候选副本(含链接与工作区提升依赖)中预演,激活前拒绝不兼容的智能体存储。
- authored 配置保留:在 setup、更新、Settings 保存及 Doctor 迁移中保留用户编写的设置、环境/密钥引用与省略的默认值。
- 网关维护与重启:普通失败重启仍可在前台恢复,但当迁移或必需维护阻塞启动时停止重启循环。
- 会话响应性:在完整性检查期间保持会话编辑响应、释放恢复工作树时的写入者、避免跨智能体初始化与回收锁失败、降低冷目录卡顿。
- 技能工坊恢复:通过 Doctor 淘汰缺失草稿建议,同时保留已安装技能与恢复证据。
- 私有运行时上下文:区分用户输入与网关运行时上下文,并从频道推理预览中剥离内部标记。
- MCP 会话连续性 / 对话持久性:让会话所有 MCP 服务器在回合间存活;以原子方式发布转录重写,避免中断暴露部分历史。
影响评估
| 类别 | 影响描述 |
|---|---|
| 运维稳定性 | 更新前隔离预演 + 受限修复 + 回滚判断,大幅降低「更新把系统搞坏」的风险,是面向生产环境的核心安全网。 |
| 升级风险 | ⚠️Node 版本为硬性门槛,未先升级 Node 可能导致 SQLite 文本截断;插件开发者需按多项 SDK 破坏性变更迁移代码。 |
| 性能 | 预热缓存保留与 worker 复用可减少重复计算,改善长会话与内存搜索的延迟与成本。 |
| 协作与分享 | 会话公开分享、会议库、团队报告使 OpenClaw 从「个人助理」向「团队协作/知识沉淀」延伸。 |
| 多端体验 | iOS 快捷指令、Android 折叠屏适配、macOS 原生标签页与 Linux ARM64 打包,进一步拓宽了平台覆盖。 |
升级建议
- 所有用户:建议升级,以获得更安全的更新机制与性能改善;但请先确认 Node 已升级到 24.16.0+ 或 26.1.0+(推荐 26)。
- 插件/SDK 开发者:⚠️ 务必先阅读并适配破坏性变更(Node、execPolicy、approval SDK、SDK 别名、搜索/目录回调、Workshop 技能所有权),否则可能出现启动或编译失败。
- 团队协作 / 知识管理场景:可重点评估「会话分享」「可搜索会议库」「Team Reports」三项新能力。
- 生产环境:本次「隔离预演 + 回滚」机制对无人值守更新价值显著,建议启用更新前的候选验证流程。
提示:本次更新包含较多 Breaking Changes,与往轮以修复为主的版本不同,升级前请优先处理 Node 运行时与 SDK 迁移,避免升级后出现 SQLite 截断或插件加载失败。