本页面记录 OpenClaw 每个版本的更新内容,持续维护。
v2026.6.9
2026-06-21
新功能
- Telegram 富文本投递:Telegram 频道支持发送富 HTML、保留富 Markdown 与贴纸路径、渲染进度草稿与命令输出、安全规整 HTML 表格,保持提及与缓冲处理器在正确投递路径上
- Agent 恢复增强:重试、终端结果、压缩后使用量、会话历史修复与回复协调更加可靠,中断或部分轮次能持续推向可见的最终结果
- Codex 集成增强:Codex 新增自动插件审批、GPT-5.3 Spark OAuth 路由、远程节点 exec 动态工具、更稳定的 app-server 清理与终端结果
- 官方 Provider 独立插件:外部 Provider 包升级为一线 npm 发布,外部安装的频道插件在 Gateway 启动时加载,StepFun 可从 npm 和 ClawHub 安装
- Web 客户端升级:Control UI 新增会话工作区侧栏和扩展健康状态,iOS 新增 Watch 控件,Android 显示聊天上下文
- 搜索与技能增强:Codex Hosted Search 可用,免密钥搜索 Provider 保持显式选择加入,ClawHub 技能安装保留验证来源溯源
优化
- Provider 与认证:新增 Codex Hosted Search,改进 Gemini CLI OAuth 代理支持,外部 Provider 引导保持当前选择与包元数据
- 插件与安装:外部化官方 Provider 发布为独立 npm 包,Gateway 启动时发现已安装频道插件,StepFun 支持 npm 或 ClawHub 安装
- 仪表盘与移动端:添加会话工作区侧栏、状态页插件健康、紧凑 Cron 列表、iOS Watch 控件
- Codex 与可观测性:添加自动插件审批与 SecretRefs,保留 ClawHub 技能溯源,新增 OpenTelemetry 日志导出,节点连接时暴露远程执行能力
- QA 与发布工程:QA 场景改用 YAML,扩展 Profile 证据与插件/频道矩阵发布覆盖
修复
- 安全与隐私:从调试/配置输出中脱敏密钥、阻止内部 HTTP 会话覆盖、审计开放 DM 工具暴露、保留插件写入权限检查
- Agent 与会话运行时:重试仅有思考内容和空工具后的轮次、防止重复钩子执行、保留挂起子 Agent 投递、压缩后保留用量、修复部分 JSON/历史损坏
- 代码高亮与 UI:修复 Kotlin/Swift/TS/JS/Python/Bash/JSON 代码块在 Android 上的主题感知语法着色
v2026.7.1
2026-07-13
新功能
- Control UI 全面重构:会话组织更直观,支持并排操作与实时 Tasks 面板,更清晰的聊天控件、用量与成本视图、文件/下载/配对/审批/Gateway 健康状态紧邻会话呈现
- 更轻松的安装到首次聊天:引导式设置提供更清晰的首次聊天步骤,保存前检测连接状态,设置中断时保留之前选项
- 官方 App 重大更新:iOS/iPadOS、Android、macOS 在设置、导航、聊天、语音、权限、本地化、文件、定时任务、离线阅读、队列发送、连接恢复、原生会话控件等方面全面改进
- 模型与 Provider 扩展:GPT-5.6 兼容性全面提升,覆盖 OpenAI 和 Codex 路由;Tencent Hy3 完整安装路径;Meta Model API 新增 Muse Spark 1.1;Claude、Ollama、ClawRouter、LongCat 等 Provider 扩展选择与可靠性
- Codex 与连接 Coding Agent:openclaw attach 为 Claude Code 提供选择性会话临时访问、Codex 委托与原生子 Agent 返回结果更可靠、Copilot 拓宽 Provider 选择、长时间运行会话与目标更易恢复
- Telegram 大幅更新:实时进度、照片与文档、话题、命令、重试、账户路由、设置和投递全面改进
- Slack 增强:线程、卡片、进度、身份、反应与防重复改进,长对话减少不必要等待
- Discord 改进:回复、附件、语音会话、进度、重连与多账户行为改善,未读提示与会话恢复失败恢复更佳
- Apple Messages:回复、输入、媒体、路由、设置引导和聊天连续性在支持的桥接设置中改善
- Gateway 崩溃不再无限重启:反复失败的 Gateway 提供稳定的修复路径,不再无限循环重启
优化
- 频道与消息:扩展原生能力、更清晰进度与投递行为、更强媒体处理、Telegram/Slack/Discord/Signal/WhatsApp/Apple Messages/Teams/Matrix/飞书等频道覆盖更广
- 模型与 Provider:更多模型可发现、选择、认证和使用,覆盖云端、托管和本地路由,推理控件更清晰
- 内存/会话/状态:会话组、标题、未读状态、检查点、上下文处理、目标与恢复路径在 Web/移动/CLI 和连接 Agent 间更加一致
- 工具与自动化:浏览器控制、下载、Cron、终端、文件、搜索、抓取、MCP 和后台任务工作流获得新能力与更清晰控件
- 账户/设备/数据保护:密码与 Token 不再进入更多日志,敏感控件限定已批准用户,设备配对更清晰,危险下载/文件/网络请求更早阻止
- 插件与打包:内置和外部插件改进安装、发现、更新、兼容性、诊断和分发行为
- CLI/设置/管理:引导流程、Doctor、更新、配置、状态、诊断、节点管理、备份与部署工作流更易检查和恢复
修复
- 聊天投递与回复:消息、进度更新、引用回复、媒体和最终结果在重连、重启、重试和频道特定限制下更可靠地保持与正确会话绑定
- Control UI 与原生 App:修复会话状态、陈旧完成、响应式布局、滚动、焦点、辅助功能、本地化、配对、语音、离线聊天和移动端恢复
- Gateway 与 Provider 可靠性:启动、重启、迁移、认证、回退、流式、模型发现和超大响应失败更干净地停止或恢复
- 会话与内存:转录、压缩、检查点、缓存、轮换、搜索和持久化修复减少状态丢失、陈旧视图和跨会话混淆
- 浏览器/工具/自动化:浏览器操作、下载、抓取、搜索、定时任务、终端、子进程和 MCP 调用更安全地处理取消、畸形输入、超时和中断流
- 设置/更新/打包:安装器、容器、插件更新、运行时检查、临时文件和平台特定启动路径获得恢复和兼容性修复
- 安全与凭证:额外加固保护 Token、密钥、审批范围、本地路径、网络目标、附件、归档和不受信任 Provider 或插件响应
v2026.7.1-beta.5
2026-07-11(预发布版)
新功能
- Meta Provider (muse-spark-1.1):新增 Meta 官方 Provider 插件,支持 Responses API 流式传输、工具调用、加密推理回放、模型实时验证,可通过 npm 安装 @openclaw/meta-provider
- 会话式引导 (Crestodian):全新 Agent 环引导流程,覆盖 CLI、Web 安装和 macOS 应用,支持 AI 辅助 Provider 配置、模型审核的精确操作绑定、凭据掩码输入,以及无模型时的确定性回退
- Control UI 升级:以会话为主的极简可搜索侧边栏、紧凑上下文环、推理强度滑块、更简洁仪表盘;新增原生 macOS 会话浏览器(模型/思考选择器、斜杠命令、导出)
- 离线与语音移动端:iOS/Android 预缓存会话和记录实现离线可用;Apple Watch 支持完整语音对话;iOS 可通过 Gateway TTS 朗读回复并回退到设备端
- 会话组织与标题生成:通过工具模型路由自动生成会话标题;Gateway 级分组管理(未读、重命名、分支、归档、删除),Web/iOS/Android 全平台支持
- 外部 Harness 附加:openclaw attach 可将 Claude Code 等外部 harness 连接到现有 Gateway 会话,支持作用域限定、可撤销、TTL 绑定的 MCP 授权,退出时自动撤销
- Telegram Codex 工作流:支持私聊 /login 配对 Codex、运行中 /steer /tell 操控、跨富文本/引用/限流的最终回复恢复
- Logbook 工作日志插件:新增默认禁用的内置插件,将节点截图转化为私人时间线、每日站会和基于时间线的问答
优化
- ClawRouter 路由与配额:凭证范围的动态模型发现、OpenAI 兼容 + 原生 Anthropic/Gemini 传输、认证配置文件模型解析、跨平台用量预算管理
- GPT-5.6 完整支持:识别 Sol/Terra/Luna 模型族,覆盖 API-key、ChatGPT/Codex OAuth、simple-completion、Codex app-server 等多路径,含正确上下文和定价元数据
- Android 聊天 Agent 选择器:直接从聊天界面切换活跃 Agent,保持聊天/Talk/Canvas 在同一标准会话上
- Gateway 主机状态:在 Control UI 设置中展示 Gateway 主机名、网络地址、OS、运行时、运行时长、CPU、内存、磁盘详情
- Gateway 崩溃恢复:持久化启动结果,多次异常启动后进入控制面板安全模式,阻止传输和 Provider 激活直至恢复,配置致命错误退出 EX_CONFIG
- iOS 离线聊天:从受保护的每网关缓存预渲染会话和记录,离线时禁用发送,配对重置时清除缓存
- Slack 进度指示器:默认使用原生助手线程状态和轮换加载消息,确认反应保持静态
- Control UI Talk 控件:在设置→通信→Talk 中集中管理语音/模型/灵敏度,使用作曲器麦克风选择浏览器音频输入
- Cron 模型选择:在 Quick Create 中选择 Agent 轮次模型,展示配置的或默认模型
- Control UI GitHub 预览:悬停或聚焦时展示 Issue/PR 状态、标题、作者、评论和变更统计
- Control UI 消息上下文:通过悬停时间戳展示每条消息的 Token/上下文/模型详情
- Control UI 侧边栏:自定义固定目标集合,其余页面收入「更多」,设置移至页脚,自定义在浏览器持久化
- Android 代码高亮:Kotlin/Swift/TS/JS/Python/Bash/JSON 块支持主题感知语法着色
- Gateway TTS 播放:新增 tts.speak RPC,为远程客户端返回配置 Provider 的完整音频片段
- Apple Watch 语音对话:从 Watch 聊天口述消息并聆听回复朗读,支持显式静音和停止控件
- 模型与 Provider 覆盖:新增 GPT-5.6、Nemotron Super 1M 上下文窗口、保留 OpenRouter 认证头
- CLI 与 Node 工作流:新增 openclaw attach、节点上下文路径支持、设备审批恢复指导、CLI 软恢复、插件安装诊断改进
- 诊断工具 (Doctor):新增认证配置、工作区、设备配对、频道插件、内存 Provider、systemd 耗尽、Windows LAN 防火墙等数十项检查
- 策略修复预览:doctor –fix 时显示待审核的 Gateway 绑定和节点命令变更而不立即应用
- 对话与审核:准备限域的会话能力配置,新增 Cursor Agent 作为自动审核引擎
修复
- Node 24 浏览器操作:修复 POST 操作在 Node 24.16+ 上因 body stream 信号过早取消而失败的问题
- SecretRef 模型凭据安全:解析后的 Provider 密码以进程本地 sentinel 形式保护,仅在最终网络或插件边界注入明文
- Telegram Token 脱敏:即使日志传输将 Token 跨块切分,也能正确脱敏
- Telegram 持久化批量采纳:仅在持久化 Agent 采纳完成后完成缓冲更新,将已采纳的批量与入口回复围栏分离
- 任务投递恢复:规范化旧版投递状态同时恢复任务记录,使较旧的排队工作变为可运行
- 诊断 Provider 证据:每次诊断运行生成唯一的证据文件,修复重复覆盖问题
v2026.7.1-beta.6
2026-07-13(预发布版)
作为 2026.7.1 的第六个 beta 构建,本版本修复了多项稳定性问题,包括但不限于:
修复
- 依赖项证据完善:更新 postpublish 证据和发布清单验证流程
- 构建稳定性:修复上一 beta 版本中的构建和发布流程问题
- 整体稳定性改进:多项底层依赖更新和 CI/CD 流程修正
注:beta.6 与 2026.7.1 共享主要功能更新,完整新功能列表见 v2026.7.1-beta.5 条目。
v2026.7.2
2026-07-29(正式预发布版,更新至 beta.5)
新功能 / 亮点
- 状态安全与恢复:引入隔离存储机制保护持久化数据,支持数据库损坏后存活、崩溃可恢复的 SQLite 快照、崩溃持久的文件系统发布、schema 升级数据丢失拒绝,以及回滚写入快照恢复
- 持久频道交付:通过共享入口排空和死信恢复机制,确保已接收的消息在 Gateway 重启和本地崩溃后仍可恢复,覆盖 Telegram、Signal、Slack、QQBot、Twitch、Synology Chat、Tlon、IRC 和 Zalo User 等全部频道
- 会话回退与分支:支持从任意消息回退或分叉对话,在 Web 和原生应用间切换对话分支,分叉上游 Codex 会话,分支安全的排队发送,过期面板写入拒绝,以及分叉后恢复提示图片
- 交互式 MCP 应用与仪表盘:托管带票据的 MCP 应用,支持绑定工具、资源和有界上下文更新;可以从频道回复中打开,固定到持久仪表盘,加固共享沙箱,并允许原生插件直接声明
- 全平台提问与审批:Agent 可在 Web、频道、macOS 和原生应用中发送带选项卡的结构化提问;审批增加推送通知、历史记录、公平排队、无头解析、Claude 工具请求中继、审查员详情和更清晰的格式化提示
- 会议与实时语音:默认启用 Teams、Zoom 和 Google Meet 会议插件及持久转录收集;实时 Talk 新增 OpenAI 和 Gemini 视频支持,以及通过 Codex OAuth 的 GPT Live
- Wear OS 伴侣应用:新增手机代理的 Wear 伴侣应用,支持主屏幕 Agent/会话/模型选择、实时 Talk 控制、音频响应播放和即时语音磁贴
- 引导式设置与本地推理:跨浏览器、Linux 和 macOS 的引导式设置流程,支持本地提供商检测、最强模型选择、可下载模型、精简模式、记忆导入,以及进程内 RAM 门控的 llama.cpp/Gemma 路径
优化
- 模型与提供商:新增 Claude Opus 5(全目录和运行时支持)、Kimi K3,以及通过 Codex OAuth 的 GPT Live 支持
- 本地推理与设置:入门流程中自动检测本地推理提供商,新增进程内 llama.cpp GGUF 推理和 Baseten Model API 支持,从实时提供商目录发现模型,Web 和 macOS 设置中提供模型下载
- 会话与仪表盘:新增会话面板和仪表盘视图,归档/可见性/草稿/隐身会话状态,带输入指示器的建议队列,以及分支切换功能
- 原生应用:macOS 和 Linux 新增 Quick Chat(支持流式、路由、上下文捕捉、听写和模型控件),Linux 桌面集成与签名更新,多 Gateway 应用与移动仪表盘
- 频道:新增 Buzz 插件,Slack 用户身份和 Agent 视图模式,Telegram Bot API 富文本块和原生 Markdown 列表,更丰富的 Matrix 格式
- 浏览器与 MCP 应用:新增安全的按标签页浏览器 Copilot、批量浏览器 CLI、有界页面问答提取,MCP 应用主机和 Control UI 桥接
- 记忆:快速主动记忆召回,个人安装版默认跨对话回忆,从 Claude Code/Codex/Hermes 导入记忆,专用记忆设置页面
- 调度:按任务的动态节奏、门控脚本负载、持久调度源流式传输、Cron 心跳监控器、心跳任务转换、当前对话默认设置和 /loop 命令
- 远程编码会话:在云工作节点上运行 Control UI 会话,在终端中恢复 OpenCode 和 Pi 会话
- External Gateway 监管:新增 OPENCLAW_SUPERVISOR_MODE=external 模式,供 OCM 等生命周期管理者使用
- ClickClack 集成:引导式设置、命令菜单自动补全推送
- Control UI 多项改进:聊天布局居中、作曲家页脚居中、助手操作按钮左置、消息上下文悬停显示等
- 配对节点编码 Agent:可发现 OpenCode 和 Pi 会话,继续 Codex 和 Claude 目录会话
- MCP 隔离:MCP 服务器连接限定在请求会话范围内
- 其他:Skill Workshop 审批简化、OpenAI GPT-5.6 默认设置、iOS 离线聊天、Slack 进度指示器、插件安装来源警告、目录会话创建、工作树管理、Cron 运行历史、编码 Agent 记忆导入、任务预览等
修复
- 安全与授权(多项):防止频道白名单授予所有者访问权限(CVE 相关修复)、保持会话导出在 workspace 内、关闭伪造标记/网页搜索边界绕过、防止非所有者 ACP 会话暴露、拒绝不安全的显式审批 ID、加固 secret 脱敏和 exec/OAuth 审批、验证已下载的安装脚本、防止不安全的 secrets-plan 写入
- SQLite 与数据安全:在会话记录驱逐前提交会话索引、通过维护竞争和实时 WAL 验证保护状态、拒绝无效备份和 schema 数据丢失、使快照发布崩溃可恢复、被中断提交后保留完整备份
- 频道交付(多项):修复 Telegram 持久入口在重启间丢失、仅在 spool 写入后持久化偏移量、保持 Discord/iMessage/WhatsApp 流量在崩溃或重启后存活、重启后恢复助手上下文和中断轮次、保持排队回复存活、可见轮次无回复时发出回退提示
- 会话与记录(多项):保留最终回复、活跃轮次、Codex 绑定历史和记录游标;防止重复工具调用 ID 污染会话;关闭生命周期竞争和跨 Agent 死锁;防止 TUI 跨会话泄露和丢失流
- 安装与升级(多项):在不支持的 Node 和 npm 12 上保持可用安装、隔离源 postinstall 状态、修复缺失本地适配器、保持版本化插件脱离源代码路径、避免脏源构建、修复升级过程中的插件配置、阻止包删除 UI/运行时文件、完成 ClawHub 卸载、暴露空 npm 安装失败、新安装时发现外部网页搜索插件
- 提供商可靠性(多项):防止虚假 Codex 耗尽和静默回复、遵循 Anthropic Retry-After、保持选定 Claude CLI 配置文件、恢复 Codex Computer Use 和用户主目录应用服务器路由、重试瞬态设备轮询、纠正 OpenAI 入门设置、稳定 Ollama/LM Studio/本地模型发现
- Cron 可靠性(多项):恢复一次性启动追赶任务、在重启间保留脚本状态和调度权限、接受良性同代更新、将任务绑定到持久存储会话、解除慢批次后已完成任务的阻塞、精确查找前清理任务 ID
- 压缩与响应交付:在压缩估算中正确计入 CJK 文本、将 no_compactable_entries 视为良性跳过
- 频道安全:修复 Telegram/Signal 入口丢失和控件响应问题、阻止白名单权限提升
- 外部监管器重启健康检查:仅在替换 Gateway 锁和监听器 PID 一致时接受设备身份策略关闭
- Gateway 控制面速率限制:按方法分桶,每分钟 30 次预算
v2026.7.1-1
2026-08-04(补丁版本)
修复
- Codex 进度回复:保持 app-server 轮次在投递进度消息后继续运行,使 GPT/Codex 能到达权威终端响应,而非中途停止
- Memory Core 启动修复:恢复派生旧版索引与缓存副卡冲突,避免 Gateway 陷入致命重启循环,同时保持向量存储结构性损坏可重试
- WSL 状态权限:仅当现有状态路径已为私有时容忍 EROFS 错误,对宽泛权限保持失败即关闭处理
- 旧版迁移恢复:将已审查的迁移残留视为非致命错误,不阻塞健康的升级流程
- 托管插件更新:恢复过期的 npm 锁元数据,使官方托管插件可以正常更新
v2026.7.1-2
2026-08-04(补丁版本)
修复
- npm 插件更新兼容:接受新版 npm 客户端返回的单例数组元数据,使已追踪的官方插件可正常安装和更新到修正版本
v2026.7.2-beta.7
2026-08-02(预发布版)
作为 2026.7.2 的第七个 beta 构建,本版本进一步完善了发布流程与构建验证:
修复
- 依赖项与构建验证:完善发布清单与 postpublish 证据校验,确保 beta.7 构建完整性
- 整体稳定性提升:多项底层依赖更新和 CI/CD 流程修正,为即将到来的 2026.7.2 正式版做准备
v2026.6.34
2026-08-08(扩展稳定版 / 维护版本)
本次为扩展稳定版(extended-stable)的维护发布,专注安全与可靠性修复,未引入新的发布线功能。
新功能 / 亮点
- 更安全的浏览器与网络边界:沙箱化浏览器路由、受信任的 DNS 目标、自定义浏览器源、回环提供商端点现在会拒绝不安全的访问路径
- 更稳健的 Agent 与提供商运行:保留会话写入、提供商回退、流式进度处理与 stdio 失败现在可优雅恢复,不再静默终止活动中的工作
- 更强的通道恢复:待处理的通道工作在恢复后继续、确认幂等、持续的 Discord 网关突发保持有界
- 更安全的运维诊断:命令与状态界面保护仅限所有者的操作,防止凭据出现在账户 URL 或摘要中
- 更稳健的本地运行时状态:SQLite 检查点、工作区读取、Gateway 进程信令、插件 HTTP 响应与依赖处理不再将瞬时主机状况转化为运行失败
优化 / 变更
- OpenCode Go:使用文档化的 hy3 模型标识符,替代失效的 hy3-preview 别名
- Codex 原生子代理:保留父 app-server 订阅,识别多 Agent V2 子活动直至 yield 的子完成到达其请求方
- 依赖安全:更新生产依赖解析,修补 brace-expansion、PostCSS、fast-uri、ip-address 与 Undici 版本
修复
- 执行与传输安全:浏览器、沙箱、exec、MCP 与 secret 解析路径拒绝不安全输入,处理流失败而不崩溃宿主进程
- 投递与通道稳定性:出站回执、投递证据、通道生命周期、健康监控与 Gateway 队列在重试、重启与过载下可干净恢复
- Gateway 与存储可靠性:插件响应、进程探针、工作区引导读取与 SQLite 写入容忍预期的瞬时故障,同时保持正确状态
v2026.7.1-2
2026-08-04
修复
- npm 插件更新:接受新版 npm 客户端返回的单例数组元数据,使受跟踪的官方插件能够正确安装并更新到修复版本 (#108336)
v2026.6.34
2026-08-08(Extended-stable 维护版)
优化
- 更安全的浏览器与网络边界:沙箱浏览器路由、受信任 DNS 目标、自定义浏览器来源和回环 Provider 端点现在会拒绝不安全的访问路径
- 更可靠的 Agent 与 Provider 运行:保留会话写入、Provider 回退、流式进度处理和 stdio 失败现在可以恢复,不会静默终止活动工作
- 更强的频道恢复:待处理频道工作在恢复后继续,确认信息幂等化,持续的 Discord Gateway 突发流量保持有界
- 更安全的运维诊断:命令和状态界面保护仅限所有者的操作,防止凭据出现在账户 URL 或摘要中
- 更健壮的本地运行时状态:SQLite 检查点、工作区读取、Gateway 进程信号、插件 HTTP 响应和依赖处理不再因瞬时主机状态而导致运行失败
修复
- OpenCode Go:使用文档化的 hy3 模型标识符替代失效的 hy3-preview 别名
- Codex 原生子 Agent:保留父 app-server 订阅并识别多 Agent V2 子活动,直到退出的子完成结果到达请求方
- 依赖安全:更新生产依赖,补丁 brace-expansion、PostCSS、fast-uri、ip-address 和 Undici 版本
- 执行与传输安全:浏览器、沙箱、exec、MCP 和密钥解析路径拒绝不安全输入,并在流失败时不会导致宿主机进程崩溃
- 投递与频道稳定性:外发回执、投递证据、频道生命周期、健康监控和 Gateway 队列在重试、重启和过载下干净恢复
- Gateway 与存储可靠性:插件响应、进程探测、工作区引导读取和 SQLite 写入容忍预期的瞬时失败,同时保持正确状态
v2026.6.33
2026-08-08(Extended-stable 维护版)
优化
- 更安全的网络与密钥边界:Provider 流、Discord REST 响应、浏览器抓取、OAuth 路径和日志现在限制恶意响应大小,并防止 Telegram 凭据进入诊断信息
- 更可靠的长时间运行 Agent:运行释放、存活检查和看门狗语义现在能区分真实停滞与活动的长模型调用及卡死的后端
- 更强的频道投递:Discord 重连不再静默丢弃排队消息或重复歧义的非幂等发送,Telegram 机器人间和回复围栏处理保持正确线程与授权结果
- 更安全的凭据恢复:服务重启保留 SecretRef 支持的 Telegram 凭据,OAuth 修复不再覆盖已经有效的目标配置文件
- Extended-stable 更新:包安装可选择、更新并接收 extended-stable 频道的可用性通知,不会静默回退到其他版本线
修复
- 授权与披露:Gateway HTTP 在未认证处理前拒绝不允许的浏览器来源,权限修复局限于其预期范围,MCP 状态输出脱敏密钥,Gateway 动作桥拒绝不受信任的请求方
- Gateway 与进程稳定性:Agent 运行缓存有界,锁探测停止泄漏文件描述符,关闭原因保留有效 UTF-8,心跳读取在瞬时文件系统竞争下存活
- Provider 与浏览器可靠性:Anthropic 兼容的部分流在大小界限处停止挂起,OpenAI Realtime 使用正确的认证和转录密钥流程,远程 CDP 凭据不进入响应
- 入口与 Webhook 安全:持续流量下重放的 Twilio 请求被拒绝,损坏的频道队列行被标记处理而不阻塞后续工作,Telegram Token 即使跨日志块拆分也会被脱敏
v2026.8.1-beta.2
2026-08-15(预发布版)
新功能
- 密钥出站主机绑定:将每个共享存储密钥绑定到精确的 HTTPS 目标主机(覆盖 CLI、Gateway RPC 和 Control UI),未绑定 sentinel 替换在明文出站前即失败
- GPT-5.6 Ultra 与运行时切换:支持 Sol、Terra、Luna 三档模型跨 OpenClaw 和 Codex 引擎,通过 /model 和回退保持模型、运行时和思考选择的原子性,并新增两个 harness 的实时矩阵覆盖
- 频道插件入口监控:新增共享插件 SDK 监控器,提供持久的准入、轮询、修剪、声明身份校验、采纳交接和关闭,并迁移 IRC、Synology Chat 和 Google Chat 到共享生命周期
- SQLite 快照:新增 openclaw backup sqlite create|list|verify|restore,提供紧凑、经过校验的全局和每 Agent 数据库产物,仅支持恢复到全新目标
- macOS App 配置隔离:隔离命名 App 实例的状态、偏好、Keychain、Gateway 服务和重复实例所有权,同时保持主机级登录和节点服务不受影响
- 插件安装来源警告:CLI 和聊天安装任意可执行插件源时需显式 –force 确认,受信任的 ClawHub、内置、官方目录和跟踪更新流程保持顺畅,Crestodian 安装限定为受信任来源
- Control UI 更新恢复:「有新版本可用」的重载按钮现在会等待导致区块搁浅的 Gateway 重启完成后再重载,而不是静默无操作
优化
- 浏览器扩展中继 CDP 兼容:应答 Target.getBrowserContexts,使 Puppeteer 类客户端可驱动配对 Chrome,提供 DevTools 风格 /json/list 目标描述符,并新增 openclaw browser extension cdp 打印中继端点
- 本地模型设置:向 Control UI 和 macOS 宣传 Provider 自有的 Ollama、llama.cpp 和 LM Studio 设置选项,就地重试不可用的 LM Studio 服务,验证准备的确切模型
- Fish Audio 语音:新增托管 S2.1 合成(流式、语音笔记、语音发现、电话)及原生 macOS Talk 中的本地 Fish S2 Pro 参考语音流式
- Control UI 云端工作区冲突:展示暂存引用指导、有界冲突路径、结构化转录事件和侧边栏注意力,处理保留本地版本的云工作节点结果
- Control UI 发送者身份:归因用户消息在身份解析网关上显示作者真实头像,发送者标签去除不透明的 profile-UUID 后缀
- Control UI 在线名单:点击侧边栏底部头像群打开可滚动在线名单,显示每个人的头像、姓名和邮箱
- Discord 与 Slack 原生登录:在原生命令菜单注册 /login,配对码签发仍限于私聊和 Web UI
- 仪表盘 MCP 应用:将来源会话 MCP 应用视图固定为活动仪表盘小组件,续期沙箱视图租约,工具交互性受修订绑定授权保护
- Skill Workshop 审批:Agent 发起的 apply/reject/quarantine 操作默认无需额外审批
- Logbook 工作日志插件:新增默认禁用插件,将配对节点截图转化为私人时间线、每日站会和基于时间线的问答
- Meta Provider:新增内置 muse-spark-1.1 模型支持,含 Responses API 流式、工具调用、加密推理回放和 onboarding
- Android 聊天 Agent 选择器:从实时聊天界面直接切换活跃 Agent
- Gateway 主机状态:在 Control UI 设置中展示连接 Gateway 的主机、网络地址、OS、运行时、运行时长、CPU、内存和磁盘详情
- iOS 离线聊天:从受保护的每网关缓存预渲染近期会话和转录,离线禁用发送,配对重置时清除缓存
- SQLite 快照:compact 且经过校验的全局和每 Agent 数据库备份与恢复
修复
- Codex 子 Agent 分发:立即结算成功的终端产出并保留请求方所有权,使已完成的子 Agent 可靠恢复其父级
- Control UI 会话伴读:回答前加载有界可见会话上下文,保持不可用问题可重试,防止私有伴读引用包装器作为答案出现
- Telegram 实时位置:通过频道中立 message_received 钩子暴露初始、移动和停止的实时位置更新
- 插件卸载清理:从 plugins.load.paths 中移除精确记录的安装路径,同时保留父级、子级、前缀和无关路径
- Crabbox 水合:在共享缓存不可用时回退到用户可写 pnpm 存储,保留硬链接导入模式
v2026.8.1-beta.3
2026-08-24(预发布版)
新功能
- GPT-5.6 全档推理支持:Sol、Terra、Luna 及 Ultra 推理能力全面覆盖 OpenClaw 和 Codex 运行时
- Control UI 首启配置衔接:首启用例在完成已验证的模型配置后,继续衔接 Custodian 以及可选的频道配置流程
- Puppeteer 兼容 CDP 中继:为已配对的 Chrome 会话提供 Puppeteer 兼容的 CDP 中继支持
- 显式外部 Gateway 生命周期监管:以验证过的重启交接方式对外部 Gateway 生命周期进行显式监管
- 紧凑 SQLite 备份:提供紧凑且经校验的 SQLite 备份与全新目标恢复命令
- 共享持久入口监控:为频道插件提供共享的持久入口监控器
优化
- 运行时与推理统一:GPT-5.6 Sol/Terra/Luna/Ultra 推理能力在 OpenClaw 与 Codex 运行时间保持一致
- 发布验证链:89 个官方 npm 插件全部以 beta selector 回读至 2026.8.1-beta.3,携带完整 tarball 完整性元数据
- Codex 运行时锁定:@openclaw/codex@2026.8.1-beta.3 随附精确管理的 @openai/codex@0.149.1 运行时
修复
- npm 插件更新:接受新版 npm 客户端返回的单例数组元数据,使受跟踪的官方插件可正常安装并更新到修正版本(#108336)
v2026.9.1-beta.1
2026-08-28(预发布版)
新功能
- Gateway 重启恢复:跨多次 Gateway 重启保留已承认的轮次,使可安全重启的运行在每个检查点持续推进并交付最终响应
- Gateway 配置写入可靠性:提交的配置写入在 watcher 交接期间保持挂起,让同次写入重载按观察到的代次完成,而不是在源传输期失败
- Codex 托管运行时更新:在 Linux、macOS 和 Windows 上更新捆绑的 Codex 运行时至 0.150.1,同时保留平台特定的包解析和当前压缩行为
- Linux 安装可靠性:配置稳定的 Node 24 LTS 流,并将 RPM 安装限定到已配置的 NodeSource 仓库,使 Linux 安装不会选到不兼容的预发布版本
- Worker 恢复:重新武装准入截止时间启动、终止死 Worker 轮次、延迟碎片清理,使中断的委托工作可视化收尾
- Control UI 文件安全:在重叠读取和刷新期间保留已确认的 Agent 文件保存,同时保持较新草稿完整
- 模型浏览可靠性:自动插件激活后保持模型发现可用,不再丢失所选的 Provider 目录
优化
- 审计决策:在权威执行边界记录通用工具操作决策,提供更清晰的操作者诊断
- Codex app-server 兼容:通过托管桥接传递 Codex 0.150.1 的协作、状态和活动协议新增,同时保持精确的平台包检查
- Control UI 外观:按用户 Profile 保存外观偏好,共享浏览器不再挤压为同一视觉设置
- 模型选择作用域:新增可配置的模型选择作用域,同时保留规范的 Provider 和运行时策略路径
修复
- Gateway 重启恢复:跨清理和多次重启保留已承认的可安全重启运行,保留检查点和最终交付
- Gateway 配置 watcher 交接:保留挂起的配置写入直到 watcher 观察到提交的代次,防止 config.patch 在同次写入源交接时失败
- Linux 安装器运行时选择:使用稳定的 Node 24 LTS 配置并将 RPM 安装限定到 NodeSource,避免全新 Linux 安装选到不兼容的预发布版本
- Worker 准入恢复:在准入截止后重新武装符合条件的启动,并终止死 Worker 轮次,而不是让委托工作悬而未决
- Control UI Agent 文件:当较早的读取或列表刷新稍后完成时,保持已确认保存和文件元数据完整
- 模型目录激活:自动 Provider 插件激活后保留模型浏览
v2026.8.1
2026-08-31(正式版)
新功能
- 历史会话搜索:按精确词句搜索可见对话文本,并从匹配结果重新打开上下文消息
- 跨 Gateway 会话:在已配对设备或云 Worker 上运行工作,随会话迁移工作区,并复用于后续云会话的热机与项目种子
- 实时代办进度卡:跨刷新保留持久会话进度卡,可跟踪子代理活动与累积编辑
- 结构化问答:通过网页/原生卡片、消息按钮或纯文本应答结构化 agent 提问,提供自由文本与显式 Skip 路径
- 交互式卡片与仪表盘:在聊天中使用 widget、可固定到会话仪表盘、授权特定操作或网络源,并导出渲染视图为图片
- 私有凭据请求:通过掩码提示让 agent 请求凭据而不把值暴露到聊天或模型上下文,并可选用代理限制受保护密钥替换到已批准目标
- 一次性授权自动化:为精确操作授予自动化权限,可事后审查或撤销,任务变更时要求重新批准
- 更丰富的音视频:媒体随上传、生成回复、播放与重载保持在会话中,Apple/Android 客户端支持原生播放控件与视频上传
- 结构化问题、会话分支:从持久用户消息倒回或分叉,在保留的转录分支间切换,保留早期会话路径
- 团队协作与凭据:团队角色权限、共享凭据库(SQLite 管理密钥与环境变量)、可选 1Password broker、共享 Gateway 配置
- 目标与工作板:从 Control UI 直接创建管理目标;工作板可绑定自动化、会话结束后自动触发
- A2A 1.0 互操作与邮件触发:可选 A2A 通道插件做认证文本任务;通过 IMAP 收件箱插件启动 agent 工作
- 会话终端与上传:跨浏览器共享对话终端;拖拽文件到终端带进度、取消与重试
- 实验性 Fleet/Swarm:本地 Docker/Podman 上配置独立实验单元;Swarm 扇出有界并行子代理
- Slack 企业级与会议:支持 Enterprise Grid 身份、DM、路由、审批与在线状态;Teams/Zoom 会议插件
- 语音与视频理解:Fish Audio 合成、本地 MLX 语音、原生视频理解、Discord/Telegram 富媒体与目录
- 模型发现增强:新增 Qwen 3.8、DeepSeek V4 Flash Vision、Nemotron 3.5、GLM-5.3 等;实时模型发现、提供者凭据按 agent 管理
优化
- OpenProse 迁移(破坏性):移除内置 OpenProse 插件与 /prose 命令,用 openclaw doctor –fix 清理旧配置
- OpenAI 路由迁移(破坏性):用 openclaw doctor –fix 将 codex/* 与 openai-codex/* 模型引用迁移到 openai/*
- 官方 Provider 包:按需安装 BytePlus、ComfyUI、Mistral、NovitaAI、OpenCode、Volcengine 等官方插件
- 记忆与自学习:默认启用个人会话召回、Grounded Dreaming 后台记忆整合、自动自学习技能
- 会话与并发:默认保留跨空闲/跨天会话;前台并发按 CPU 并行度在 8–16 间自适应
- 插件信任与来源:安装前审查插件能力/来源/版本;任意可执行插件源需 –force
- 使用统计:提供可选功能统计,默认关闭;可通过 openclaw telemetry show 查看
- 引导流程:结构化引导新装、本地模型下载、Quick Chat、macOS 词典、云 Worker 引导
- 备份与恢复:定时数据库备份、版本快照、可恢复完整归档;SQLite 快照命令
- 记忆迁移与技能工坊:导入 Claude Code/Codex/Hermes 记忆;技能工坊整合与历史回顾
- 外观与导航:界面/聊天字体、按用户保存外观偏好、Tide/Beacon/Phosphor 主题、移动端导航
修复
- 数据库安全:隔离损坏数据库的隔离决策;修复 WAL 分裂清理、共享文件系统回滚日志、状态快照独立进程校验
- 配置可靠性:保留长数字 ID 与显式字段类型;无法解析配置时保留并停止 doctor 修复
- 文件安全:拒绝编辑非 UTF-8 文件;比对持久字节避免误跳过覆盖写
- 凭据外泄防护:关闭代理/上游/旁路隧道连接;Gradium TTS 拒绝非 HTTPS 与仿冒主机
- 会话与压缩:避免过早压缩、保留当前用户轮、记录遗漏图片;修复合流失败、转录重写去重
- 子代理与投递:接受仅会话可见回复完成交接;失败任务发送泛化失败通知;跨会话消息路由
- HTTP API:将记录的 agent 失败与超时作为错误上报 Chat Completions/Responses
- 插件与更新:启动时缺失插件可恢复会话;保留能力授权;低内存安装失败修复;更新回滚安全;镜像提交源码安装
- 共享历史与会话恢复:跨启动/修复保留共享历史;跨重启恢复活跃会话;迁移长历史不耗尽堆
- 进程与凭据卡:保留精确密钥值;显示请求/替换警告;关闭已结束运行的请求
v2026.8.2
2026-09-01(正式版)
新功能
- Home 智能体停靠:用 Cmd/Ctrl+Shift+H 在右侧或底部停靠 Home,边看当前页边预览/清除它的工作快照或把选中文本附加进消息
- Linux 桌面伴侣:x86-64 Linux 可装 .deb 或 AppImage,连接本地/远程 Gateway,从系统托盘或 X11 快捷键打开 Quick Chat;AppImage 更新经签名校验
- 不求切页的后台会话:从 New Session 一键创建并运行后台会话,保留所选本地/云端/配对设备位置,从完成通知打开它
- 更安全的升级:保留更新的配置、未完成会话迁移不冒认成功、更新失败且包安全验证后恢复被停 Gateway
- 回复把活干完:工具工作落定后返回最终回答、已接受的回合后上报失败,修好停在工具输出或起始确认的对话
- 更可靠的语音:内部推理不放进语音、保留工具生成音频的投递、通话建立后后续浏览器 Talk 回合仍可用
- 无运行 Gateway 的浏览器控制:受支持的 macOS/Linux Chrome 扩展构建可唤醒配对本地中继供已认证 CDP 客户端使用
- 四个全新外观:Control UI 新增 CRT、Manuscript、Rosé、Miami,主题选择离线保留、重载不闪错主题
优化
- 恢复清理:openclaw update cleanup –dry-run 预览保留的迁移原件,Gateway 停止时显式移除;清理保留当前 SQLite 历史但永久放弃回滚
- 会话可见性默认:默认允许非沙盒会话与同 agent 其他会话协同(含保留的 cron 会话);需更窄访问时设 tools.sessions.visibility 为 tree 或 self
- 跨会话对话:转发的消息渲染为独立气泡并带源会话链接与发送 agent 身份,保留归因
- 会话组织:操作菜单分组、转抄转录为 Markdown、在新标签/窗口/分屏打开会话、图标颜色统编、可隐藏空会话组
- 云端项目预备:复用已预备项目快照与校验过的工作区哈希,保留 Daytona 项目的停止/快照/重启周期
- 可读 Beam 链接:转录通过按会话命名的 /beam/ URL 分享,保留现有访问校验与上下文导航
- Chrome 中继唤醒:支持按需启动的独立本地中继,与 Gateway 共享配对浏览器,Gateway 断开时仍服务其他 CDP 客户端
- iOS 编辑器:内联模型/思考/权限/附件/上下文控件更贴近网页体验,排队发送绑定授权它们时的会话设置
- 插件审批核验与 SDK 类型:插件可说明外部核验选项而 OpenClaw 保留审批身份/授权/超时与最终决定;Telegram botToken 类型化为 SecretInput
修复
- 安全依赖:更新托管 Sharp 到 0.35.4 + libheif 1.23.2,修掉图片解码漏洞并保留可选安装
- 工作区权限:权限变更应用到运行中的会话、云 Worker 保留会话工具策略,换运行位置不会放大其权限
- 私有诊断:macOS 应用日志对显式标记私有的值做脱敏,凭据值与前缀不进常规 Clawdock 诊断
- MCP 响应上限:解析前拒绝超大 HTTP 响应与 SSE 事件,同时保留健康的长连接与心跳
- 源码保真:打补丁时保留 UTF-8 BOM、行结尾、模糊匹配上下文字节与文件末尾状态(含纯格式编辑)
- 迁移安全与会话恢复:自动数据库维护与当前拥有者协调、工作前先查迁移就绪、归档恢复保留独立文件与符号链接、v17 库可修复、更新被迁移阻塞时明确报错
- 保留更新配置:先迁移可读活动配置再考虑 last-known-good 恢复,用更新的有效设置而非旧副本
- 更新与插件:插件更新需能力审查时阻止请求的 Gateway 重启并报可操作失败;npm ignore-scripts 主机上完成验证包生命周期;更新进度/结果可靠、保留离线诊断、服务状态未知时拒绝不安全重启
- 定时任务:保留并恢复有效迁移的 cron 任务、避免多余调度修复写入、cron 输出经管道时输出完整 JSON、心跳任务上报实际完成/跳过/失败结果
- 审批迁移与 SDK 兼容:导入历史执行审批与用量元数据、保留 2026.8.1 起的会话绑定/命令定义,docks 旧类目改造后仍可见
- 回复完成与人优先:落定的工具回合给出可见回答、恢复失败工具批次、接受回合后上报失败、人工消息优先于跨会话工作
- MCP/模型路由:完整模型目录配原生认证结果、保留所选完成传输,模型发现与完成请求走同一提供者
- 升级路径:失败更新后经验证可用的安装重启受管 Gateway、认证恢复在失败来源上也显示完成或失败、Doctor 释放句柄再重启不阻塞迁移
- 文本/媒体/语音保真:Unicode 截断保全、保留内联 code 尾随空格与 astral 字符、修复 AVI/Matroska 处理、自动语言检测不再用隐含音频提示造成偏差
- 移动与 CLI:iMessage 回复留在当前会话、Discord/LINE 路由修正、Windows PowerShell profile 编码与 pnpm shim 参数保留、CLI Unicode 表格对齐
- 知识与技能:修复冒号富 frontmatter、可处置畸形提案、Gateway 启动后发现的 skill 根可正常刷新
v2026.9.1
2026-09-03(正式版)
新功能
- 处处可绘图表:Mermaid 代码块现可在 Control UI 与原生 macOS/iOS/Android 应用中渲染为图表,支持放大预览,移动端渲染失败时可重试
- 一句提示完成安装到聊天:全新安装(含 npx openclaw@latest)获得快速启动通道,自动检测已有的 Claude Code/Codex 登录与 API 密钥、现场校验并从前台 Gateway 打开网页仪表盘;完整向导仍可作为自定义设置使用
- 共享 Gateway 上的个人技能库:用 openclaw skills library 将自己的技能置于工作区集合旁,可从 ZIP 导入、按身份在团队 Gateway 上分享或发布
- 升级也不打断你干活:openclaw update 在后置 Doctor 失败时回滚 npm 候选、跨失败升级保留配置与密钥引用、把失败交给内置分诊 agent、等待插件就绪再重启、接受 npm 12 本地归档、让 agent 发起的升级可在 Gateway 进程树外完成;无服务管理器时(2026.8.2 无服务管理器用户应跑一次 openclaw update –no-restart)不再拒绝而是照常推进
- 稳如磐石的 Gateway:启动在高负载与大 agent 名单下可恢复、畸形旧 cron 行被隔离而非阻塞启动、迁移警告降级而非拒绝启动、本地模型服务器成为优先 OOM 牺牲对象、Windows Gateway 在 agent 重启后保持在线
- Codex 审批持久生效:「总是允许」在 OpenClaw 配置的 MCP 服务器上可持久化、工具审批遵循会话姿态、给予活跃 Codex 位置的审批被复用而非重复询问
- 审批直达你的聊天:委托系统 agent 提议配置变更或 Gateway 重启时,审批卡片被投递到发起频道(含 Telegram 主题)并带请求者标题,不再静默停滞
- Android 追平 Web UI:聊天界面、侧边导航与外观设置对齐 Control UI,输入框长到六行,无听写时提供录音选项
优化
- 个人 GitHub 账号:可在个人资料里连接「My GitHub」以显式个人身份发 PR、切换会话不必每次重验凭据
- 模型设置展示登录方式:一一列出账号与 API 密钥访问并由运行时上报 Codex/Claude 候选邮箱,目录「+」在终端打开原生 Claude/Codex CLI,提供者默认页自动保存
- 新模型与用量:Anthropic Fable 5.1、SuperGrok 用量进 openclaw models 与用量面板、GPT-5.6 Ultra 跨运行时与原生账号保持选中、Vertex 上 Sonnet 5 定价保持最新
- 本地与已配置提供者:发现 web-app 端点后的 llama.cpp 模型、保留本地 Ollama 路由可选、配置 Google 提供者插件时自动启用、本地模型目录在认证/配置变更后无需重启即刷新
- Agent 工作目录与 worktree:可设 agents.defaults.cwd 或 per-agent cwd 并在提示里描述目录角色、配置全局 worktreeRoot、最多跑 100 个托管检出而不会在限额被拒
- 配置控制:cron.skipMissedJobs 启动时跳过错过的周期任务、SSRF 策略 blockHostnames 可拦浏览器/网页抓取/webhook 指定主机、config set 支持 –expect-current-json/–expect-current-absent/–dry-run/–strict-json、channels.<id>.enabled:false 不再加载该频道插件
- 记忆维护:openclaw memory reset 重建派生索引而不删会话,活跃记忆的召回结果浮出到模型
- Codex 插件:监督消息 fork 保留原生历史、空闲聊天可并行续聊、不打断长静默原生轮次、原生回退时保留配置 MCP 工具、尊重时区、子插件配置变更后回复仍可用、自动语音回复保留入站音频、托管安装升至 Codex 0.152.1
- 会话命名与切换:空闲输入后准备新会话名、大列表切换更快、侧栏类目每组最多五项、New Session 与 Chat 启动开销更小
- Control UI 布局:侧栏控件并入 agent 头部、会话上下文菜单重组、强调色随主题、仪表盘小部件铺满移动宽度、hovercard 显示参与者、账号页脚显示 Gateway 挂起状态
- 聊天打磨:压缩带折叠微光、composer 有稳定可访问名称并在发送后即可收下一提示、Escape 关闭可见会话弹层、聊天报错可不展开复制
- macOS 应用:精简原生聊天下拉、浏览器侧栏可过半宽展开、闲置菜单栏 CPU 更低、后台会话完成发通知、Talk 浮层快速切换不丢、语音捕获复用识别器
- iOS 与 watchOS:无需嵌套 Control UI 即可打开会话仪表盘、显示模型目标并校验可用性、重开聊天显示最新输出、Watch 与实时语音回复归各自轮次、超时给出口头解释
- Linux 桌面:未装 CLI 也能完成首次运行 Gateway 选择
- 频道控制:Feishu 与 Matrix 交付 agent 回复附带的按钮、LINE 告知 agent 所渲染按钮并保留快速回复留下的文字、群提及可达对应轮次、LINE 拒收的卡片主动放弃而不丢回复
- CLI:channels add/login/logout/remove/resolve 支持 –agent、mcp –json 输出 JSON 失败信封、zsh 与 Bash 补全正确转义描述与选项值、heartbeat status 显示 Gateway 年龄、sessions tail 上报轨迹结果、secrets JSON 失败保持机器可读
- 插件与技能:重命名官方插件按旧 npm 包名迁移、过时接受时插件更新需能力同意而核验过的第一方插件豁免、插件卸载跨 Gateway 重启持久并保留频道设置
- 卸载与备份:openclaw uninstall 默认只移除服务并保留用户数据、Claude 迁移备份保留被覆盖的生成技能、备份排除禁用工作区、容忍 ACPX 生成符号链接、按身份找受管计划、Git 失败有诊断、保留活动配置
修复
- 入站与令牌安全:限制 SMS webhook 并发预认证读、设备吊销后不再向 Watch 节点投递命令、Copilot Azure BYOK 代理要求每进程 nonce、webhook 速率限制按客户端隔离、拒绝超大 A2A JSON-RPC 批次与响应
- 密钥保持脱敏:config.get 不再返回未迁移快照的未脱敏值、空白敏感字段可编辑而不当密钥、systemd 单元备份不泄露 Gateway 令牌、iOS 日志不含深链 URL
- 浏览器与文件系统边界:Chrome MCP –browserUrl 端点遵守 CDP 可达性策略、未审 Chrome MCP 升级被拦、不支持字段键被拒、内存同步跳过符号链接/非常规文件而非中断
- 权限边界:委托权限关闭后停止创建 agent、系统 agent 设置运行结束即停写、未授权原生 /compact 无响应、角色需已核验身份时客户端暂停、私有沙盒里访客编码恢复可用
- 升级数据安全:相同会话事件重放干净迁移、嵌套会话写入保序、schema-17 会话修复原子化、旧 cron 行保留启用态与投递意图、清理期替换的凭据保留
- Doctor 收敛:doctor –fix 处理空工作区证明、过期工作区设置循环解决、不完整 exec 审批迁移大声失败、被污染设备配对记录不再使迁移崩溃、Windows Doctor 与保留工作区恢复解封
- Doctor 保住配置:修复后保留写入值与 agent、安装前保留官方插件配置、保留外部插件负载、修复并持久化键控/显式多 agent 名单、更新修复时恢复过期 npm 插件
- 共享凭据迁移:中断迁移可恢复、失散凭据被恢复、冲突通过清除强制登录拥有者诊断、重登录修复过期档案顺序、自定义提供者 SecretRef 存活于 Doctor
- 子代理完成送达:忙碌父轮次后交付完成、后台完成拒绝被捕获、空完成被记录、未发送完成不当已送达上报、被拒请求唤醒收尾、模型重路由体现在完成中
- 压缩与上下文计量:原生压缩与会话写入串行化并留单一持久转录标记、缓存用量不再过多计算、跳过 usage/cache 的 Anthropic 代理下上下文用量仍准确
- 回退与重试:Anthropic 拒绝为终态不再重发、模型回退在会话持轮次声明时不循环所有提供者、瞬态 LLM 重试单 failover 拥有者更早暴露持续故障
- 回复到达对话:过时会话分发被刷新使重置后消息不丢、镜像入另一会话的投递不再静默丢失、重启恢复后中断的用户消息仍在上下文、围栏代码逐字节保留
- Cron 与心跳:取消运行收尾不早停 cron 重试、工具调用后保留 NO_REPLY、证未发送的通知投递重试、失败告警结果持久化、一次性重试跨启动恢复
- 会话与运行:循环会话父链不再挂起上下文构建、超时后 Gateway 保持收尾 CLI 输出、重启排空算入入站空闲、旧 CLI 恢复不能替换新会话、超大转录归档改为流式
- 工具结果与编辑:oc-path 补丁保留精确编辑字节、PDF/图像分析在 Code Mode 存活、exec 选有能力节点并上报目标、失败 /bash 显示真实退出码
- Markdown/链接/媒体:任务列表跨块边界存活、字面 Markdown 与完整图片 URL 保留、UTF-8 附件跨嗅探边界识别并保留类型、分段存储限额准确上报
- Slack:已有线程的回复可再次发送、Agent View DM 重启后保持各自根会话、HTTP 模式下符合投递、短回复先于进度定稿、代理 RPC 用配置身份
- Discord:webhook 回复限额与投递结果保留、缺响应 ID 不再误报送达、模型选择器选择无假失败、会话忙提示尊重回复可见性
- Telegram/WhatsApp:持久排队 Telegram 回调及时确认、WhatsApp 引用缓存未命中时去引用发送使气泡不空白
- iMessage/Signal/Google Chat/Teams/Matrix/Feishu/Twitch/Tlön:iMessage 私有 API 桥死后快速失败且远端附件存活、Signal 在永久 SSE 拒绝时发终态并拒非法 UTF-8、Teams 无 replyToId 也保线程上下文
- 语音/Talk/TTS:语音调用设置上报缺 agent 归属、主机取消不当工具失败上报、Talk 咨询跨客户端保拥有者、本地 CLI 合成继承请求超时、OpenAI OAuth 音频转录恢复、Volcengine TTS 拒非法 UTF-8
- 更省内存:缩小目录/重置/聊天内存峰值、释放 Gateway 与 Activity 保留内存、压缩转录扫描与聊天视图占用、大命令输出低内存解码
- 更快回复与流式:并发与长流式回复开销更低、并发最终答案流式更快、派生流式回复保持最新、CodeMode 与会话查找更快
- 更快启动:Doctor 引导更快、CLI-only 代码不再启动加载、插件目录避免全扫描、目录 worker 导入收窄到需要处、shell 命令冷启动更短
v2026.9.2
2026-09-05(正式版)
新功能
- 更快、更灵敏的聊天:处理长转录与磁盘占用时仍保持聊天、仪表盘与会话交互流畅——直接查仪表盘、减少冷加载、在 Gateway 事件循环之外做持久历史读取
- 更可靠的升级与恢复:自动更新时保留活动设置、启用的技能与默认 agent 归属;Git 更新后恢复 Gateway 重启;并以上可执行的恢复指引上报结果
- GPT-6 Astra 支持:可用 OpenAI API 密钥资料或符合条件的 ChatGPT/Codex 账号选择 openai/gpt-6-astra,支持文本与图像输入、Responses 工具调用与受支持的推理控制;订阅可用性随账号发现成功与否呈现
- 回复扛住重启:Gateway 重启后仍能恢复进行中、排队与委托的回复,且一个已完成回复不会丢弃另一个的恢复标记;压缩与重试中保留续写指令
- 守住你的数据的备份:Git 备份保留含内嵌 NUL 字符的完整文本、支持 Nix 管理的配置与凭据软链、拒绝损坏的归档头而非吞下一份不完整备份
- 改设置不用重启:更多 agent、模型、工具、频道、浏览器、节点、访问与终端设置可直接交由运行中的拥有者应用;仍需 Gateway 重启的设置会在配置参考里保留标记
优化
- 插件品牌化:把插件图标打包到 assets/icon.png 而不再用顶层清单 URL,OpenClaw 免网络请求直接加载打包图片,缺失或无效图标也不阻止插件加载
- GPT-6 Astra 异步工具与转向:在 OpenAI Platform API 密钥路由上,内置 OpenClaw 运行时与官方 Responses 端点可异步跑直接函数工具、经缓存的 WebSocket 转向进行中的回复、按文档化配置改推理强度时保留请求前缀;续写中保留转向历史与加密推理
- GPT-6 Astra 推理:目录元数据缺失时保持受支持的推理与采样设置正确,为 OpenClaw 与原生 Codex 运行时新增 /think ultra 编排,保留配置的 Azure 部署能力
- macOS 浏览器登录:经个人 Cloudflare Access 浏览器登录连接已保存的 Gateway、从 Gateway 网站打开 Mac 应用、应用重启后恢复所选 Gateway,同时账号与排队消息各自独立
- 实验性插件 UI:开启 Settings → Labs → Custom plugin UI,让插件贡献 Control UI 页面、面板与会话动作,或自定义 composer 与工作区
- 实验性 Apple Watch Talk:可在 Watch 上选择独立的、带 Gateway 方工具与转录的 Talk,同时保留既有 iPhone 中转的 Talk to Claw 流程;独立实时音频需要 UDP 连通性
- Slack 富文本回复:引导 agent 用受支持的 Block Kit 布局做主动式 Slack 回复
- 个人连接账号:从 Settings → Profile → Connected accounts 或 CLI 添加 Provider 账号,为新聊天或某个既有聊天选账号,默认变更时保留已有会话的选中账号
- Swarm 默认开启:可编排带结构化结果与实时进度的并发子 agent,同时保留显式退出、工具限制与独立的 Code Mode 选择
- 仪表盘贴合任务:在画廊浏览已存仪表盘、交换聊天与仪表盘视图、把面板放左/右/下方、隐藏再打开面板时保留已载入的部件输入
- Discord 会议纪要:可选占用驱动的只监听会议采集,自动出纪并带 Control UI Meetings 页面
- 把队友拉进对话:在 composer 提及已授权人员并在收件箱收到临时条目,可选浏览器通知
- 跨 agent 会话访问:会话工具默认全会话可见并放开普通 agent 间的互访;可用 tools.sessions.visibility=agent/self 收窄会话访问,保留既有工具与沙盒限制
- 设备一览:Devices 页显示设备类型、资源仪表、能力徽章与 Desktop 可用性,原生 iOS 上报 CPU/内存、Android 上报内存/磁盘
- Slack 会话控制:新增原生 Stop 按钮、会话处理与审批状态、同步会话标题;开文档化的 Slack 会话事件订阅后可收到 Stop 与标题变更
- macOS 审批:精简命令、节点与设备审批面板,让所请求的访问与管理员警告更易审阅
- 原生文本复制:iOS 可选消息文本,iOS 与 macOS 可直接复制代码块
- 实时 Talk:为瘦音频客户端支持原生实时会话,同时保留所选模型与账号、转录、语音控制与限定范围的 agent 咨询
- 云 worker 检出:把替换用云 worker 快进到推送的会话分支,同时保留本地修改、刻意删除与分歧分支
- Owner 档案:给单用户 Gateway 连接一个持久 Owner 档案承载身份与个人偏好,不授予额外权限
- Provider 账号优先级:通过 Gateway 暴露已配置的 Provider 账号优先级
- Gateway 延迟诊断:把 RPC 延迟拆分成阶段呈现到 OpenTelemetry 与 Prometheus 诊断,便于区分慢派发与慢执行
修复
- 问答答复:不把同一输入经普通转向再走一遍即可恢复丢失的答复确认;不确定性可见地上报,同时保留已被独立接受的工作
- Doctor 数据库诊断:对稳定的畸形数据库上报具体 SQLite 错误而非误怪并发改动,同时保留源数据库及其 sidecar
- 插件 SDK 代码区间:重新接受只含 start/end 的位置 CodeRegion 输入;需解析元数据的消费者保留推断的 findCodeRegions 结果
- HTTP 代理安全:更新 HTTP 依赖,请求绕过配置代理时目标 DNS 检查仍生效
- 转录重写:持久尾部重写失败时保留活历史,反复分支重写时保留已接收的用户输入
- 会话清理:删会话时保留其他 agent 的插件状态、大小写敏感的 peer 标识保持区分、被取消的排队清理不误删新恢复的插件状态
- Skill Workshop 备份:拒绝不完整的目录快照、恢复前校验已保留原件,免深度用户编辑被不完整视图覆盖
- 待发子代理启动:发起方父权限关闭即停止待发的原生与 ACP 子代理启动,同时保留已转移给被接受子代的所有权
- Provider 登录:发现 Provider 登录方式时保持活动插件注册表完好
- 自动化回复:自动化与心跳完成仍挂在各自发起会话与主题上,同时保留隔离的执行会话及其策略
- 配置的 agent hooks:轮次选非默认模型时保留已配置的 hooks
- 频道重载:插件重载后频道启动尝试与关停仍绑定正确的 Gateway,并隔离具名 IRC 账号的重载
- Telegram 代理媒体与格式:经显式 SOCKS 代理与 HTTPS 代理请求恢复媒体(含本地 DNS 无法解析目标机型的部署);富模式开启时保留 details 容器内的标题、代码、引用与表格,含嵌套容器与字面代码
- Discord 消息与语音:跨消息分块保留动作消息正文、刻意空编辑与行内代码;缓冲部分音频帧后语音播放跨停顿继续推进
- Mattermost 命令与恢复:commands.text 开启时识别 @bot /new 之类以提及开头命令;瞬时查找失败后恢复反应、按钮动作与用户名匹配
- 插件搭建与诊断:服务启动前修复退役插件的安装配置、避免为刻意禁用的插件出安装警告、把无效配置错误归到真正来源
- Tlon 摘要:检查程序重启后刷新频道历史使显式摘要用最新消息,并发账号用独立缓存
- Doctor 升级设置:自动迁移旧版多 agent 名单时保留活动设置与原始默认 agent,防旧 last-known-good 快照在更新时替换掉可迁移配置
- worker 转录安全:写入排队转录更新前重验现场轮次拥有者,防陈旧 worker 在轮次关闭后发内容
- 视频认证与脱敏:兼容的视频 Provider 尊重显式无认证与 API 密钥模式,Provider 失败时对回显的请求凭据脱敏
- 每轮设置:行内推理、详细度与授权追踪经排队、换模型与回退仍限定在当前轮;模型选择保持既有持久化行为
- 长对话:准备长转录时 Gateway 保持灵敏,历史准备全程取消始终有效
- 压缩计量:历史修复中清除的孤儿、重复与移置工具结果计入丢弃消息摘要与令牌总数
- 委托审批:等待实际审批结果、保留取消与过期行为、防迟到审批响应作用于已关闭工作
- Code Mode 恢复:失败的单元格回到普通 agent 循环,让 agent 可检查部分副作用并以既有配置继续任务
- OAuth 工具与账号:经令牌刷新让 OAuth 认证的 MCP 工具对 CLI agent 可用;Provider 只回轮转令牌字段时保留已存身份元数据
- Slack 投递:流式确认丢失后不重复回复、进度保持临时、完成作为新回复发送、投递与上传中按显式限流拒绝重试
- WhatsApp 终端结果:把轮次失败、超时或被拒的原因送达,而非让对话静默
- Telegram 升级:Doctor 迁移中保留恰好匹配退役调校设置名的账号名与发件人策略键
- Cron 任务:自动化自我移除时保留最终回复、主会话交接前取消已移除的条件、计划任务保留原生创建者工具、编辑或克隆时保留失败告警策略
- 记忆召回与恢复:保留轮转召回、允许记忆在较早每日认领后晋升、展示数据库/WAL/嵌入缓存用量并给安全的离线磁盘恢复指引
- 更新结果:聊天触发的更新如实上报成功、失败或刻意跳过,并给 owner 设置与重启恢复指引
- 安装清理:保留其他安装所用的运行时依赖、保护活跃更新暂存目录免被并发清理
- 插件恢复:修复缺失的已装插件负载,使重装能恢复出可用插件
- 会话搜索:越过当前载入窗口也能找到更早匹配会话并载入其匹配行
- macOS Gateway 切换:窗口、审批、草稿、排队动作与设置紧跟所选 Gateway,切换时清掉陈旧设置
- 聊天启动:压缩大 WebSocket 负载、可见聊天加载时延后后台转录预热,更快载入深链会话
- 实时语音打断:修复 Discord、OpenAI 与 xAI 语音路径上的漏打断与卡顿回复,打断的输出丢弃排队音频
- 字面聊天内容:Markdown 代码内的 TTS 指令保持字面、附件提示不进命令输入
v2026.9.3
2026-09-08(正式版)
新功能 / 亮点
- 更安全的更新:先在隔离的候选状态里「彩排」核心与插件变更再激活,支持符合条件的 2026.9.2 迁移,可在不停止健康匹配 Gateway 的情况下恢复被放弃的更新记录
- 性能优化:保留暖的提示缓存、减少冷会话更新与记忆搜索期间的冗余工作、在会话间复用 worker 构建
- Skill Workshop:技能在跨工作区的单一、持久、agent 拥有的集合里管理,可对比完整技能说明,通过 Doctor 安全裁撤缺稿建议;技能所有权从工作区迁移为每 agent 一个可写 Workshop 集合(破坏性变更,启动与 openclaw doctor –fix 迁移既有合法技能)
- 浏览器标签页,实时又原生:实时观看 agent 页面重绘,并在原生 Mac 标签页里打开外部链接——标签跟随所在窗口、跨聊天切换保留;流式不可用时可回退截图
- Provider 账号聚在一起:直接在 Models 设置里管理已连接账号与受支持的账号优先级(含 Agent 自定义顺序),不必断开账号
- 分享选定的会话语录:可显式发布某会话现有与未来对话文本的可撤销只读视图,任何持有公开链接的人可访问;只读视图省略工具、推理、文件、图像与可执行小部件,事后可撤销
- 可搜索的会议资料库:在 Control UI 浏览分页保存的会议笔记、搜索完整转录、下载完整 Markdown 或 JSONL 归档、管理采集来源
- 可选团队活动报告:安装并启用 Team Reports 插件,浏览已认证的 GitHub 活动与显式配置的 Discord 讨论,带存储历史与可选模型摘要、人员时间线与日历、覆盖率警告、调度/来源健康、主题感知报告页
重要 / 破坏性变更
- Node 运行时要求(破坏性):要求 Node 24.16.0 或更新(24.x)或 Node 26.1.0+(26.x 更推荐);升级 OpenClaw 前先升级 Node,以防 SQLite 文本被截断——Node 22、25 及更早的 24.x/26.x 不再受支持
- 执行策略 SDK(破坏性):被裁撤的 exec-mode 与比较辅助函数从 infra-runtime 移到 agent-harness-runtime 的 execPolicy,改用 resolveExecModePolicy 并选取所需字段
- 审批 SDK(破坏性):从 approval-native-runtime 导入审批账号解析辅助,会话过滤适配完整 matchesApprovalRequestFilters 契约;用原生频道路由门与共享谓词取代被裁撤的通用转发求值器
- SDK 别名(破坏性):channel-inbound.buildChannelTurnMediaPayload 改为 buildChannelInboundMediaPayload;推断保留的 abortAndDrainAgentHarnessRun 可调用结果,不再导入被移除的命名类型
- 搜索结果回调(破坏性):有界 Find/Grep 文本改从 details.content 读取,而非 details.truncation.content
- 目录结果回调(破坏性):用 LsToolDetails.content 与可选 nextAfter 取代被裁撤的 truncation / entryLimitReached 字段,用 nextAfter 作为 after 续列
优化 / 变更
- 可靠的更新与恢复:有界更新修复可在可丢弃的彩排状态里用配置的推理修复候选校验失败,独立校验后才激活,修复不成则保留失败或回滚结果;需要配置编辑的变更上报交由操作者修复;失败更新上报仅在明确同意后提交
- 保留自主编写的配置:setup、更新、设置保存与 Doctor 迁移全程保留手写的设置、环境与密钥引用以及省略的默认值;支持编辑路由到所属 include、保留与默认相等的显式值、恢复失败也保住配置、重启时应用更改的环境变量、拒绝或修复占位 Gateway 令牌
- Gateway 维护与重启:普通失败重启可在前台进程恢复,但迁移或必需维护阻塞启动时停止重启循环;Doctor 获取所有权后进行有界数据库检查、应用受支持的非交互修复、保留可操作的拒绝与备份恢复指引
- 实时活动会话:Live activity 在进入与重连时展示允许的运行/排队会话,带可见数量限制提示与连接状态,不再把断开的会话当空闲
- Code Mode 增强:在快速工具回复间保留运行中的 JS 环境、可对可用工具做可选 TS 类型检查、上报原始源错误位置并带受限 console 输出;提供跨 wait/resume 存活的沙箱 TextEncoder/TextDecoder
- 仓库云会话:由仓库 URL 与 ref 创建会话,带由云节点拥有的检出、setup 与可恢复检查点;仅显式迁往时才物化 Gateway worktree
- 持久会话与子代理:visible 生成的持久会话在其父树中保持可编辑可操控;子代理运行保持只读、省略作者头像、父会话中保留实时进度、非活动卡暂停
- 模型回退选择器:从可搜索下拉中挑选有序回退模型、移除选择、添加自定义引用
- Provider 发现保持被动:直到用户选定路由前不做主动 Provider 检测,并在 setup 与 OAuth 失败期间保留同意与模型选择,生成的目录行交给发现
- iOS 语音捷径 / Android 折叠屏 / 原生内嵌设置:应用捷径一键打开当前聊天并启动 Talk;Android 折叠屏将转录与 composer 拆到合宜面板、保留草稿与阅读位置;macOS/phone-width 原生设置沿用 Gateway 作用域与原生能力
- Telegram 相册:把连续合格照片归组为最多十张的原生相册,保留顺序、说明、回复目标与主题;单张与带控件的消息仍单独投递
- 递归委派:默认启用有界的递归会话生成,同时保留显式深度与并发限制及既有沙盒限制
- 搜索与浏览:openclaw docs –limit 限制终端/JSON 文档结果;Chat 检索栏为长对话提供可预览的位置轨与直接跳转;文件夹浏览即时按路径过滤;Devices 页可直接重命名已配对设备
- 未选即用的 CLI agents 与报表:新会话模型选择器默认显示受支持的 create-capable CLI agents(gateway.cliAgents.enabled=false 可关);原生仪表盘报表经 show_widget/仪表盘直接展示有界数据,无需 iframe
- 会议归档与桌面:通信设置可编辑采集来源并保留既有访问控制;macOS 桌面提供 ARM64 Linux AppImage 打包与 Gateways 菜单里可直接开窗的实时卡片
- 诊断与可观测性:暴露 GC 时长指标并识别打开 agent 数据库时的慢阶段;Prometheus 指标标识运行进程与所加载构建;云 setup 上报引导各阶段耗时(含崩溃后重连会话生成诊断与终端体验改进)
修复
- 更新回滚与恢复:失败激活/服务迁移后恢复有资格且已核验的先前安装、保留服务档案、按 Doctor 后真实配置与库兼容性判定回滚;保持更新结果与 Unicode 诊断准确、核验回滚后跳过自动分诊、恢复不把原失败更新变成成功
- 服务恢复:status 与 repair 期间保留服务派生目标与认证、容忍 systemd 时钟跳变与旧 launchctl 输出、不误终止正在重起的调用者;子运行时在 systemd 下优雅排空、仅当所属进程组退出后才释放 Tailscale 声明
- 更新核验:不发起模型调用即检查服务归属、健康落定、版本与构建身份一致、插件激活、频道就绪与 HTTP 就绪;检查失败走受支持的修复或回滚路径
- 更新连续性:跨更新保留活动工作、排队输入、更新历史归属与终端进度
- Skill Workshop 与记忆:跨工作区保留单集合技能、迁移合法旧技能、畸形建议经 Doctor 安全裁撤;保留轮转召回与较早记忆晋升
- Chat 与投递:保留接收输入顺序,重连/刷新后不复活已裁撤提示;字面内容与格式跨块存活
v2026.6.35
2026-09-10(Extended Stable / LTS 正式版)
这是 2026 年 6 月 Extended Stable(LTS)线的收官版本,不含新功能,只做经过审计的可靠性与安全回移(含 166 个合并 PR)。仍在 LTS 线上的用户建议更新。
新功能 / 亮点
- 更安全的 Provider 与频道边界:内置 provider 与频道适配器现在限制不可信响应体大小、在昂贵处理前拒绝超大输入,并在传输失败时保留安全的恢复路径
- 更可靠的长时运行投递:agent、gateway、重试与频道路径现在能正确处理取消、重试、部分发送与进程流失败,不丢工作、不重放不安全操作
- 更强的内置插件韧性:local-model、浏览器、媒体与协作类插件可从畸形负载、超时与上游瞬时故障中干净恢复
- 更安全的工具与工作区使用:浏览器自动化、本地工具、工作区读取与插件元数据处理在可能打断 agent 运行前就拒绝畸形或超大输入
- 更可靠的本地集成:本地模型发现、语音、会议与协作集成都改为有界请求,并把失败暴露出来而不动摇 gateway
优化 / 变更
- Extended Stable 维护:本版本承载为 extended-stable 线挑选的可靠性与安全回移,不引入新的发行线特性
修复
- 响应与内存安全:provider、搜索、嵌入、媒体与频道集成对成功与错误响应都在读取前设上限,敌意负载无法耗尽进程内存
- 投递与运行时恢复:出站重试计时、频道生命周期、中止处理、进程 I/O 与持久化状态恢复在预期失败下保留正确的操作结果
- 发行打包:刷新生成的 Plugin SDK API 基线,使发布包预检能核验发行面(#120163)
v2026.9.4
2026-09-11(正式版)
新功能 / 亮点
- 可从兼容的失败更新中恢复:当 schema 与配置检查证明回滚安全时,保留上一版本包并用此前的配置与服务恢复;数据库迁移仍需更新前已验证的备份
- 插件集中管理:在一个统一的 Plugins 工作区发现内置与 ClawHub 插件、从 Control UI 安装,并管理其安装、设置与访问权限
- 预备云会话:从预备好的本地项目或公开 GitHub 仓库启动符合条件的 Linux 会话,并在开始对话前从 Control UI 构建可复用快照
- 终端内问答:Gateway 连接的会话与本地 TUI 会话都支持键盘选择、自由文本作答与多问题提示
- GPT Image 2.5:可通过 OpenAI 或 fal 选择新的 Flare 与 Sunburst 变体用于图像生成与编辑,无需改动既有默认模型
- 更可靠的对话历史:从中断的流中恢复最终回复、重载后保留超时通知,并在实时聊天交接给已保存历史时避免重复的最终答复
- 语音也能完成委派工作:把子代理结果返回 Talk,即便经历多轮委派也能送达最终答案
- 外部托管的配置:设置 OPENCLAW_CONFIG_READONLY=1 可阻止 OpenClaw 改写由部署方管理的配置,同时保留只读诊断与常规运行时状态
优化 / 变更
- 回滚与恢复:符合条件的、不涉及 schema 的更新失败会恢复保留的包、命令 shim、服务与激活前配置,然后再次核验先前的 Gateway。已变更的数据库 schema、不兼容的新数据库或期间的操作者配置编辑会阻止自动回滚;被恢复的更新仍算作失败的更新,并记录回滚结果。涉及迁移的升级前请使用已验证的备份
- 插件组织:按类别浏览已安装插件、详情标签归并在一起、插件页使用 /reports 之类的短 URL,并通过一次搜索同时发现已安装插件与 ClawHub 技能
- 云就绪 worker:符合条件的本地 Git 项目与公开 GitHub 仓库会话可复用已预备的 worker 而不必重复 setup;仅私有仓库的会话与已配对设备不在此预备流程内。默认预留目标为每项目/配置文件一个,Gateway 全局上限四个。就绪 worker 在被删除前会产生 provider 运行机器费用。把 cloudWorkers.profiles.<id>.readyWorkers 或 cloudWorkers.preparedPool.maxTotal 设为 0 可关闭相应预留
- 终端问题控件:用方向键或数字导航选项、输入 Other 答案、切换多选项,并用 /question 重新打开待答提示;本地模式的问题只在 TUI 进程运行期间有效
- 聊天导航与撰写:左侧使用紧凑的会话栏并在共享聊天预览中显示发送者身份、把选中文本加入主 composer、发送前预览已附加的视频
- 技能学习:在可检查、可继续的普通会话中打开对过往工作的学习
- 命令审查:让自动命令审查器使用有界对话上下文来允许、拒绡或升级一条命令,同时保留执行策略的最终权威
- Node 运行时恢复:当 CLI 运行时不兼容时提示更新 Node.js,并保持诊断与更新命令可用以修复安装
- 只读部署:遵从由宿主拥有的 OPENCLAW_CONFIG_READONLY=1,覆盖配置写入、setup、Doctor 修复、插件变更与更新;只读配置命令继续可用,且此模式不会把运行时状态变为只读
- 即将到来的 SDK 弃用:agent-harness-credential-prompt-string-argument 已于 2026-09-09 进入弃用期;buildCredentialSafetyPrompt 的旧字符串参数支持到 2026-11-30;插件作者应改传 { controlToolsAvailable }
- SDK 上下文兼容:sdk-untrusted-context-identifier-aliases 已到 2026-09-08 移除日期但仍为 removal-pending;在已发布插件的读取方迁移到按频道命名的替代项期间,保留已弃用的 untrusted 命名上下文别名
- 云快照控件:在 Settings → Connections → Cloud workers → Snapshots 构建、重建、查看、固定、删除与回滚受支持的云 worker 快照。进行中的构建可经确认取消;被保持或固定的镜像受保护。快照存储与就绪 worker 费用仍然适用
- 云放置与诊断:编辑高级 worker 配置文件与仓库默认值、检查云会话机器规格,并在后端支持时选择原生 Windows worker。暖镜像与桌面仍仅限 Linux
- Deepgram 语音笔记:通过 Deepgram Flux 使用 flux-general-en 或 flux-general-multi 转录语音笔记;这些模型需要 ffmpeg
- 慢会话诊断:识别占用会话生命周期队列的工作,并查看哪个制品清理准备阶段耗时较长
修复
- 访问与内容边界:安全修复期间保留既有 WhatsApp 群组白名单、启用私有 IPv6 例外时继续拦截云元数据地址、限制 Slack HTTP 请求体大小、把 Tlon 引用检索限定到被引用的帖子。拒绝过期的已签名飞书 webhook 回调、阻止附件读取兄弟 agent 沙盒、在被拒的上传后停止流水线式 MCP 调用
- 工作区与备份安全:保留并发的 工作区编辑、把必需的外部配置文件纳入完整备份、即便私有更新捕获移动后也不让它们进入常规导出、并容忍数据库被快照后消失的实时 SQLite sidecar
- 迁移恢复:恢复无标记的多 agent 配置、让有歧义的 Skill Workshop 迁移留待复核、解释硬链接会话迁移的拒绝原因、在重新发布迁移归档时保留归一化的媒体。会话 SQLite 导入期间保留旧 Codex 助手消息,并修复悬空的 Workshop 复核索引
- Doctor 与认证:完整 lint 期间保留源状态、迁移期间保持已保存的认证配置对齐、把旧认证配置的拒绝限定到受影响 provider、恢复作用域非法的旧 node 令牌、防止过期的共享 OAuth 刷新代际覆盖更新的凭据。恢复 Zalo User 策略提升,并停止 Moonshot China setup 反复重装其 provider
- 回复投递与历史:从被终止的流与先前的工具错误中恢复最终回复、保留部分失败轮次的文本与超时结果、保留段落与代码块边界、把被截断的 Responses 回复上报为不完整。跨 sessions_yield 保留长转录历史、在历史水合期间避免重复的最终回复、在 Claude CLI 恢复后避免重复用户轮次、在流结束时保留最终 ChatGPT Responses 帧
- 聊天连续性:历史交接期间保持已提交的图片可见、防止冷会话切换闪烁、一致地调和并发的会话更新
- Claude CLI 会话复用:当技能监听就绪状态变化但预备的技能内容未变时保持暖会话存活,而在真实技能内容变化后使其失效
- 语音对话:送达被 yield 与反复委派的结果、允许从模型锁定的发起方会话发起独立语音咨询、把被打断的实时音频截断到实际播放的量
- Telegram:当 HTTP 代理拒绝其隧道时保留回复、在文本与图片说明中识别 bot-ID 提及、保留代码示例间距、准备被取消后停止迟到的停滞反应
- Discord:恢复来自 guild 消息的委派、保留环境语音笔记转录、重连后立即显示成员在线状态、保留重复的组件说明与链接 emoji
- Slack:为心跳私信解析 Enterprise 工作区归属、让确认反应独立于状态反应、避免在 Windows 根路径后把普通散文格式化为代码
- Mattermost 与 Signal:密钥引用重载期间保持兄弟 Mattermost 账号连接、在撤回较早消息时保留替换预览、流式投递失败时保留 Signal 回复引用
- 频道文本保真:保留未知的 Matrix 消息文本与转义提及、正确解码仅含 HTML 的 Teams 消息、保留飞书富文本样式与不相关的工具、把出站 WhatsApp 响应前缀挡在入站消息之外
- Android 聊天与折叠屏:发送说明前等待已选取的附件、恢复完成的工具活动、区分连接状态与聊天就绪、把思考控件、后台任务与分支选择器保持在其折叠面板内
- 移动端连接反馈:显示不可达 Gateway 的失败与恢复,并把电量分数按预期百分比上报
- Provider 与模型选择:当别名共存或目录刷新时保留手写的目录行、精确模型身份、元数据与凭据。让模型覆盖、上下文上限、思考选择、视觉、压缩与工具清单都绑定到所选的模型与 provider;隐藏不支持的思考或 Fast 选项,并在回退后保留会话列表
- Provider 请求:跨瞬时运行时上下文保留 Anthropic 提示缓存复用、把 Kimi 配额耗尽当作速率限制而非认证失败、保留受管 Responses 会话亲和性、恢复受支持的畸形流式工具参数与静默工具拒绝
- 记忆:使用所选回退 provider 的嵌入模型与索引状态、观察外部 LanceDB 写入、在触发超时期间保留召回。随结果上限变化保持顶部搜索结果稳定、给受管本地嵌入启动独立的就绪预算、遵从有界的 provider 冷却、晋升前要求真实查询多样性、跳过对会话间投递不必要的召回。空 dreaming 后保留首次运行 setup,并在记录不存在记忆写入工具时限制压缩前刷新的上下文
- 更新交接与重启:让较旧的 updater 与 Git 安装可从 2026.9.1 升级并重启 Gateway;接受已发布的 2026.9.2/2026.9.3 服务交接而不削弱当前的服务归属检查。保留 pnpm 代际交接与 schema 升级重启意图、在就绪前准备好受管 helper schema、替换不受支持的服务 Node 运行时、保留已恢复版本的核验、防止 systemd 重启挂起
- 插件更新:当核心已是最新时收敛插件批次而不把未变更的安装变成无谓更新、排练期间保留内置别名、避免虚假的 Memory Core 迁移拒绝、解释被保留的官方插件固定
- CLI 更新与转录可靠性:当原生检查确认没有已安装的 Gateway 服务时允许更新,同时保留严格的服务归属检查;让转录纯文本与 JSON 输出不含无关的启动警告
- 更新恢复反馈:让较长的 Doctor 收尾得以完成、清除孤立的更新运行而非显示永久的进度、保留清理结果与可恢复的警告、避免链接不可用的报表。历史不可用时保留诊断、自动分诊启动编码 agent 前要求确认;已核验的回滚后续动作仍为可选加入
- Gateway 响应性:把冷历史规划、完整性检查与归档修剪移出主线程;保持已预备的更新与逐出后维护响应;检查长会话时减少内存峰值。减少未使用的插件与模型目录准备、限制并行远程工作区哈希、避免不必要的诊断副本、保持自动化投递预览响应
- 会话保留:磁盘压力解除后停止多余的清理、保留在清理期间变为受保护的历史、避免夏令时跳变前后的过早每日重置
- 浏览器动作:防止既有浏览器会话过早超时、当较早动作落定时保留更新的待处理对话框、上报被阻止或被中断的 CLI 动作、被动跟随时保持浏览器焦点不变
- 设置与登录:删除数组行后保留设置草稿、让 agent 自动化可从 Settings 编辑、当记住的设备令牌过期时请求 Gateway 令牌
- 插件与技能安装:防止跨不同 ClawHub registry 的已安装插件匹配、为固定安装上报更新的发布、恢复能力同意死胡同、为开发路径安装保留内置信任。保留插件选择与重启进度、一致地给官方目录结果排序、在 Gateway 重启时刷新技能快照、避免两分钟后中断技能安装
- 已配对设备与 Linux:在首个 computer 动作时暴露窗口发现、保留激活与观察结果、在其被指派的机器上打开聊天桌面、识别谁取得了桌面控制。遵从 SSH 别名端口、重连时保留远程凭据引用、保持后台更新结果可操作
- 插件 schema 类型:在多账号频道 schema 中保留 catchall 输入与输出类型(含转换)
- Doctor 更新收尾:插件缺席时允许隐式 Codex 偏好,同时对显式要求的运行时保留错误;不创建配置文件即完成无配置的更新;清理前只关闭 Doctor 的私有快照数据库,保持源数据库打开
- 委派与重置:前台回复后保持后台完成唤醒存活、父线程变更时保留子代理历史、在任务侧栏显示完整子代理转录、在停止被 yield 的子工作时保持会话重置响应。被取消的自动化释放其待处理的结果等待
- Provider 路由与搜索:为独立的 OpenCode 与 OpenCode Go 轮次保留稳定的路由身份、为显式会话保留 provider 轮次请求头、保留本地模型请求前缀、在新 API 密钥下保持 Gemini 网页搜索可用。全局网页搜索禁用仍在会话控件中生效
- 更新归属与云连续性:更新器权限丢失后停止插件持久化与回滚动作、拒绝未核验的 Gateway 替换、跨 Gateway 更新保留云机器、跨 worker 运行时更新继续已提交的轮次
- 运行时与状态诊断:在拒绝启动前于可用的受支持 Node 运行时下重新执行 CLI、在受管服务中保留所选的 Bun SQLite 库、保留 macOS launchd 错误日志、恢复 Linux Bun CPU 诊断、在只读状态访问期间容忍瞬时锁。schema 漂移失败会指明修复路径
- Control UI 恢复:Stop 发现运行已结束时恢复 Send、在被中断的恢复后保留终端会话、上报失败的 Review 文件打开、Review 变更后停止过期的任务读取、避免会话文件与嵌入式汇报被挤进嵌套滚动区域
- 工具与导出保真:在空的搜索包装器旁保留扁平工具参数、保持原生图像生成 hook 可用、在轨迹导出中保留分页读取证据、工作区写入失败时上报真实的文件系统错误
本版本覆盖 58fcf69cadd0be59ecee41b21b655f195ccda7b2..0b7ddbd9c5e97a82b6bd7a36daa8dcff984d338d 的完整变更历史:共 1,174 个 PR。
v2026.9.5
2026-09-19(正式版)
新功能 / 亮点
- Talk 语音体系统一:把实时中继、转录中继、托管房间交接、Voice Call、Google Meet、VoiceClaw 与原生客户端统一到共享的 Talk 会话控制器,并新增由 Gateway 管理的
talk.session.*RPC 接口 - Google Meet / 电话语音更灵敏:Twilio 拨入加入改用实时 Gemini 语音桥,配合节奏化音频流、背压感知缓冲、打断队列清理、同会话 agent 咨询路由与重复咨询合并,让会议里的 OpenClaw 语音代理响应明显更快
- 实时通话上下文胶囊:可选的 agent 语音上下文胶囊与咨询节奏指引,让 Gemini/OpenAI 实时通话听起来像已配置的 agent,而不必在每个普通轮次都咨询完整 agent
- Discord 进度草稿:默认把 Discord 回复切换为进度草稿预览,工具与工作活动集中在一条被编辑的消息里,可用
channels.discord.streaming.mode: "off"关闭 - 本地插件包安装:新增
npm-pack:<path.tgz>安装方式,本地 npm pack 产物走与注册表插件相同的受管 npm root 安装、锁文件校验、依赖扫描与安装记录流程 - Windows 插件技能:在 Windows 上以 junction 形式发布插件提供的技能目录,无需开发者模式即可注册插件技能,不再因符号链接 EPERM 失败
- 模型认证可检查:新增
openclaw models auth list [--provider <id>] [--json],在不输出密钥的前提下查看各 agent 已保存的认证配置 - Windows 网关监听修复:Windows 上默认回环网关只绑定
127.0.0.1,避免 libuv 双栈::1行为卡死 localhost HTTP 请求 - 真正的 WeChat 频道:新增
@tencent-weixin/openclaw-weixin外部插件(固定 2.4.1),引导流程与openclaw channels add可默认安装腾讯微信(个人微信)频道
优化 / 变更
- iMessage 路线调整:新部署弃用 BlueBubbles,引导改用原生
imsg路径,BlueBubbles 仍作为受支持的旧版回退 - 加密聊天频道:WhatsApp 支持显式的频道/Newsletter
@newsletter出站消息目标,不再错误路由为私聊 - Discord 与 Slack 流式:Slack 新增
streaming.progress.render: "rich"的 Block Kit 进度草稿;各频道默认限制进度草稿的工具行数量,减少长行折返带来的跳动 - Codex 审批:默认不再安装 guardian 之前的原生
PermissionRequesthook,让 Codex 审查者先批准安全命令;同一会话窗口内记住allow-always决定 - 会话 CLI 与状态:
openclaw sessions表格显示所选 agent 运行时;/status显示 Gateway 与宿主系统运行时间;openclaw cron list --agent <id>支持按 agent 过滤 - 频道状态诊断:
openclaw channels status与openclaw status --deep暴露 Discord 传输降级与 Gateway 事件循环饥饿信号 - Control UI:会话选择器新增按 agent 过滤;连续重复的纯文本消息折叠为一个带计数的气泡;New Job 侧栏可折叠
- Agent 进度输出:
/verbose与进度草稿默认使用紧凑的 explain 模式工具摘要,可用agents.defaults.toolProgressDetail: "raw"调试原始输出 - 网关性能:推迟非就绪 sidecar 到 ready 信号之后、避开热路径频道插件 barrel 导入、快路径复用受信任内置插件元数据,降低启动开销
- 沙盒与运行时状态:沙盒容器与浏览器注册表改为按运行时分片文件,减少无关会话锁争用(
doctor --fix自动迁移旧单体注册表) - OpenRouter:新增可选响应缓存参数与应用归属分类,仅对已验证的 OpenRouter 路由发送
- 托管代理与 Docker:新增
proxy.loopbackMode控制 Gateway 回环控制面流量;内置 docker-compose 去除NET_RAW/NET_ADMIN并启用no-new-privileges - SDK 与插件钩子:新增
plugin-sdk/channel-message生命周期助手、actions.prepareSendPayload(...)、before_agent_run放行/阻断闸门与有界的before_agent_finalize重试指令 - 配置行为:Nix 模式下启动期派生的插件启用、网关令牌、Control UI 来源与所有者显示密钥保持仅运行时,不再改写
openclaw.json - 外部 PR 证据要求:外部 PR 必须附带修复后的真实行为证明(终端截图、控制台输出、脱敏日志等),单元测试与 CI 仅作为补充
修复
- 安全:共享记忆的
wiki_search/wiki_get强制会话可见性(GHSA-72fw-cqh5-f324);执行审批的argPattern参数限制现在也在 Linux/macOS 生效;Windows 上不再受工作区.env的SystemRoot/WINDIR/LOCALAPPDATA影响而重定向 ACL、注册表与cmd.exe解析 - 浏览器 SSRF:读取已选标签页的 console、错误、网络请求、截图、快照、storage 等路由前先执行当前 URL 导航策略检查
- 更新与 CLI:
openclaw update在自定义全局安装根上使用 pnpm--global-dir,不再创建第二份默认前缀安装;shell 补全源行加文件存在性检查,卸载后新登录 shell 不再报错 - 定时任务:
doctor --fix修复payload.model为"default"/空白/JSON null 的 cron 任务;修复与 cron 计划不再对齐的未来nextRunAtMs,时区感知的每日任务不再卡在过期未来日期 - 消息投递:出站投递无适配器结果时上报
deliverySucceeded=false,空投递不再伪装成功;Telegram 媒体占位按保存的 MIME 元数据生成,非图片附件不再被当成<media:image> - Telegram:DM、群组、原生命令与回调授权支持
accessGroup:*发送者白名单;长文本最终回复复用现行预览作为首段,不再产生先出现又消失的额外气泡 - Discord:REST 与网关 WebSocket 启动路径优先 IPv4,纯 IPv4 网络不再卡在 READY 之前;心跳 ACK 超时从实际发送时刻计算,避免误重连
- Slack:保留 Socket Mode SDK 错误上下文与结构化 API 字段,启动失败不再只显示
unknown error;健康监控恢复不再污染手动停止状态 - Feishu / Matrix / LINE:补齐原生话题起始线程 ID 让首轮与后续同话题;Matrix 审批投递最多重试 3 次;LINE 拒绝无通配
allowFrom的dmPolicy: "open" - Provider:xAI 不再向原生 Grok Responses 模型发送 OpenAI 风格推理强度(
xai/grok-4.3不再报 Invalid reasoning effort);Fireworks Kimi 模型暴露为仅思考关闭 - 记忆与压缩:上下文引擎在源历史缩短或装配失败时让缓存视图失效;压缩摘要预留 token 按各模型输出上限钳制;safeguard 压缩下停用 Pi 自动压缩,避免二者互相抢夺
- 会话与转录:
sessions cleanup顺带清理无引用的转录、压缩检查点与轨迹制品;openclaw sessions默认只输出最新 100 行并支持--limit分页 - 网关稳定性:可选插件能力缺失时网关继续运行并记录配置警告;关闭时取消延迟的 post-ready 维护并抑制快速重启后的维护/定时启动,避免孤立后台定时器
- Control UI / TUI:聊天重新加载后保留已持久化的助手进度文本;TUI 交互启动跳过通用 respawn 包装、终端丢失时干净退出;
doctor --fix可修复已卡在 heartbeat 历史的主会话 - 依赖安全:传递依赖
ip-address覆盖到 10.2.0、basic-ftp升到 5.3.1,移除有漏洞的旧构建
本版本对应 CHANGELOG 的 Unreleased 段(最终发布未再新增条目):共 115 项变更 + 351 项修复。正式版发布前另有 2026-09-18 的 v2026.7.33 修正版。
v2026.7.34
2026-09-20(Extended Stable 7.x 线补丁版;latest 标签仍为 v2026.9.5)
新功能
- 模型家族扩展:在 extended stable 线上补齐 GPT-6 Astra、GPT Image 2.5 Flare/Sunburst、Muse Spark 1.3、Claude Opus 5、Gemini 3.6/3.7 Flash、Grok 4.6、Kimi K3、GLM 5.3、Qwen 3.8、DeepSeek V4 Flash Vision Experimental 与 Nemotron 3.5 Lightning 的 Provider 目录与运行时策略支持;Fable 5.1 仍延后,因其前缀绑定推理契约需要更新的 append-only 回放生命周期
- GPT-5.6 兼容:在直连 OpenAI 与 Codex OAuth 路由上保留并验证完整的 GPT-5.6 Sol / Terra / Luna 家族,含推理控制、定价、上下文与视觉元数据
修复
- 安装器恢复:安装修复尝试也失败时,保留原始 npm 恢复诊断信息,让运维看到可操作的包管理器错误,而不是二次清理失败
本版本为 extended-stable 候选,基于 v2026.7.33 之后的完整 11,198 次提交审计选出,将已批准的 Provider 与安装器切片适配到 7.33 的 SDK 与配置面,未引入后续架构重构。
v2026.7.35
2026-09-21(Extended Stable 7.x 线补丁版;extended-stable 标签已从 2026.6.35 指向本版,latest/beta 仍为 v2026.9.5)
修复
- Doctor 插件注册表:Doctor 创建或修复注册表状态时,现在会保留完整的内置插件清单,确保默认的 Browser、Canvas、配对、文件传输、手机控制、Talk 语音与 Bonjour 插件在重启后依然可用
- 状态迁移发现:可自动从 2026.7.34 写出的不完整注册表中恢复,同时保留外部插件的安装记录(由 #136045 回移)
本版本为 extended-stable 后续补丁,基于上一版 2026.7.34 审计游标之后的完整 1,418 次提交审计选出;干净安装与从 2026.6.35 升级过程中未发现其它需要在 7 月线上回移的缺陷。
v2026.9.6
2026-09-24(正式版)|2,614 个 PR · 178 个直接提交 · 350 位贡献者
本版聚焦四大方向:更清晰的可控更新结果、重启后未完成工作的自动恢复、完整的 30 天 Usage 用量报告,以及更强的远程工作区与协作能力。新增内置 GitHub 阅读器(在聊天旁查看公开讨论与 diff)、远程工作区的 Files/Memory/Skills 支持、会议笔记随录制实时更新;可选 Decision Models 引入 TypeSafe Jev 与本地 ONNX/Kev 方案;聊天模型新增 Claude Opus 5.5、GPT-6 Sol/Luna、Grok 4.7。
新功能 / 亮点
- 可控更新结果更清晰:Managed updates 可在保留可恢复插件警告的同时完成,并让已核验的新 Gateway 继续运行、等待剩余维护;结果能区分「请求版本健康」与「已回滚到先前版本」,并列出仍待处理的修复项
- 重启后恢复未完成工作:重启恢复能力增强,未完成的导入、备份与工作流可在核验后恢复(Recover verified session imports)
- 完整 30 天 Usage 报告:Usage 页默认展示最近 30 个自然日,覆盖你可查看的完整会话报告(含列表之外的历史与总计);新增 Started by 按发起人对比 token、估算成本与会话数;成本为估算而非账单,加载中/不完整会明确标注
- 内置 GitHub 阅读器:在聊天旁查看公开 issue、PR 讨论、commit 与可展开 diff,最多十个仅内存标签页,带自动检查快照(30 秒缓存,最多 100 项);仅公开内容、只读,私有内容与编辑仍留在 GitHub
- 远程工作区支持 Files/Memory/Skills:可把上传文件送到 agent 工作区所在的计算机,并在聊天中取回其生成的文件;同一计算机上可使用 Memory 文件与受支持的 Workspace Skills(需显式配置主机集成与文件/命令授权,默认每文件 50 MiB)
- 会议笔记实时更新:录制进行中即可跟随会议笔记(有新语音时约每 5 分钟更新一次),录制结束给出最终笔记;支持语音采集、Google Meet、Microsoft Teams、Zoom;Meetings 页自动刷新,完整转录单独保留在专属标签页
- 命令面板启动后台工作:用 Cmd/Ctrl+K 打开命令面板,可从文本或粘贴的截图启动独立任务,同时保留当前对话与草稿;可提及最多十人;普通 Enter 仅应用当前搜索而不打开过期结果
- 选择新会话的运行位置:新会话放置选择器更易确认云配置、操作系统、机器规格与起始分支,并提交所选项;启动进度与提示/附件并排可见;管理员可用可访问的绝对路径(含有效 Git HEAD)注册已有仓库
- 会话分组 / 归档 / 重开:可直接在侧边栏归档或恢复会话(带撤销),键盘快捷键可新建会话草稿或归档当前会话;归档保留对话与其工作,分组移动立即生效并在刷新失败时保留已确认位置
- 聊天内搜索与历史定位:搜索可找到当前侧边栏未加载的已授权会话,带头像、归属徽章、高亮匹配与 All/Sessions/Messages 过滤;聊天内按 Escape 关闭转录搜索而不清空草稿
- 设置内配置并测试 Web 搜索:Settings → Search 汇集 provider 配置、路由信息与真实测试查询;只读用户可查看 agent 与模型将使用的搜索路由,管理员可配置托管 provider 并按账号限额与计费测试
- 系统忙闲面板(可移动):区分主机与 Gateway CPU 读数,可用鼠标/触摸/键盘移动并记住位置;高 ping 会显示警告色,不可用的计数器直接不显示而不是给出误导数值
- 空闲无头节点自动更新:打包的无头节点在 stable/beta 通道且工作与清理空闲时自动更新,保留配对、设置与启动选项;连接后每小时检查,两次激活间隔至少 12 小时,替换无法启动时回退到先前运行时
- 决策模型(Decision Models):新增独立于聊天的可选 Decision Model 角色(默认关闭),供插件在选项间选择、给信息打分或估计条件是否满足;提供 TypeSafe Jev(托管)、本地 ONNX(CPU 本地推理,七种预设)与本地 Kev 服务器三种方式;选用决策模型不会启动后台工作或赋予 agent 新工具与执行权限
- 新模型支持:Claude Opus 5.5(anthropic/claude-opus-5-5,思考始终开启,默认 medium)、GPT-6 Sol 与 Luna(文本/图像/工具,走 OpenAI Responses API 或 ChatGPT 登录)、Grok 4.7(低到 xhigh 推理级别,成为 xAI 新安装默认)、Xiaomi MiMo V2.6(Pro/Flash/Pro UltraSpeed)
- 在聊天中使用已安装的编码 agent:可从 Models 设置选择已安装的 OpenCode、Qwen Code、Pi ACP、Kilo Code,以及已安装并登录的 GitHub Copilot CLI,在普通聊天中使用其流式回复
重要 / 破坏性变更
- 压缩检查点控制退役(破坏性):专用的压缩检查点链接、历史卡片与分支/恢复控制已移除,同时移除
sessions.compaction.list、sessions.compaction.branch、sessions.compaction.restore;普通 Fork、rewind、会话历史、压缩摘要与 token 节省报告仍然保留。检查点恢复没有等价替代,且无需数据清理或配置迁移 - FreeBSD 源码安装(破坏性):在 FreeBSD 上不再支持源码安装,会在改动现有安装前停止并引导至包安装路线(发布版 npm 或兼容的已构建 .tgz 包);用 pkg/Ports 管理的继续用包管理器。此变更不使 FreeBSD 成为 Tier 1 平台
- 会话发布共享状态模式变更:发布会话工作改为 shared state schema 18,旧版本拒绝读取;升级前请停止旧写入方并保留能捕获 SQLite WAL 中数据的已核验备份
- 模型发现语义变更:默认 merge 模式目录现在会显示新发现的合格模型;仅保存 provider 数组不再限制发现范围,如需限制请使用显式
modelPolicy.allow或models.mode=replace - 降级注意:降级到旧版本前请先移除已保存的
file.create授权(远程工作区文件传输相关)
优化 / 变更
- 安装与引导:Windows 安装在 Node 包管理器尝试失败后可继续尝试其余选项,再向用户账户下载官方便携运行时(无需管理员权限);支持按完整路径识别受支持的 JavaScript CLI 启动器,无需修改 Windows 可执行扩展设置
- 配置与存储问题恢复:无效配置阻塞安装时,报错会引导先运行
openclaw doctor --fix再重试;保存推荐与进度期间安装保持响应 - 自定义 agent:通过 Control UI 新建的自定义 agent 会将其已批准用途保存为后续对话的指令;重开「New agent」会带回创建选项而不丢弃 Ask OpenClaw 对话
- 更精简的安装体积:macOS/Windows/Linux 生产 npm 安装减少约 18 MiB 未使用的 Bash 解析器材料,命令解析行为不变
- 减少重复工作:会话列表/刷新、模型目录、Usage 报告、会议笔记数据库操作等多处移出 Gateway 主线程或复用缓存,显著降低大会话量下的重复计算与临时分配
- Doctor 与插件:修复插件版本问题并给出可操作指引、更新期间保留本地插件覆盖;Chat 插件卡片安装后更新为 Installed,插件档案避免仅开发依赖导致的失败
- 模型设置统一:Models 设置把全局默认与所选 agent 的 provider 连接汇入同一流程,保存凭据与模型激活分离;仅改模型会保留兼容的已保存运行时、清除不兼容运行时及原生同意
- Gateway 与舰队:大规模安装中已就绪的 prepared agents 可在其余舰队启动完成前接受请求;大舰队更新复用配置与插件检查并优先执行启动必需的修复
- 渠道与消息:Telegram 保留群组历史与快速粘贴分片、Discord 委派工作时进度可见、Teams 反应定位到当前消息、WhatsApp 快速消息保序、Signal 链接完整等多项渠道修复
修复
- 更新与回滚:避免并发数据库写入时的误报恢复告警、中断核验后识别已完成更新、回滚后报告恢复版本与 Gateway 健康、防止重复的更新最终化、在有已核验 Gateway 服务时以延后维护完成更新
- 更新失败报告:保存的更新报告保留脱敏失败原因、指出失败的操作并显示恢复路径与观察到的回滚结果;区分「完成但进程退出慢」与「从未完成」的检查
- 会话与聊天:保留接收输入顺序、重连/刷新后不复活已裁撤提示、协作编辑时不打断他人阅读位置、并行会话保持各自草稿与视图状态
- 模型运行时:恢复 Windows 模型运行与会话设置持久化、按 ID 或 provider 引用查找模型、避免成功模型测试后的误报安装失败、通过 Gateway 校验 session_status 模型变更
- CLI agent:前台 Bash 超时后保留 Claude CLI 的后续工具与最终答案、Windows 上启动受支持的 npm 安装的 Claude CLI 包装器、系统时钟变化时保持 CLI 恢复时序稳定
- 语音与通话:离开会议时等待音频启动与运行时关闭完成再报告成功,重入同一会议会等待该清理
- 记忆与技能:嵌入不可用时仍能查找记忆、记忆索引与保存持续推进、技能内容变化时刷新、在远程工作区主机读取与管理 Skills
v2026.8.33
2026-09-29(Extended Stable 8.x 线补丁版;extended-stable 标签已从 2026.7.35 指向本版,latest/beta 仍为 v2026.9.6)
新功能 / 亮点
- 旗舰模型扩充:在 extended-stable 线上新增 Meta Muse Spark 1.3、Anthropic Fable 5.1、OpenAI GPT-6 Astra,以及 OpenAI/fal 的 GPT Image 2.5 支持
- GPT-5.6 全家族支持:完整保留 Sol、Terra、Luna 的目录、路由、迁移、图像、视觉与思考行为,包括跨模型运行时边界的 Ultra 推理与 Bedrock 工具结果图像
- 安全聚合修复:梳理所有影响 2026.8.2 的仓库安全公告,加固 Prometheus 指标鉴权与 Discord 资产/语音归属,并清除生产环境 Nodemailer 公告门禁
优化 / 变更
- 发布准备:将 OpenClaw、全部可发布插件与原生版本元数据统一规范到 2026.8.33,同时保留 2026.8.2 的发布线兼容发布流程
修复
- Anthropic 推理连续性:在模型切换与运行时事件之间保留 Fable 5.1 的推理过程
- OpenAI 模型发现:必须成功完成模型发现后,才通过 OAuth 提供 GPT-6 Astra
- Doctor 技能状态:自动更新期间保留被显式启用的技能
- 生成媒体:后续工具调用失败时仍保留已生成的图片
- Matrix 验证:在报告设备信任前刷新验证状态
- Prometheus 鉴权:拒绝缺少所配置 operator-read 权限域的指标抓取
- Discord 媒体策略:对公会资产上传强制执行发送者媒体策略
- Discord 实时归属:在语音生命周期切换中保留说话人与播放归属
- Discord 咨询取消:把主机侧取消的实时咨询记录为取消,抑制通用错误回退,并让语音会话保持就绪以处理下一次请求
- 依赖安全:将 IMAP 依赖图谱覆盖为 Nodemailer 9.1.1,清除地址解析拒绝服务及相关域名/内容访问公告
- iOS 发布校验:在 151.0.0 构建产物被撤回后,把 WebRTC 二进制依赖更新到 152.0.0
本版本为 extended-stable 8.x 线的补丁版,承接 2026.8.2 发布线做安全与稳定性回补。
v2026.9.7
2026-09-30(正式版)|2,818 个 PR · 518 个直接提交 · 344 位贡献者
本版让 OpenClaw 在高负载下更轻快、长对话更顺滑,并带来更可靠的更新备份与回滚保护,同时修复了从 2026.9.5 升级的问题。新增 OpenAI Agents API 运行时与 Sign in with ChatGPT(Beta)登录,改进 Mac / iPhone / iPad 上的聊天体验,并让重启后更容易接着做未完成的工作。
新功能 / 亮点
- OpenAI Agents API(托管工作区运行时):可选的 Agents API 运行时可让对话跑在持久化的托管 Linux 工作区里,支持联网搜索、OpenClaw 工具与受支持 Linux 存储上的文件传输;需带所选模型权限的 OpenAI API Key。自托管执行需自备 controller 与匹配的 workspace 路径,且不支持文件传输。官方建议仅在单用户 Gateway、并让 OpenClaw 独占控制会话时使用
- Sign in with ChatGPT(Beta):OpenAI 配置现在能更好区分 Codex 登录、ChatGPT 登录与 API Key 三种方式,模型选项与所选账号绑定;同一已验证账号重新登录会保留对话选择。面向已注册并同意共享 token 的账号,不覆盖全部模型与媒体工具,OpenClaw 无法显示其配额或设置单应用限额
- GPT-6 Sol 与 Luna 扩展:对拥有访问权限的账号,GPT-6 Sol/Luna 现可通过受支持的 OpenAI API、ChatGPT 与原生 Codex 连接使用;发现逻辑修复让订阅账号也能找到它们。要使用 OpenClaw 自带运行时需在运行时设置中显式选择
- 更可靠的更新备份与自动回滚:Verified backups 会检查采集时记录的每个数据库是否都在(含自定义与已迁移的 agent 数据库);对在新版本允许启动前失败、符合条件的更新,提供自动数据库回滚。更新成功后更新器会删除数据库快照,失败或未核验的更新则保留快照并可能让 OpenClaw 停住
- 隐身对话(Incognito)更严格:隐身对话在创建后 24 小时或 Gateway 重启时(先到者)过期,活动不会延长期限;过期会停止进行中的工作并直接丢弃对话(无归档);同时跳过自动记忆与学习流程,并把内容排除在保存的浏览器副本与诊断日志、插件观察之外
- Mac App 内置 Web 聊天:兼容 Gateway 上的完整 Mac 聊天窗口默认改用网页聊天界面(含原有 Native 用户),富文本回复与会话控制位于 Mac 侧边栏、菜单与 Cmd-K 搜索旁;新增原生 Cmd-K 命令面板;侧边栏默认最新创建的线程在前并隐藏消息预览、自动化会话与系统会话
- 会话与聊天体验:长对话在 Control UI 中滚动更顺、加载更早消息停顿更少;侧边栏 Filter & sort 面板把过滤与显示选项聚合;置顶会话跨 agent 保留在 Pages,保存的 fork 在重启后仍位于其父对话下方
- Automations(自动化)更清晰:为具名会话排定的任务现在跑在其保存的项目目录或托管 Git worktree 中(缺失或不匹配则停止);编辑器会在保存前捕获无效 webhook 地址,并正确保存每小时任务的默认时间窗
- 技能与记忆:编辑过的技能在文件夹被替换或文件监听失败后能更一致地被 agent 采用;记忆搜索在可选嵌入服务失败时可回退到现有关键词匹配;混合中英文问题会保留英文词
- 云端会话与恢复:停止一个云会话不再阻塞无关会话启动;被中断的下载可续传,兼容的 warm images 跳过多余快照准备;中断的 Stop 在重启或更新后可恢复保存工作区
- 聊天内改设置与更新技能:可让 agent 修改 OpenClaw 设置并更新自己拥有的技能(现有审批仍然适用);通过聊天保存的密钥会进入共享团队存储
重要 / 破坏性变更
- Tasks 与 TaskFlow 退役(破坏性):Tasks 与 TaskFlow 面板、命令与 API 全部移除。相应工作请改用 subagent 控件、ACP 会话、后台进程、Cron 历史或 Lobster 管线;对话转录、Workboard 与生成媒体完成仍保留。插件作者须从已移除的 Task 接口迁移;subagent 的等待/取消调用现在使用
runId与runIds。TaskFlow Webhook 没有等价的 HTTP 替代 - Tool Search 迁移(破坏性):Tool Search 现使用分离的搜索、描述与调用工具,旧的 JavaScript 工具
tool_search_code被移除,JavaScript 编排请改用 Code Mode;正常更新会迁移退役设置,手动升级后须先运行openclaw doctor --fix,否则旧设置会阻止启动 - 环境变量表达式语义变更:现有
${VAR:-fallback}文本现在会展开为环境变量值或回退值;若要字面文本请改用$${VAR:-fallback}。请检查现有凭据,部分取值含义已改变可能影响访问 - 定时任务脚本参数:创建 system-event 任务的脚本请移除
--timeout-seconds(cron add/create 现在会拒绝该此前被忽略的选项);agent 与命令任务仍支持 timeout,脚本任务改用--script-timeout-seconds - Crabbox 提供商要求:所有 Crabbox 提供商现需 0.67.0 或更新;若主机无法下载更新,请先安装受支持的可执行文件再更新 OpenClaw,否则检查与清理可能失败
- 云端运行时安全提示:丢失的机器只留最后保存的工作区,强制销毁会丢弃未保存的编辑;失败的清理可能让机器继续运行并计费,如自动清理放弃请检查并停止 Crabbox 租约后重试 Stop
优化 / 变更
- 安装与引导:首次运行设置更快到达第一个问题,并在登录/配对/安装需要处理时给出更清晰指引;
openclaw setup --baseline --skip-bootstrap会记住该选择并保留已有文件 - 模型账号登录:首次设置会再次显示检测到的 API Key 与 token,Connect & verify 可核验凭据并选择 agent 模型;设备码登录不再因 OpenClaw 较短的计时器提前结束;可对同一提供商与设置目标重启被放弃的登录(请使用最新的登录链接)
- 精简体积:多处生产 npm 安装减少未使用材料;会话列表/刷新、模型目录、Usage 报告、会议笔记等数据库操作移出 Gateway 主线程或复用缓存
- 插件页面:插件页现在会说明集成的作用与设置方式;修复插件更新、云会话与已连接编码 agent 的问题
- 渠道消息:Telegram 富文本回复保持表格对齐、代码块不再有多余格式标签;定时帖子也会获得发送账号的格式化指引
- 更多日常设置入聊天:可让 agent 修改 OpenClaw 设置、编辑自己拥有的技能;终端控件与繁忙对话体验同步改进
修复
- 更新与回滚:在 WAL 模式数据库写入时采集一致的更新快照、兼容的变更提交 warm start 延后替换快照、修复 Windows 备份的数据库路径别名、恢复 Doctor 编辑过的配置 include、定位旧版 pnpm 更新副本与托管服务临时目录
- Agents API 运行时:向新会话提供工作区规则与 persona、从结算的原生轮次上报 token 用量、按模型支持设置推理级别、保留对话上下文、临时服务器错误后重试提交
- ChatGPT / OpenAI 账号:OAuth 登录后保留对话账号选择、刷新 Profile 账号、登录期间模型选择器可用、跨轮次刷新 Codex ChatGPT 凭据、将 OpenAI 媒体工具匹配到相容凭据
- Telegram 与渠道:隐式回复线程关闭时保持引用流式回复原位、在部分流式收尾时保留富文本
/status表格、保留群组历史与快速粘贴分片 - 记忆与技能:嵌入服务不可用时回退关键词搜索、修复旧 Dreaming 排程、保护独立 QMD 文件、agent 在文件夹替换后一致采用编辑过的技能
- 云端与插件:停止一个云会话不再阻塞其他会话、恢复中断下载、兼容 warm image 跳过快照准备、中断的 Stop 可恢复保存工作区
v2026.8.34
2026-10-01(Extended Stable 8.x 线补丁版)|113 个入选修复单元:60 个精确源码提交 · 25 项实质改编 · 27 个从大型/混合用途 PR 中窄切出的片段 · 1 项 2026.7.35 插件清单一致性修复
本版为 extended-stable 8.x 线的正确性回滚补丁(承接 2026.8.33),对升级、Doctor、认证、会话、频道、插件、沙箱、文件系统安全、模型运行时与发布打包共回移 113 个经审计筛选的修复单元。本轮不沿用上一条回移游标,而是重新扫描 2026.8.33 发现范围、大型混合用途 PR 与 2026.7.35 血脉,做了一次完整重扫。
新功能 / 亮点
- Extended-stable 正确性汇总:跨升级、Doctor、认证、会话、频道、插件、沙箱、文件系统安全、模型运行时与发布打包回移 113 个审计入选的修复单元
- 完整重扫:重新评估整个 2026.8.33 发现范围、大型混合用途 PR 与 2026.7.35 血脉,而非仅从上一条回移游标推进
- 升级与恢复加固:在升级、重启与 Doctor 修复过程中保留凭据、agent 状态、插件清单、对话转录、排程、服务归属与运行时链接
- 边界修复:收紧远程文件系统变更、插件与技能扫描、浏览器认证、频道回复身份、私有技能入口与限定范围的运行时归属
优化 / 变更
- Extended-stable 发布准备:将 OpenClaw、可发布插件、原生版本元数据、生成的频道目录与 npm 包清单统一对齐到 2026.8.34
修复
- 插件:在不削弱归属的前提下恢复孤立安装
- Doctor:修复带键的多 agent 花名册而不影响归属(#134706)
- 防止设备配对迁移在受污染记录上崩溃
- Doctor:升级期间保留每个 agent 的记忆搜索
- Doctor:按来源识别共享认证迁移(#134808)
- Cron:拒绝过期的 doctor store 重写
- Gateway:认证变更后刷新模型目录(#134361)
- OpenAI:修复过期的 doctor 路由钉
- 认证:校验共享凭据迁移回执(#134952)
- Cron:模型别名保持限定于所选所有者(#135069)
- 记忆:为兼容的嵌入解析 profile 认证(#134744)
- 认证:恢复因迁移已完成而搁浅的凭据(#135346)
- 认证:重新登录修复升级后过期的 profile 顺序
- 认证:在 Doctor 中保留自定义提供商 SecretRefs
- Docker:在运行时镜像安装 libgomp1 以支持托管 llama.cpp(#134532)
- 设备:允许经授权的限定范围 node token 管理(#135617)
- MS Teams:频道回复缺少 replyToId 时线程上下文被丢弃(#129345)
- UI:忽略仅含工具的模型认证行(#134218)
- Cron:省略 env 时 kind 变更报错 “command env must be an object”(#134639)
- 备份:在遍历前排除工作区
- 基础设施:从 Windows 扩展名查找中丢弃空 PATHEXT 条目(#135807)
- Anthropic:代理省略 message_delta usage 时上下文用量丢失(#135467)
- Systemd:在托管备份中保护凭据(#131786)
- Agents:保留请求方 MCP 运行时归属(#134819)
- 插件:源挂载变化时刷新持久化的注册表(#136517)
- 后续排空重试排空错误时 Gateway 重启挂起(#136713)
- 认证:会话 SDK 刷新期间保留 OAuth 元数据(#127988)
- Doctor:识别已配置的记忆提供商 secret 引用(#137782)
- 会话:保留逻辑共享存储归属(#138380)
- 完全访问权限的任务在 Gateway 重启后丢失工具(#138701)
- 让未变更文件不进入会话 diff(#138877)
- 认证:把计费停用的 profile 恢复时间从小时级缩短到分钟级(#136364)
- 认证:登录期间保持未设置的默认模型不变(#139218)
- Gateway:避免升级中客户端断开时崩溃(#139061)
- Shell-env:登录导入期间保留 CLI 终端归属(#139308)
- 自动回复:把尾部转录增长并入记忆刷新的新总计(#138928)
- Cron:重启后保留待处理的节拍检查(#140083)
- 守护进程:时钟跳变后 systemd 安装不再因 “ownership could not be verified” 中止(#137253)
- 配置:进程内重启后应用环境变更(#141296)
- 模型锁定的 Codex 会话中粘贴文本丢失(#142021)
- Docker:依赖归属守卫后恢复源码构建(#142073)
- 安全:保留现有 WhatsApp 群组允许列表(#142589)
- Doctor:避免安装未选中的搜索提供商(#142640)
- Doctor:迁移旧版 Codex 音乐模型选择器(#143235)
- Doctor:在诊断中保留所选模型元数据(#144332)
- Discord:为线程权限报告父频道拒绝(#121144)
- 配置:保存设置时避免误报模型变更(#144807)
- Doctor:隔离失败时保留旧版注册表文件(#144787)
- 发现对话时保留路由归属(#146927)
- 安装:Node 校验失败时保留运行时链接(#147221)
- 频道配置无已安装插件时 Doctor 报告缺少 OAuth 目录(#147888)
- Doctor:会话修复后停止私有待处理输入重放(#148625)
- 频道:结算任务范围的上下文租约一次(#148922)
- 推送:规范化格式错误的代理认证错误(#149112)
- Cron:在静默排程变更前拒绝无效 stagger(#151740)
- CLI:让模型校验不进入会话执行(#154763)
- Agents:把空凭据环境变量视为未解析(#155558)
- Doctor:对 dream diary 与所有记忆目标处理器应用环境所有者回退(#156437)
- 沙箱:跨运行时目标解除限定范围的重新创建阻塞(#157808)
- 安全:在审计层级检查中解析 gpt 代次编号(#140012)
- Doctor:无默认 agent 时报告共享认证健康(#134902)
- Doctor:收敛冗余的共享认证重定位子集(#135096)
- Doctor:报告保留的设备认证文件(#133978)
- 更新:聊天归属被撤销后停止分离式更新(#137312)
- Doctor:在完整 lint 期间检查源认证存储(#137610)
- Gateway:重启后恢复排队的 RPC 回复(#138565)
- Doctor:配置修复期间保留旧版归属(#138837)
- 防止 Doctor 中浏览器 profile 权限挂起(#139612)
- Gateway:防止 systemd 重启挂起(#140914)
- Doctor:恢复范围无效的旧版 node token(#143599)
- 技能:网关重启时刷新会话快照(#122110)
- Doctor:会话 SQLite 导入丢弃旧版转录中的 Codex 助手消息(#140296)
- Cron:在排程运行中转发 claude-cli 认证 profile 以防止 OAuth 过期(#144266)
- Discord:保留发送方拥有的行数限制与回复范围(#137969)
- 安装:安装期间绝不替换或破坏现有 nvm(#145317)
- 会话:在 Doctor 中恢复被省略的历史转录(#120781)
- 更新:识别自定义 npm prefix 安装(#146091)
- 上下文:在回复维护前保留提供商范围的提示预算(#141052)
- 会话:防止 Doctor 与启动时记忆耗尽(#149704)
- 守护进程:服务升级期间保留内联认证(#149686)
- 更新:用服务凭据校验配对的受信代理网关(#153540)
- 后台续跑丢失会话访问与 GitHub 工具(#141865)
- Doctor:跨读取分块边界解码会话头(#154034)
- 故障的压缩探针卡住运行转向并使重启中止(#154868)
- UI:发布被拒绝的目标操作(#156363)
- 命令:去重会话生命周期键(#158487)
- 插件:保留运行时产物偏好(#158487)
- Agents:从公共入口剥离私有技能编写(#159220)
- 插件:卸载期间保留 include 归属(#159945)
- 频道:恢复系统 agent 审批反应(#159132)
- Moonshot:拒绝继承的思考模型键(#158437)
- 腾讯:忽略继承的 effort-map 键(#158437)
- Workers:观察已中止的操作 promise(#158228)
- Gateway:拒绝非对象的 Claude 历史行(#158228)
- Copilot:同步工厂失败后恢复连接池(#157819)
- Tlon:保留 IPv6 ship 来源(#157825)
- SMS:清理已撤销的入站媒体(#157825)
- Slack:保留替换 webhook 注册(#158085)
- Matrix:接受系统 agent 审批反应(#158164)
- 频道:重启后保持输入指示互斥(#158830)
- ACP:格式化未设置的可选工具参数(#159417)
- 会议:清理部分启动的音频(#157982)
- Exec:保留已准备的插件环境(#158378)
- MXC:桥接失败后清理临时目录(#158532)
- Discord:保留批量原生回复身份(#158886)
- 技能:将省略的危险 exec 别名只计一次(#158906)
- 沙箱:保留远程变更路径字节(#159346)
- 浏览器:接受标准 CDP 头容器(#159430)
- 插件:保留稀疏目录偏好(#159945)
- Doctor:保留完整插件清单(#153901)
- Fs:保留有界文件系统正确性(#157524)
本版本为 extended-stable 8.x 线的补丁版,承接 2026.8.33 发布线做正确性与稳定性回补;完整贡献记录:113 个入选单元 = 60 个精确源码提交 + 25 项实质改编 + 27 个从大型/混合用途 PR 中窄切出的片段 + 1 项 2026.7.35 插件清单一致性修复。变更正文取自 npm tarball 内的 package/CHANGELOG.md,发布说明见 https://docs.openclaw.ai/releases/2026.8.34
v2026.8.35
2026-10-03(Extended Stable 8.x 线补丁版;extended-stable 标签已从 2026.8.34 指向本版,latest/beta 仍为 v2026.9.7)
新功能 / 亮点
- GPT-6.1 Sol 支持:在 OpenAI 路由、模型发现、推理链路、运行时挂钩与 Reef 防护模型边界上全面加入当前 Sol 模型(#161400、#162955)
- 更安全的更新与恢复:恢复过程中保留不兼容插件设置、避免重复启动 Gateway、pnpm 包更新不再因终端失败中断、迁移期间保留插件清单(#160344、#160193、#161920、#161485)
- 更可靠的 agent 完成:保留完整的委派与 CLI 回答、释放挂起的子进程容量、恢复完整的 cron 输出、避免失败请求吞掉转向提问(#162843、#162368、#160520、#162439)
- 安全与归属加固:密钥存储类型在轮换期间保持稳定、恢复已准入的密钥出网执行、修复过期自动快照的同时保留显式 cron 工具白名单(#160926、#160760、#162432)
- 频道与集成可靠性:修复 Gmail 与 IMAP 监听、Matrix 直连映射、Telegram 进度、远程 MCP 启动,以及在干净 Windows 主机上托管 llama.cpp 的启动(#161503、#160413、#161727、#161546、#162376、#163093)
- 性能与 UI 连续性:限制模型目录等待时间、降低 Codex 集群堆内存压力、在历史刷新竞态中保持已保存的 WebChat 回复可见(#161132、#162912、#162763)
优化 / 变更
- Extended-stable 发布准备:将 OpenClaw 与所有可发布官方插件对齐到 2026.8.35,同时保留 2026.8.34 的发布契约
- 模型兼容:在分支原生 OpenAI 与 Reef 兼容归属中加入 GPT-6.1 Sol(#161400、#162955)
修复
- 更新安全:恢复过程中保留不兼容插件设置、迁移期间保留已保留的插件记录、避免 pnpm 终端失败、在容器/直接启动间沿用现有 Gateway 锁(#160344、#161485、#161920、#160193)
- Agent 投递:恢复无上限的 cron 回复、保留完整的 CLI 子代理回答、尊重被跳过的公告、保留分离转录、释放挂起的子槽位、避免失败请求用转向替换先前提问(#160520、#162843、#161542、#161091、#162368、#162439)
- Cron 与工具:限制思考目录的水合、修复过期的自动工具快照而不扩大显式白名单、在创建转向结束后投递手动运行(#161132、#162432、#162780)
- 会话与工具结果:拒绝畸形会话目标、保留生成的子工作目录、安全投影深层嵌套的 MCP 结果、保持远程 MCP 包在原生会话中可用(#161533、#162308、#160825、#162376)
- 频道:恢复 Gmail 瞬时绑定、限制 IMAP 积压处理、恢复 Matrix 直连映射、在钩子抑制预览时恢复 Telegram 进度(#161503、#160413、#161727、#161546)
- 运行时可靠性:防止脱敏停滞、取消过期的思考目录等待、将响应 agent 传给 TTS 模型选择、阻止持久 worker 重试冻结主机、降低 Codex 集群堆使用、在托管 llama.cpp 启动失败后安装所需的 Visual C++ 运行时(#161089、#161319、#161454、#160812、#162912、#163093)
- 密钥与沙箱:在值轮换期间保留密钥条目类型、修复只读复制技能时不逃逸其受限根目录(#160926、#162304、#162295)
- WebChat:当过期历史响应与实时消息竞态时,保持已保存回复可见(#162763)
本版本为 extended-stable 8.x 线的补丁版,承接 2026.8.34 发布线做正确性与稳定性回补;完整贡献记录:v2026.8.34..741d94f 范围内 49 个入选 PR(0 个仅保留种子 PR)。变更正文取自 npm tarball 内的 package/CHANGELOG.md,发布说明见 https://docs.openclaw.ai/releases/2026.8.35
v2026.9.8
2026-10-04(正式版;latest/beta 标签已从 2026.9.7 指向本版,extended-stable 仍为 v2026.8.35)
新功能 / 亮点
- 更安全的更新与 Doctor 恢复:升级/恢复过程中保留插件设置、容忍瞬时 SQLite 争用、阻止不安全的 Windows schema 升级、放行已验证为空的 Telegram 迁移、对深层与大规模集群的修复保持有界(#160344、#160702、#160718、#161832、#162290、#162321、#162394)
- Gateway 可用性:防止容器内出现重复 Gateway、恢复受管代理下的 TLS 健康探测、避免 Windows 编译缓存导致的启动挂起(#160193、#161946、#162841)
- 可靠的 agent 回合:修复 Anthropic 后台命令卡住导致的回合中断,后续消息可继续正常处理(#161260)
- Codex 可靠性:让 Computer Use 的原生应用就绪状态与浏览器认证解耦,并在 Codex 会话发现时避免大规模 agent 集群耗尽 Gateway 内存(#162467、#162912)
- Windows 会话:在大小写不敏感的环境代理下恢复 cron 设置与会话准入(#160075)
- 沙箱与 Telegram 正确性:修复只读技能刷新时的 EACCES 失败,并阻止 Telegram 队列中过期预览跨越写入方权限边界(#160137、#162304)
优化 / 变更
- 无功能性变更:本版为聚焦可靠性与恢复能力的修复热更新,未引入有意的能力变化
修复
- 更新与修复安全:恢复过程保留本地插件配置、拒绝不安全的 Windows 2026.9.4 schema 迁移、在瞬时 SQLite 争用期间保留维护租约、仅归档已验证为空的退役 Telegram 绑定、对深层 owner 链与大规模集群 Doctor 检查保持有界(#160344、#160702、#160718、#161832、#162290、#162321、#162394)
- Gateway 与引导:在容器内强制 Gateway 单属主启动、受管代理下保持本地 TLS 健康检查可用、缩短 Windows 编译缓存路径(#160193、#161946、#162841)
- Windows 会话:在大小写不敏感的环境代理下恢复 cron 设置与会话准入(#160075)
- Agent 回复:后台 Bash 完成后正常结束 Anthropic 回合,后续消息不再被静默跳过(#161260)
- Codex:原生 Computer Use 就绪检查不再触发无关浏览器认证,会话发现时共享已捕获的集群配置以防 Gateway 堆耗尽(#162467、#162912)
- 沙箱与 Telegram:恢复只读安装上的技能刷新,并在 Telegram 编辑前重新校验队列预览的写入方权限(#160137、#162304)
本版本为 2026.9.x 正式版线的可靠性热更新,承接 2026.9.7 发布线;完整贡献记录:v2026.9.7..45369e8 范围内 35 个入选 PR(0 个仅保留种子 PR)。变更正文取自 npm tarball 内的 package/CHANGELOG.md,发布说明见 https://docs.openclaw.ai/releases/2026.9.8
v2026.10.1-beta.1
2026-10-06(预发布版;beta 标签已从 2026.9.8 指向本版,latest 仍为 v2026.9.8、extended-stable 仍为 v2026.8.35)
新功能 / 亮点
- 会话与记忆:注册表变更后保留用量统计、投递来自远程工作区的 worker 附件、防止排队取消与转录别名阻塞活动回合、保持续写签名对齐、以有界批次迁移嵌入缓存并报告超限行(#164217、#164219、#163708、#164230、#164251、#164289、#164287、#164303)
- 回复与媒体:恢复本地视频的内联播放、将被拒绝的媒体链接替换为有用的错误提示、让 Telegram 进度更新不再附带预览卡片、修复启用推理时的纯语音回复(#164137、#163727、#164285、#164256)
- 更新与 Doctor:改进 serving-verdict 恢复指引、在只读受管配置下保持修复可用、移除重复的配置/备份/元数据/pnpm-root 探测、将成功的清理上报为进度而不破坏 JSON 输出、把仍在启动中的 Gateway 视为警告(#164193、#161924、#164235、#162259、#164182、#164186、#164183、#164184、#163477、#164261、#162236、#164312)
- Windows 工作区与浏览器启动:修复空与嵌套的 Windows worktree 创建、改进 Linux 下 Chromium 的发现、在 ARM64 上自动启动 Playwright Chromium(#164202、#164249、#163510、#163281)
- 云 worker 与 Crabbox:暴露真实的云 worker 失败原因、强制 Linux 租约、让 worker 包下载与引导过程重叠、移除无关的预热镜像清理等待、防止慢读取或不支持的后端搁置 worker(#164129、#164187、#164128、#164231)
- 插件、Codex 与 MCP:保留 Bun 包导入捕获、减少预发布元数据请求、防止过期的远程执行审批污染认证配置、恢复节点策略钩子、同步 MCP 表单/文件/上下文、将后台技能评审改由 Workshop 提案路由(#164223、#164185、#164237、#164270、#164277、#164292)
优化 / 变更
- 为隐身 actor 记忆与 Codex 历史路由加入非活动基础能力支持(#164224)
- 将现有 agent 迁移到本地 Claws(#162329)
- 通过提供预备事实、按存储修订复用卡片负载、将生命周期变更移出主线程、保留规范状态句柄,降低会话看板与状态路径开销(#164218、#164301、#163815、#164110)
修复
- 为被取消的排队回合保留插件生命周期围栏,并在就绪 PR 评审中保留已调查的失败记录(#164247、#164253)
- 在状态摘要中尊重 agent 本地的模型别名(#164126、#164115)
- 让 Gateway 测试运行在所选的 Bun 运行时上,并在 Docker 中运行原生 Codex 子代理检查(#164276、#164163)
- 将 webhook 配置迁移交由 Doctor 处理,对未配置的频道跳过 Nextcloud Talk webhook 迁移
本版本为 2026.10.x 线的首个预发布版(beta),承接 2026.9.8 正式版线;完整贡献记录:283 个入选 PR(0 个仅保留种子 PR),审计范围为 9da28ad4..8ea8bb11。变更正文取自 npm tarball openclaw-2026.10.1-beta.1.tgz 内的 package/CHANGELOG.md(预发布版暂未生成 docs 发布页)
v2026.9.9
2026-10-08(正式版;latest 标签已从 2026.9.8 指向本版,beta 仍为 v2026.10.1-beta.1、extended-stable 仍为 v2026.8.35)
新功能 / 亮点
- 模型与提供商:Codex 模型列表加入 GPT-6.1 Sol;Claude Haiku 5.5 可通过 Anthropic API 与 Claude CLI 选用(
haiku别名与 Anthropic 默认工具模型现指向 5.5,默认开启自适应思考;需继续用 4.5 请显式指定模型;超过 10 万 token 的提示词 API 价格上调);内置 Codex 更新至 0.160.0(#65e89fc、#166706、#163560) - 更新与恢复:更新不再因同时保存数据而失败、保留插件完成升级所需文件、避免全局 npm 安装的虚假恢复文件检查失败;失败的更新可在保留数据的前提下恢复出兼容安装(回退到 2026.9.8 后仍可继续更新);修复会中断更新并错误回滚的虚假维护警告;FUSE 存储下的备份/恢复不再因文件时间戳变化而失败(#164554、#164497、#164724、#3ecb62a)
- Doctor 与维护:长时间数据库检查显示进度并响应 Ctrl+C;修复损坏的旧会话归档与中断的归档修复;保留损坏旧插件元数据中的原始记录与有效安装项;打开会话时遵守已存在的损坏隔离;在自动分诊修复被拒的 Gateway 重启后再尝试启动一次(#162213、#164867、#161485、#161783、#160173)
- Web UI 与聊天体验:修复 Windows 空工作区创建失败、会话标题可达重试恢复、跳转到底部后回滚再缩放不再被拽回最新消息、展开消息详情保持位置、流式回复与输入框间距等多项滚动/阅读位置问题(#164202、#163817、#162411、#166200、#166348)
- 消息频道:修复 iMessage 回复写出却未发送、Discord 委派任务结果误判为失败、Google Chat/Slack 线程归属、飞书(Feishu/Lark)带说明的附件被误当视频、取消排队消息时阻塞回复等问题;Telegram Mini App 改用
/controlui(/dashboard归会话看板)(#163742、#163756、#136689、#151896、#164230、#161369) - 自动化与调度:修复旧定时任务到达时限时中断同会话中较新对话并剥夺其工具访问的问题;修复启动后台任务(定时任务或 Skill Workshop 评审)时冻结聊天/断开 Web 界面的问题(#163704、#164049)
- 安全与隐私:替换或导入凭据时保留其原有保护与允许主机、Doctor 将恢复的 Gateway token 存入密钥库(需交互确认,即使
--yes);配对计算机上的插件输入策略可在执行前拒绝请求;A2A 连接对缺失环境变量的 token 直接拒绝;MCP OAuth 拒绝会把凭据发往其他源的跳转;Windows MXC 沙箱可无旧版 Windows 服务启动(#160926、#162372、#164270、#521ae23、#138263、#158303)
优化 / 变更
- Windows 会话存储支持通过 junction 等文件夹链接访问数据库(识别为同一数据库,含等价长路径写法)(#bec0cfd、#162332)
- 修复 Node 上命令输出完毕后仍不退出、配对计算机上会话因常规状态更新显示不可用而停滞等问题(#163788、#164087)
- 委派任务:云会话可启动长任务而不被截短、可见子会话在后续回合保留自身 worktree;父级可收到完整的 CLI 子代理回答,完成子树释放容量(#159459、#162308、#162843、#162368、#163032)
- 源码检出安装下插件技能在更新期间保持可加载(#165882)
修复
- 会话维护命令:无效的重置目标在清空主对话前即被拒绝;压缩不存在的会话会报错(依赖成功的脚本需先检查会话存在或处理该错误)(#161533)
- 从 2026 年 9 月稳定版升级时共享数据保持为 2026.9.8 所用格式;已被 10 月 beta 转换为新格式的数据无法被本版打开,且不会被改动(本版无法降级或修复该数据)(#166959)
本版为 2026.9.x 正式版线的可靠性热更新(规模:112 个 PR、69 个直接提交、91 位贡献者),无破坏性变更;亮点集中在更新/Doctor 恢复能力、Web 聊天滚动与阅读位置、消息频道正确性、以及 GPT-6.1 Sol 与 Claude Haiku 5.5 模型支持。变更正文取自 https://raw.githubusercontent.com/openclaw/openclaw/main/CHANGELOG/2026.9.9.md(docs 发布页 https://docs.openclaw.ai/releases/2026.9.9)
v2026.10.1-beta.2
2026-10-08(预发布版;beta 标签已从 2026.10.1-beta.1 指向本版,latest 仍为 v2026.9.8、extended-stable 仍为 v2026.8.35)
新功能 / 亮点
- 会话与记忆:注册表变更后保留用量、投递来自远程工作区的 worker 附件、防止排队取消与转录别名阻塞活动回合、保持续写签名对齐、以有界批次迁移嵌入缓存并报告超限行(#164217、#164219、#163708、#164230、#164251、#164289、#164287、#164303)
- 回复与媒体:恢复本地视频内联播放、将被拒绝的媒体链接替换为有用错误、让 Telegram 进度更新不带预览卡、修复启用推理时的纯语音回复(#164137、#163727、#164285、#164256)
- 更新与 Doctor:改进 serving-verdict 恢复指引、在只读受管配置下保持修复、移除重复的配置/备份/元数据/pnpm-root 探测、清理成功上报为进度且不破坏 JSON 输出、把仍在启动中的 Gateway 视为警告(#164193、#161924、#164235、#162259、#164182、#164186、#164183、#164184、#163477、#164261、#162236、#164312)
- Windows 工作区与浏览器启动:修复空与嵌套 Windows worktree 创建、改进 Linux 下 Chromium 发现、在 ARM64 上自动启动 Playwright Chromium(#164202、#164249、#163510、#163281)
- 云 worker 与 Crabbox:暴露真实云 worker 失败原因、强制 Linux 租约、让 worker 包下载与引导重叠、移除无关的预热镜像清理等待、防止慢读取或不支持的后端搁置 worker(#164129、#164187、#164128、#164231)
- 插件、Codex 与 MCP:保留 Bun 包导入捕获、减少预发布元数据请求、防止过期远程执行审批污染认证配置、恢复节点策略钩子、同步 MCP 表单/文件/上下文、将后台技能评审改由 Workshop 提案路由(#164223、#164185、#164237、#164270、#164277、#164292)
优化 / 变更
- 为隐身 actor 记忆与 Codex 历史路由加入非活动基础能力支持(#164224)
- 将现有 agent 迁移到本地 Claws(#162329)
- 通过提供预备事实、按存储修订复用卡片负载、将生命周期变更移出主线程、保留规范状态句柄,降低会话看板与状态路径开销(#164218、#164301、#163815、#164110)
修复
- 为被取消的排队回合保留插件生命周期围栏,并在就绪 PR 评审中保留已调查的失败记录(#164247、#164253)
- 在状态摘要中尊重 agent 本地的模型别名(#164126、#164115)
- 让 Gateway 测试运行在所选的 Bun 运行时上,并在 Docker 中运行原生 Codex 子代理检查(#164276、#164163)
- 将 webhook 配置迁移交由 Doctor 处理,对未配置的频道跳过 Nextcloud Talk webhook 迁移
本版为 2026.10.x 线第二个预发布版(beta),同样承接 2026.9.8 正式版线,内容与 beta.1 的 PR 主题一致(审计范围 9da28ad4..8ea8bb11,283 个入选 PR),并附带上线 2026-10-01/10-02 起生效的多项弃用告警。变更正文取自 npm tarball openclaw-2026.10.1-beta.2.tgz 内的 package/CHANGELOG.md(预发布版暂未生成 docs 发布页)
v2026.10.1
2026-10-11(正式版;latest 标签已从 2026.9.9 指向本版,beta 由 2026.10.1-beta.2 收敛到本版,extended-stable 仍为 v2026.8.35)
新功能 / 亮点
- 会话与记忆:注册表变更后保留用量、投递来自远程工作区的 worker 附件、防止排队取消与转录别名阻塞活动回合、保持续写签名对齐、以有界批次迁移嵌入缓存并报告超限行(#164217、#164219、#163708、#164230、#164251、#164289、#164287、#164303)
- 回复与媒体:恢复本地视频内联播放、将被拒绝的媒体链接替换为有用错误、让 Telegram 进度更新不带预览卡、修复启用推理时的纯语音回复(#164137、#163727、#164285、#164256)
- 更新与 Doctor:改进 serving-verdict 恢复指引、在只读受管配置下保持修复、移除重复的配置/备份/元数据/pnpm-root 探测、清理成功上报为进度且不破坏 JSON 输出、把仍在启动中的 Gateway 视为警告(#164193、#161924、#164235、#162259、#164182、#164186、#164183、#164184、#163477、#164261、#162236、#164312)
- Windows 工作区与浏览器启动:修复空与嵌套 Windows worktree 创建、改进 Linux 下 Chromium 发现、在 ARM64 上自动启动 Playwright Chromium(#164202、#164249、#163510、#163281)
- 云 worker 与 Crabbox:暴露真实云 worker 失败原因、强制 Linux 租约、让 worker 包下载与引导重叠、移除无关的预热镜像清理等待、防止慢读取或不支持的后端搁置 worker(#164129、#164187、#164128、#164231)
- 插件、Codex 与 MCP:保留 Bun 包导入捕获、减少预发布元数据请求、防止过期远程执行审批污染认证配置、恢复节点策略钩子、同步 MCP 表单/文件/上下文、将后台技能评审改由 Workshop 提案路由(#164223、#164185、#164237、#164270、#164277、#164292)
- 更安全的恢复与更跟手的聊天:恢复被中断的数据库 worker 与 Doctor 迁移、防止后台 CLI 回复挂起、在新内容到达时保留自动跟随聊天(#163258、#165854、#167091)
优化 / 变更
- 新增 Claude Haiku 5.5 支持(#166706)
- Code Mode 的
store/load值可在单元、回复与 Gateway 重启之间保留(#164086) - 新增 Workboard 侧边栏导航与个人看板置顶(#164604)
- MCP Apps 可在其视图保持打开时调用自身工具,附内联消息确认并同步表单、文件与上下文(#164496、#164493、#164277)
- Control UI 聊天加入 YouTube 内联播放(#164576)
- 新增原生 macOS 侧边栏身份详情与插件会话目录,Linux 伴侣改用捆绑 Bun(#164591、#164436、#164401)
- 采用密封不可变的安装世代(installation generations),支持激活与恢复(#163799、#164306)
- 由选定的记忆插件负责压缩前的记忆刷写(#162177)
- 让每个已加载插件(含本地路径与链接安装)使用其独立的隔离状态与入口队列,同时不改变特权能力的信任要求(#165063)
- 云 worker 支持企业仓库(#160108)
- 新增 RPC 响应大小与主线程堆诊断,并以独占处理器采样避免误导性测量(#164335、#164418)
- 将现有 agent 迁移到本地 Claws(#162329)
- 通过提供预备事实、按存储修订复用卡片负载、将生命周期变更移出主线程、保留规范状态句柄,降低会话看板与状态路径开销(#164218、#164301、#163815、#164110)
修复
- Agent 与子代理:记忆保存回合不再重新获得无关的执行工具、即使孙级投递仍挂起也投递已完成的子代理结果、后续消息不再截断返回的子代理结果、完成的回答可经受仅推理尾巴、小上下文窗口的会话在自动压缩后可恢复(#166650)
- 更新与 Doctor:当实际包已服务候选时预备激活得以结算、Gateway 已停止时回滚跳过维护排空、失效的旧子血脉租约不再阻塞后续每次更新、分诊在激活恢复挂起时停止反复开已拒绝的更新、更新修复不触碰现役移交所有者、Doctor 维护不再耗尽 systemd 服务检查时限(#167648、#167649、#168031)
- 装有插件的 Gateway 启动:有效启动不再在每次配置读取时捕获并丢弃插件 Doctor 模块、Windows 插件捕获恢复使用快速固定描述符拷贝(大插件 Gateway 不再启动停滞数分钟)、目录更新在启动后不再重新捕获插件、大插件下模型切换不再冻结 Gateway、Windows 启动器在 pnpm 更新后仍可用(#168017、#167544、#161267、#167905)
- Codex、ChatGPT 与本地模型:提供方流丢弃最终增量时 Codex 回复不再丢失末 token、被拒绝的缓存 ChatGPT 工具续写可恢复且不重跑已完成工具、超大代理请求报告上下文错误而非单 token 回复、恢复的 Claude 会话刷新其系统上下文、启用 Tool Search 时 Ollama 工具调用可用、恢复 Gemma 4 工具调用尾部文本、托管 llama.cpp 的索引在小主机上不再内存耗尽(#168055、#167878、#167799、#167933、#167886、#168020)
- 频道、状态与记忆:Telegram 收到
/verbose、/think等设置命令时保留待答问题、基于 Bun 的 Gateway 不再误报状态所有权丢失、独立 Docker CLI 容器与重建的 Docker 所有者保持 Gateway 状态所有权、记忆 wiki 状态不再重复编译未变的外部刷新 vault(#168004、#167669、#164236) - 安装与终端:全局 npm 安装将原生包限制在当前平台、本地浏览器终端在无头主机上声明 RGB 颜色(#165997)
- 安全与隐私:启动前拒绝 NUL 执行参数、对无法解析的对端凭据失败关闭、防止过期 Codex 会话与外部现役所有者变更后继工作区、将私有运行时上下文排除在回复与已保存对话之外(#164770、#165021、#164197、#164203、#163471、#164561)
- 回复投递:保留已完成的回答而非以阻塞摘要或通用追问警告替换、展示权威工具结果与原生工具失败、防止静默回复标记泄漏到预览(#164896、#164774、#163545、#164116、#164259、#160582)
- Telegram 与 Discord:投递后续消息不再因延迟入口停滞、Telegram 相册在负载下保持成组有序、恢复按频道路由的移交发送、长 Discord 模型 ID 仍可选(#159265、#164549、#163926、#163863、#165137、#164311)
- 其他频道与钩子:解析带工作区限定的 Slack 用户、通过 Doctor 迁移未限定作用域的 WhatsApp 凭据、停止 Gmail 重投递时的重复错误告警、将零频道媒体上限视为无限制而非阻断所有附件
本版本为 2026.10.x 线的首个正式版(承接 2026.9.9 正式版线并为 2026.10 系列定版),完整贡献记录:审计范围 9da28ad4bd0ee3a9ba9757b9d6f444a6306ac3a0..2bb51e77b0de34dda2a9c35bec830e4ed5bd67d1,共 396 个入选 PR(0 个仅保留种子 PR);已发布基线排除 v2026.9.8(5 个 PR)。变更正文取自 npm tarball openclaw-2026.10.1.tgz 内的 package/CHANGELOG.md,发布说明见 https://docs.openclaw.ai/releases/2026.10.1
v2026.10.5-beta.1
2026-10-12(预发布版 / beta;beta 标签由 2026.10.1-beta.2 指向本版,latest 仍为 v2026.10.1,extended-stable 仍为 v2026.8.35)
新功能 / 亮点
- 更安全的更新:更新可在多设备、多文件系统、Windows 提权与中断的激活之间完成,并能从陈旧租约或被改动的证据中恢复,而不是让安装搁浅或阻塞后续更新(#164636、#164769、#165257、#165863、#166548、#166695、#168043、#166394、#167302)
- 重启安全的对话:被中断的回合、worktree 准备期间的首条消息以及被推迟的任务都能在 Gateway 重启后恢复;用户输入与已提交的会话数据可穿越重启、并发写入与失败的发布而存活(#165333、#166042、#165184、#166238、#165502、#167570、#163258、#166010、#167662)
- 更快更稳的 Gateway:会话、转录、历史与元数据读取迁移到 worker 线程,每回合 SQLite 工作量大幅减少;启动维护在就绪后运行,繁忙的 Gateway 也能保持响应(#164744、#165470、#165614、#166587、#167194、#164779、#165028、#166041、#167278、#165993)
- 可靠回合与子代理:回合可从停滞的流、被复用的工具调用 ID 与过期的 ChatGPT websocket 中恢复;不完整的回合以可见提示收尾;子代理结果可透过后续消息、重启与过期投递窗口持续返回(#165983、#167013、#165212、#167063、#167972、#164282、#168068、#166846、#166139、#165987)
- X 频道:通过新的频道插件应答 X(Twitter)提及,支持流式、针对仓库提问的访客模式,并强制 API 成本上限(#165138、#165337、#165354、#165351)
- 语音通话:语音通话新增每次通话简报、通话报告、实时引导、回拨与语音信箱检测(#165716)
- 更智能的模型选择器:选择器优先展示各提供商的推荐模型,无需等待 OpenClaw 发版即可显示新列出的 Claude、ChatGPT 与 Ollama 模型,并在目录加载时保持响应(#167370、#166737、#167658、#167387、#167463、#165989)
- Gateway 内 ClawHub:可在 Gateway 中浏览与搜索 ClawHub 插件与技能,插件会自动选取当前 OpenClaw 支持的最新官方版本(#163459、#167485、#166588)
变更
- 会话:允许向会话定向发送而不授予转录访问权限(#164444)
- Worker 本地推理:新增原生 worker 推理运行时,含 Gateway 派发、客户端放置、本地推理前的必需 worker 策略与目的地校验,以及清晰的设置失败说明(#158902、#163645、#163646、#163647、#166611、#166613、#165960)
- 公开线程:通过常规链接打开公开线程(#166049)
- 子代理进度:在工作行上统计运行中的子代理、在操作组中命名已启动的子代理,并在交接的区块中继续已恢复的回答(#165477、#165725、#165542)
- X 频道:新增 X(Twitter)提及频道插件,含 Activity API 流式与回填、隐藏同代理助手的仓库提问访客模式、经 GitHub 验证的仓库写入者,以及每日与每月 X API 成本上限(#165138、#165337、#165376、#165354、#165543、#168071、#165351)
- 自动化修复:允许失败的自动化先由其归属对话修复再告警,错误变化时给予第二次修复回合,修复回合超时时给出明确警告(#161007、#162702、#162772)
- 频道进度:默认展示有用的 Telegram 与 Discord 进度,为 Discord 进度草稿加入逐工具字形,恢复 Telegram 工具行的逐工具 emoji,隐藏常规 Slack 反应行(#166861、#168032、#167392、#166880)
- 技能:让学到的技能专注于可重复的流程而非事实或代码库知识,并让较长的旧版 Workshop 技能保持可管理(#167404、#167639)
- 记忆:解释触发召回为何被跳过、嵌入响应为何被拒绝,并报告受管 Ollama 与 LM Studio 嵌入的就绪状态(#164409、#168035、#156483)
- 模型与目录:选择器优先展示各提供商推荐模型、在目录 v2 中发布策展式逐提供商推荐、以 NVIDIA 精选模型领衔其推荐,并在无需重启 Gateway 的情况下应用已下载目录(#167370、#166737、#167989、#158000)
- Anthropic 与 Claude CLI:支持 Claude Haiku 5.5,无需等待 OpenClaw 发版即可显示新列出的 Claude 模型,每个 Claude CLI 模型只列一次,并保留已登出的 Claude CLI 模型并附登录原因(#166706、#167658、#166311、#166338、#167942)
- OpenAI:支持自定义实时语音端点、显示清单中缺失的账户聊天模型、无需发版即显示新的 ChatGPT 登录模型,并停止提供仅限 ChatGPT 或被内置 Codex 拒绝的模型(#165632、#162563、#167387、#167633、#167975)
- 工具行与子代理进度:在原生工具行中显示 Tool Search 调用并在各客户端共享工具图标、原地显示子代理等待而不留交接标记,并在 HTTP 400 提示尺寸拒绝后引导用户(#165095、#165378、#159712)
- Control UI 子代理:显示聊天何时在等待子代理,从聊天的子代理计数与名称打开 Subagents 面板,并在父聊天中呈现子失败与关注点(#164190、#166142、#166224、#166312、#166347)
- Control UI 定制:允许主题定制 Control UI 品牌、为浏览器标签使用代理头像或解锁的 Lobsterdex 图标、选择 favicon 形状,并新增七种 Lobsterdex 角色变体(#168027、#165201、#166325、#167809、#159815)
- 终端:新增可配置终端字体与内置 Nerd Font 图标(#166180)
- Control UI 导航:可从聊天工具提示复制文件路径、直接在切换器中固定代理、让代理菜单更易浏览、允许用户隐藏会话的分支 PR 行并简化可选问题卡(#164431、#165640、#165641、#166366、#168040、#150587)
- Skill Workshop:在一个视图中展示每个技能及其变更、文件与历史(#167440)
- iOS:通过原生 Cloudflare Access 连接 Gateway,含应用自有的浏览器与配置文件准入(#147244、#147238)
- ClawHub:可通过 Gateway 浏览与搜索 ClawHub 插件与技能(#163459)
- 插件:允许插件工具无需第二次模型回合即可投递完成的回复、允许每个已加载插件拥有自己的状态与入口队列及队列模式,并选择插件自有的自托管执行器(#164558、#165063、#165965、#161609)
- 插件:选取运行中的 OpenClaw 支持的最新官方插件版本,在其匹配版本不可用时保留可用的插件(#167485、#166588)
- Workboard:可从侧边栏固定、取消固定与删除看板,保持卡片备注可选且备注编辑器更宽敞,并在重命名时保留列编辑(#165020、#166625、#167348)
- GitHub:支持异步 PR 合并并压缩 Publish PR 卡片(#163579、#165219)
- 性能(会话/回合/状态数据库):每回合会话投影、条目读取、权限校验、压缩读取与首回合头迁移到 worker 线程;减少每回合 SQLite 语句、worker 请求与冗余读取;加快冷代理数据库准入与崩溃恢复,干净重启时复用完整性检查,切换代理时不再重开执行器,关机时及时释放租约(大批 PR,含 #164779、#165028、#166041、#167278、#164490、#166053、#167686、#164846、#165070、#167001、#168008 等)
- 性能(维护/历史/代理/目录/子代理与 ACP):减轻空闲与手动维护、生命周期清理、归档、重置与轨迹保留工作;降低代理保留堆、每回合提示分配与主线程 SQLite 工作;加快多提供商目录刷新并避免冷账户读取时的发现;减少子代理与 ACP 启动注册表恢复延迟并把批量注册表工作移出 Gateway 线程(大批 PR,含 #164851、#167454、#167101、#165942 等)
修复
- 会话数据安全:在重启恢复与失败的发布中保留用户输入与已提交事实,在释放写入者前让已接受的锁定追加落定,并隔离跨存储的 worker 提交(#165502、#167570、#165894、#168018、#168029)
- 会话权限与隐私:在恢复冷历史用于压缩前校验调用方权限,在已提交的会话变更后保持权限最新,拒绝畸形的 hook 会话键,并从未提交 diff 中隐藏分支新增文件的会话前编辑(#166506、#167875、#166406、#164671)
- 会话清理:在清理与 Incognito 重置时移除残留的 GitHub 发布回执与受管 worktree,并发布对话、插件状态、沙箱、worktree 与 GitHub 权限回执(#163833、#165185、#167731、#168025)
- 回合可靠性:当数据库 worker 在操作中途退出时恢复代理回合,停止无关会话写入导致 Codex 与聊天回合失败,让 Knowledge 调用在会话发布簿记时继续工作,并停止群组回合在历史无法加载时静默失败(#163258、#165196、#166010、#166758、#135253、#166059)
- 重启恢复:重启后结算遗留运行中的会话,避免普通中断后的重复恢复,将恢复对账保留在宿主上,并为重启后与首会话回合保留数据库准入、托管与 hook 重试(#165174、#154175、#166395、#166867、#166609、#167629、#165859、#165738、#166891)
- 代理与会话创建:修复新代理的并发首次请求、冷共享存储与全新存储创建失败,以及孤儿会话窗口修复后的代理数据库恢复(#166003、#167257、#167515、#167366、#166860)
- Windows 与路径别名:规范化共享状态数据库路径并比较链接稳定身份,使 Windows 与 POSIX 路径别名共享同一存储、托管与频道生命周期(#166755、#165775、#166062、#166462、#166787)
- SQLite 死锁与停滞:防止写入者-读取者准入与清理死锁,在写入者停滞时保持已提交读取响应,停止写入者持有的转录读取等待读取者,并在刷新期间保持外部变更可见(#167662、#167446、#167901、#167687、#166331、#165898、#167332)
- 状态与更新:停止残留的更新检查缓存与已完成的恢复历史阻塞更新,并对由更新版本写入的状态给出一个可操作的答案,同时保持状态读取为只读(#165461、#167358、#166963)
- 启动与完整性检查:在启动索引修复期间返回待处理准入,在启动与空闲退役期间保留完整性证明,长时间延迟时停止过早的租约计时器,避免在 Bun 上误报状态所有权丢失,并停止健康启动记录 SQLite 锁等待警告(#165323、#166972、#166412、#167467、#167669、#167754、#166253、#168310)
- 会话搜索与历史:为配置的 ACP 拥有者搜索转录,停止虚假的索引提示,让搜索与准确的索引并行,在中断的进度回复后保留点前缀检查点引用与 CLI 历史,并保持规范转录拥有者互不相同(#164897、#165879、#167174、#167163、#164920、#166658、#164512)
- 会话显示:停止 Markdown 链接标记泄漏到预览,为插件发现的模型显示正确的上下文窗口,记录失败的唤醒及其目标,在生命周期命令与轨迹导出中保留拥有代理,并解码 UTF-16 BOM 文本文件(#166653、#159731、#166458、#166415、#165777)
- 启动排序:停止转录重建积压较小的代理在启动时排在大代理之后等待(#165207)
- 安全边界:对未解析的 A2A 对端令牌引用以及进程普查无法证明临时根未被使用时失败关闭,并在启动前拒绝不兼容的 worker 提示上下文(#165021、#165079、#166268)
- 数据完整性:在验证前拒绝畸形的 UTF-8 备份清单,保留畸形的 UTF-8 与带尾随空格的连接目标,并在命名的旧式文本附件中保留重音字符(#167389、#167399、#167116、#165405)
- 重启恢复:恢复被 Gateway 重启中断的 Control UI 回合,在 Gateway 于 worktree 准备期间重启时保留新会话的首条消息,在推迟的启动恢复后恢复任务,在崩溃循环断路器触发时暂停重启恢复,并在 worker 中结算重启意图与更新报告(#165333、#166042、#165184、#166238、#167572、#165069、#165670)
- 回合生命周期:为每个已停止或运行时丢失的运行发布一个终止事件,在会话变更前结算终止运行,保持排队消息的 run id 与回复对齐,并防止排队回合后的内部恢复错误(#165483、#167383、#166784、#166981、#165996、#164656)
- 停止与引导:随其 Gateway 请求停止已让出的命令,退役已停止的续写,允许已停止命令后的唤醒,在引导回执不确定时保留运行中的工具,按序显示已接受的引导消息,并在 worktree 创建期间保持引导直到任务完成(#166753、#166775、#166968、#166754、#168099、#165462、#165537)
- 队列公平性:在持续流量下防止后台饥饿,避免诊断抛错时的停滞回合,将许可等待者保留到其真实截止时间,并在任务截止时间取消排队的主机回调(#167683、#167733、#165359、#167740)
- 聊天投递:在压缩后投递活动摘要更新,在仅 CR 的回复中隐藏受管媒体指令,将节点完成后续消息保留在其发起的对话中,保留实时的节点审批交接,并停止群聊中虚假的 Yield failed 警告(#165024、#164657、#160675、#166971、#161154、#166396)
- 会话创建:在其他本地回合开始或结束时保持新会话可用,在 agents.create 后立即识别代理,保持仅父级会话绑定其代理,并在工作区绑定时绑定必需的 worker 会话(#165984、#167894、#165929、#167162)
- 聊天历史:停止对处于被跳过代理存储中的会话进行无限重试,为重置前绑定 Claude CLI 的消息返回锚定历史,保留工具历史细节与频道启动上下文,并保持生成与截断的会话标题 UTF-16 安全且平衡(#165408、#166578、#164848、#141240、#167584)
- Claude CLI 与辅助调用:在起始回合结束后保持 claude-cli 会话工具与后续 CLI 桥接调用可用,正确路由简写 Anthropic CLI 认证引用,保持会话观察者在 CLI 支持的实用模型上工作,并在运行时变更中保持 OpenClaw 辅助调用可用(#165432、#165428、#84374、#162067、#166235)
- 模型与目录:在启动与推迟的代理启动后保持 Codex 可选,在目录恢复失败后重新检查模型,停止目录续写在模型加载时挂起,并保持 OpenRouter 与 LM Studio 思考级别完好(#165979、#166081、#162901、#166089、#166705、#164478、#164597)
- 用量与指标:为静默回复报告用量,在兼容流省略用量时估算上下文,将后台实用完成计入 token 与成本指标,并在宿主跳过某日期时保持用量范围有序(#152396、#166151、#167986、#165523、#164140)
- 启动与就绪:即使清理失败也显示启动失败,停止小代理等待大代理,防止启动后公开聊天 503 与停滞,并避免临时状态期间的失败(#165323 等)
本版本为 2026.10.x 线的第二个 beta(承接 2026.10.1-beta.2 与 2026.10.1 正式版)。变更正文取自 npm tarball openclaw-2026.10.5-beta.1.tgz 内的 package/CHANGELOG.md;预发布版暂无 docs 发布页。
OpenClaw v2026.10.4 发布(2026-10-16)
版本:v2026.10.4(正式版 / latest)
发布时间:2026-10-16 07:58(北京时间,2026-10-15T23:58:28.695Z)
定位:2026.10.3 的稳定性补丁,无新功能、无配置变更。
本版亮点:
- Gateway 抗休眠与时钟跳变:电脑休眠或系统时钟跳变后 Gateway 保持运行,不再因自身所有权心跳看似过期而自我重启;休眠与墙钟变化后能恢复状态所有权,并允许从已验证的外部 macOS 终端执行
openclaw gateway restart(#170790、#170354) - 关停与重启不再卡死:Gateway 关停/重启不再因停滞的转录 worker 或在途的会话生命周期事件而挂起(#170493、#170555)
- Tlon 群组私信越权修复:不再把群组私信的其他参与者当作 owner,封堵了一条 owner 冒充路径(#165801)
- 无头浏览器 passkey 等待:站点等待 passkey 期间无头页面仍能响应点击(#170857)
- 手动 /compact 更安全:手动
/compact现在会先让活动回合落定再压缩,而不是中止它并丢掉待处理请求(#166163)
其余修复:长回复带 reply 标签的流式处理不再每 token 重解析 Markdown;被阻塞的 durable context-engine 回合只记一次日志;Control UI 延迟心跳不再强制重连;更新流程多项加固(快照捕获不误标 agent 数据库、成功摘要不再重复列出已落定的插件数据/设置升级、慢主机准入不再占用数据库写者、快照失败给出准确标题与恢复建议、Linux 更新可在受保护的 systemd 用户管理器下清理废弃运行时目录、候选校验不再放大私有 SQLite 快照);Doctor 离线修状态支持应用自有的 Gateway;Tailscale 中断启动会停掉 serve 进程;macOS 应用恢复保留兼容的较新 Gateway 而不降级;POSIX 路径别名(如 /tmp 与 /private/tmp)不再导致频道重启;MCP OAuth 登录在授权服务器注册无端口 loopback 重定向 URI 时可完成;Telegram 轮询 worker 在源码与打包构建中都能解析。
破坏性变更:无。
变更正文取自 npm tarball openclaw-2026.10.4.tgz 内的 package/CHANGELOG.md;docs 链接 https://docs.openclaw.ai/releases/2026.10.4
OpenClaw v2026.9.33 发布(2026-10-15)
版本:v2026.9.33(Extended Stable 9.x 线补丁)
发布时间:2026-10-15 18:05(北京时间,2026-10-15T10:05:43.246Z)
定位:承接 2026.9.9 的 extended-stable 9.x 线补丁(extended-stable 标签由 2026.8.35 → 2026.9.33),含 2026.9 线安全升级、模型支持与十月兼容修复批量回移。
本版亮点:
- 更安全的九月线升级:2026.9 线的更新保留状态、插件数据、服务归属与 Windows 状态路径,并拒绝在非归属的 Doctor 写入之上自动恢复(#160167、#166755)
- pnpm / npm / Windows 更新能跑完:pnpm 12 的 Gateway 服务与启动器在原位更新后存活,保留的更新器运行时不再阻塞 npm 恢复,Windows 更新在 Doctor 重新检查驱动血脉后不再回滚(#170003、#170131、#170170、#169563)
- 新模型支持:支持运行 Meta Muse Wonder(最高思考档,Spark 仍为默认)、MiniMax M3.1(Flash Preview,思考力度级别路由到提供商),MiniMax portal OAuth 在 token 过期后保持登录(#170232、#160089、#160459)
- 更可靠的模型回合:agent 运行尊重实时思考级别,本地提供商获得响应头超时,ChatGPT WebSocket 正常关闭可恢复,Codex 回复保留末尾 token(#168566、#168282、#167512、#168400)
- 工作穿越 Gateway 重启:被中断的自动化回合、被引导的会话、云 worker 认领与部分 worker 回复在重启后可恢复或持久化(#170162、#170252、#170161、#170223)
- 投递与设备稳定性:实时发送在队列恢复后存活,节点请求不再因无关的配对活动或另一设备的配对写入而失败(#169010、#169486、#169575)
- agent 与更新稳定性:回移一批十月兼容修复(agent 回合、会话、频道与更新恢复),#170476
其余修复:Update/Doctor 在不可读的 supervisor 与子进程绑定错误下继续运行、干净的安装拒绝不进入原生权限恢复、更新历史写入不再拖住 cron 与清理、不因遗留 auth store 不可读就删除 OAuth 配置;从 2026.8.35 升级时用 “allow always” 批准的 cron 任务在更新后继续无人值守运行、pnpm 12 服务被改写到耐久安装链接、Doctor 推迟可选检查以在旧更新器的时限内完成、被移除 SDK 导入的官方插件不再被静默保留;Gateway 响应性(长流式回复不再反复重解析)、Tailscale Serve 中断处理、上下文引擎阻塞回合告警去重、状态数据库读关闭问题、DeepSeek/Codex/llama.cpp 提供商恢复、频道与工具(配置写入重启账号后频道工具仍可用、ACP agent 保留工具、Talk 咨询不再刚连接就中止)、自动化(失败的一次性自动化必定告警、cron 等待主机准入时不再占用状态写者)、发布检查(Windows 安装器检查容忍慢速 gateway stop help、打包检查从占用端口恢复、extended-stable 候选现在可校验来自上一个 extended-stable 版本的升级)。
破坏性变更:无。
完整贡献记录:审计范围 v2026.9.9..a902bd2 共 65 个在范围内 PR(0 种子)。变更正文取自 npm tarball openclaw-2026.9.33.tgz 内的 package/CHANGELOG.md;docs 链接 https://docs.openclaw.ai/releases/2026.9.33
OpenClaw v2026.10.10-beta.1 发布(2026-10-16)
版本:v2026.10.10-beta.1(预发布版 / beta)
发布时间:2026-10-16 01:26(北京时间,2026-10-15T17:26:44.944Z)
定位:2026.10.x 线的第三个 beta(承接 2026.10.5-beta.1),预发布版暂无 docs 发布页。
本版亮点:
- 更快更稳的 Gateway:聊天回合、会话列表、启动与空闲 Gateway 的 SQLite 与主线程工作大幅减少,更多数据库工作移到 worker 线程,繁忙主机与大型 agent 集群保持响应(#167965、#168002、#168093、#169005 等)
- 更新能跑完:从 2026.10.1 及更早 beta 升级可完成,繁忙 Gateway 与慢 Doctor 步骤不再拒绝或回滚一个良好更新,失败的更新不再留下半安装版本,macOS、Windows 与 Bun 安装可从其平台特有的失败中恢复(#168849、#172249、#172196 等)
- 重启安全的回复:被中断与未完成的回复在 Gateway 重启后恢复,被观察的子结果、排队回合、已接受的 agent 更新与操作员任务跨越重启存活而不消失(#172234、#172412、#169489 等)
- 云会话:从会话菜单在本地与云之间移动会话,按仓库组织云环境并带环境配方与经验证的 Node 工具链,在首个快照上传完成前启动会话并显示快照进度(#171690、#170892、#170862 等)
- 桌面应用内置本地 Gateway:Windows 桌面应用与全新 Tauri 安装可运行本地 Gateway,全新 macOS 安装以引导式仪表盘设置启动,首次运行设置自动选择推理(#169522、#169512、#169568、#169628)
- 新模型:Gemini 4 Argon 成为默认 Gemini 模型(与 Gemini 3.8 Flash 并列),新增 Nemotron 3.5 Super VL 与 xAI Imagine Image 2.0,Meta 模型经 Muse Code 运行,选择器不再提供已退役模型(#171852、#172339、#172449 等)
- 要求更新的 Apple 平台:OpenClaw 现在要求 macOS 26.2、iOS 26.2 与 Safari 26.2 或更新版本(#168595)
其余变更:云会话与首次运行设置扩展;本地设置(可选记忆嵌入、受管 llama.cpp OCR/视觉、非交互 llama.cpp 仅嵌入设置);Bun 运行时(构建独立可执行文件、可选固定 Bun 运行时、Gateway 启动更快);实验性 PostgreSQL 引擎(Workboard store、从标准 SQLite schema 生成 PostgreSQL DDL、带能力准入与精确 schema 漂移检查的迁移、备份与更新中保留、离线数据库移植工具);会话(嵌套会话显式组织与归档、选择会话收发消息时机、选择加入 sessions_send 线程目标、在配对设备的现有文件夹运行会话、按自定义时间打盹);会话个性化(背景、每个会话的语音气泡与提示反应、公开链接预览);Control UI 导航与聊天(紧凑侧边栏轨、在线状态过滤、Details 中的会话上下文与任务进度、推文预览卡、表情按名搜索、会话 diff 手动代码折叠、安全输入提示显示/隐藏值);语言新增瑞典语;Agents API 托管工作区与隔离;MCP 应用与自动化(跨会话使用 MCP 插件应用、由 MCP 事件触发自动化、principal 绑定中继);插件与 SDK(每次运行模型回退覆盖、为后台侧问题 fork 会话实时上下文、插件引导活动运行、Solid Control UI 视图、worker 拥有的键控状态与会话绑定 API)。
破坏性变更:要求 macOS 26.2、iOS 26.2、Safari 26.2 或更新(原生应用与 Control UI,#168595)。
变更正文取自 npm tarball openclaw-2026.10.10-beta.1.tgz 内的 package/CHANGELOG.md;预发布版暂无 docs 发布页。
















iphone duo wireless charging 3天前0
iphone duo wireless charging