一、版本核心定位与升级背景
- 一回归:重磅恢复并重构了社区呼声最高的 Task Flow 核心编排系统,补齐了长周期、复杂自动化任务的核心执行能力;
- 二新增:新增 Android 原生助手入口、飞书全链路评论协作流两大核心能力,分别拓展了移动端交互边界与企业级协作场景深度;
- 三硬化:通过 30 + 安全修复、架构路径标准化、Provider 传输策略集中化,构建了从插件加载到执行环境的纵深防御体系,为生产环境部署筑牢安全基座。
二、破坏性变更(Breaking Changes)
- xAI 搜索配置路径重构
x_search 相关配置从旧版
core.tools.web.x_search.*路径,完整迁移至插件专属的plugins.entries.xai.config.xSearch.*路径;同时标准化认证方式,统一使用plugins.entries.xai.config.webSearch.apiKey或XAI_API_KEY环境变量,解决了此前配置分散、多场景维护混乱的问题。 - Firecrawl 与 web_fetch 配置迁移
Firecrawl 相关配置从
tools.web.fetch.firecrawl.*路径,迁移至plugins.entries.firecrawl.config.webFetch.*路径;web_fetch fallback 统一走全新的 fetch-provider 边界,不再使用 firecrawl 专属核心分支,实现了网页抓取能力的可插拔切换与配置集中化管理。
升级后执行openclaw doctor --fix,即可自动完成两项配置的全量迁移,避免手动修改出现格式错误。
三、核心新增特性深度解析
(一)最重磅更新:Task Flow 核心编排系统重构回归
- 双模式任务流同步机制
恢复 Core Task Flow Substrate 底层引擎,支持managed 托管模式与mirrored 镜像模式两种同步模式。托管模式由 OpenClaw 主进程全权控制执行流程,适合单机自动化场景;镜像模式允许外部编排器同步追踪执行状态,可与 K8s、Airflow 等企业级调度系统深度集成,拓展了集群化部署的能力边界。
- 任务状态持久化与断点续跑
新增流程状态快照与修订版本追踪能力,每次任务流执行都会实时记录状态快照,即使进程重启、服务器宕机,也能从指定检查点恢复执行进度,彻底解决了此前版本 “进程重启任务就蒸发、中断后无法续跑” 的痛点,完美适配长周期、高可靠的自动化任务场景。
- 专属管控工具与开放 API
新增
openclaw flows专属命令集,支持查看运行中任务状态、历史执行记录、失败任务诊断,以及从指定检查点一键恢复任务;同时开放api.runtime.taskflow插件绑定接口,插件可直接在 OpenClaw 上下文中创建和管理托管任务流,开发者可基于此快速定制专属工作流模板。 - 精细化子任务管控机制
新增 managed 子任务生成机制与 sticky cancel intent 粘性取消指令,外部编排器可立即停止新任务调度,同时让父级任务流在活跃子任务完成后平滑过渡到取消状态,避免强制中断导致的任务数据损坏、资源泄漏问题,大幅提升任务流执行的可控性与容错率。
(二)全平台交互边界扩展:移动端与 IM 渠道体验全面升级
- Android 原生助手深度集成
新增 assistant-role 入口点与 Google Assistant App Actions 元数据,支持从 Android 系统语音助手直接触发 OpenClaw,可将语音提示词直接传入聊天界面并启动对应任务;同时修复了 Android 端 Talk Mode 语音消息接收异常、渲染错误的问题,实现了移动端 “语音唤醒 – 指令传递 – 任务执行 – 结果反馈” 的全链路闭环36氪。
- 全 IM 渠道能力补全与优化
- 飞书:深度完善评论协作流,实现飞书文档评论线程全解析、线程内精准回复、评论增删改 / 标记已解决全链路支持,同时保留飞书作用域继承能力,让 AI 智能体深度融入文档协作流程,解决了评论与正文割裂、协同效率低的核心痛点。
- Telegram:修复群组审批请求跳转异常问题,审批请求固定在原话题内,不再跳转至根聊天;新增可配置错误冷却策略,精准抑制重复投递错误,提升长会话场景的稳定性36氪。
- Slack:实现审批请求全链路闭环,命令执行的审批请求可全程在 Slack 内完成,无需跳转网页或终端,大幅提升企业办公场景的使用便捷性36氪。
- LINE 与 QQ Bot:新增官方捆绑插件支持,LINE 平台补齐图片、视频、音频的出站发送能力,全面适配国内与海外主流即时通讯平台36氪。
- 桌面端体验持续优化
延续并优化 macOS Voice Wake 语音唤醒能力,修复后台监听异常、唤醒准确率波动的问题;同时优化空闲状态展示逻辑,明确区分 “任务等待中” 与 “系统卡死” 状态,解决了用户对后台任务状态的感知盲区。
(三)企业级核心升级:安全架构全面硬化,从被动修复到主动防御
- 新增插件 / 技能代码安全扫描器
引入内置的 Code Safety Scanner,在第三方插件 / 技能安装、加载时自动执行代码级安全审计,可精准识别 API 密钥泄露、恶意网络调用、沙箱绕过、权限越界等高危安全漏洞,默认拒绝加载存在高危风险的插件,从源头堵住第三方生态的安全入口,实现 “事前防御 – 事中拦截 – 事后审计” 的全链路安全管控。
- 执行环境安全全面加固
重构 exec 执行策略,默认开启
security=full全量安全防护,同时默认关闭交互式确认(ask=off),既实现普通命令的无感执行,又通过沙箱机制严格限制高危操作,解决了此前 “默认权限过高有安全风险,每次确认又影响使用体验” 的矛盾;同时禁止覆盖关键系统环境变量,修复 Windows 系统白名单执行逻辑,彻底堵住环境变量注入、沙箱绕过的安全漏洞。 - 网关认证与网络安全硬化
重构网关 trusted-proxy 模式,拒绝同时使用共享令牌的混合配置,本地直连回退不再隐式放行同一主机的调用者,必须提供明确配置的令牌,彻底解决未授权访问的风险;同时统一 HTTP、WebSocket 全路径的认证、代理、TLS 处理逻辑,修复了多项 HTTP 请求走私、SSRF 防护绕过的高危漏洞36氪。
- 精细化合规管控能力升级
新增
beforeAgentReply插件钩子,插件可在 AI 回复用户前截断消息流、插入合成回复,实现合规内容审核、敏感信息脱敏、自定义话术替换等企业级合规管控需求;同时延续并优化定时任务工具白名单能力,支持为单个定时任务配置专属工具权限,落实最小权限原则。
(四)模型与插件生态扩展:适配边界持续拓宽
- 主流与国产模型原生适配升级
新增 Anthropic Claude 3 Opus 4.6、OpenAI GPT-5.3-Codex、xAI Grok 的原生支持,默认模型升级为 GPT-5.4,开箱即用最新大模型能力;持续完善国产大模型适配,为 Z.AI 提供商新增 GLM-5.1、glm-5v-turbo 模型原生支持,优化中文场景的语义理解与任务执行效果;同时为 Amazon Bedrock 新增 Guardrails 安全护栏深度适配,拓展金融、政务等强合规场景的应用边界。
- 插件与工具生态全面优化
官方插件市场新增技能(Skill)分类支持,可直接搜索场景化技能模板一键安装启用,大幅降低普通用户的使用门槛;内置 SearXNG 开源隐私搜索引擎支持,可直接对接自建私有实例,无需额外安装插件,实现完全自主可控的网页搜索;浏览器 CDP 能力新增 MCP 协议支持,可直接连接本地浏览器实例,解决了此前浏览器重连异常的问题。
- 模型调度与容错机制优化
完善故障转移(Failover)机制,优化同提供商认证配置重试上限与跨提供商模型回退逻辑,新增限流后认证配置轮换冷却时间自定义能力,解决了高并发场景下 “无限重试、调度混乱” 的问题,提升模型调用的稳定性与成功率。
(五)开发者体验与系统稳定性优化
- 统一上下文压缩模型配置,确保全场景压缩逻辑一致,优化网关聊天历史管理,新增全局与单请求双重字符数控制,解决长会话导致的内存占用过高、Token 消耗过大的问题;
- 修复任务网关 SQLite 同步压力下的事件循环阻塞、网关配置重载导致的无限重启循环、内存泄漏等 20 + 项底层稳定性问题,系统长时间运行的可靠性大幅提升;
- 完善
agents.defaults.params全局默认参数配置,所有未单独配置的智能体可自动继承全局参数,大幅简化多智能体场景的配置工作量;优化 Docker 镜像启动速度,降低部署门槛。
四、核心问题修复汇总
- 安全类修复:30 + 项安全漏洞修复,覆盖插件加载安全、执行环境沙箱、网关认证、SSRF 防护、凭证泄露防护等多个维度,彻底修复了 CVE-2026-25253 相关的衍生安全问题,杜绝了错误信息泄露敏感凭证的风险。
- 渠道类修复:修复 Discord、Telegram、WhatsApp、飞书、Matrix、QQ 等全渠道消息处理异常、断连重连失败、会话路由错乱等 10 + 项问题,多渠道集成的稳定性大幅提升。
- 系统稳定性修复:修复子智能体任务注册表写入失败导致的网关崩溃、任务状态意外丢失、会话内存索引重启后数据丢失、事件循环阻塞等 15 + 项底层问题,系统容错能力显著增强。
- 体验类修复:优化任务状态展示逻辑,隐藏已完成的过期后台任务,优先展示活跃任务;修复插件安装强制覆盖参数失效问题;修复相对媒体路径解析失效问题,确保会话重启后附件引用依然有效。
五、升级建议与避坑指南
- 升级前置操作:升级前务必备份配置文件(config.yaml)、任务数据与密钥存储,避免配置迁移导致的业务异常。
- 配置迁移操作:从 v2026.4.1 及之前版本升级的用户,升级后必须执行
openclaw doctor --fix完成 xAI 与 Firecrawl 配置的自动迁移,不建议手动修改配置。 - 安全配置核对:公网部署、企业级生产环境用户,需重新核对网关认证配置、exec 执行权限、插件安全扫描开关,新版本默认收紧了安全策略,需确保业务所需权限已正确配置,避免任务执行失败。
- 任务流适配:此前使用自定义 Task Flow 的用户,需基于新的 Task Flow API 完成适配,旧版任务流接口已废弃,可通过
openclaw flows doctor诊断并修复任务流配置问题。 - 平台适配注意事项:Windows 系统用户需注意,新版本重构了密钥存储机制,API 密钥需通过终端引导配置,避免直接在 Web UI 填写导致的格式错误;ARM 架构、Docker 部署用户,建议直接拉取最新官方镜像,避免手动编译导致的依赖缺失












