v2026.9.4¶
AI 智能体和工具可以将这些发布说明作为纯 Markdown阅读。
OpenClaw 2026.9.4 让插件和技能更易于查找,并允许你通过一个可引导的聊天,将过去的对话转化为可复用的技能。
它还新增了 GPT Image 2.5 支持、对云会话的更多控制,以及终端中的交互式提问,同时修复了更新、记忆和消息传递方面的问题。
发布规模:1,558 个拉取请求、20 次直接提交和 294 名贡献者。
安装与入门¶
OpenClaw 可以帮助你绕过 Node 版本问题,而无需替换你计算机上现有的 Node 安装。新智能体设置现在也可以配合安全保存的 API 密钥使用,并且连接手机或卸载 OpenClaw 的说明现在补齐了原先缺失的步骤。
在 Node 需要关注时启动 OpenClaw
如果 OpenClaw 因为其运行所依赖的 Node 而无法启动,它现在可以在你的计算机上找到已有的兼容副本,或者提供安装一个仅用于 OpenClaw 的副本。首次安装需要你批准;之后 OpenClaw 可以自动复用它。这样你就可以绕过启动问题,而无需为其他应用更改 Node。某些系统(包括 Alpine Linux)仍需要手动安装。如果你无法正常启动,在一些较旧的 Node 版本上仍可使用基本的帮助和故障排除命令。
如果升级后后台服务仍在使用旧版 Node,openclaw gateway install 现在可以将其切换为可用的受支持版本。这与让命令行正常工作属于两项不同的修复。
一种无需为其他应用更改 Node 即可绕过启动问题的方法。概念性插图,而非截图。某些系统(包括 Alpine Linux)仍需要手动安装。
来源和完整变更列表
改进
- 在启动正常时避免加载错误诊断信息 #142371。
- 当 CLI 无法启动时,提供独立的 Node.js 更新 #142742。感谢 @jason-allen-oneal、@morrow-bluedot、@jialele。
Bug 修复
- 解释不可用的 macOS SQLite 覆盖配置 #141948。
- 在 Bun 安装和诊断期间检查所选 SQLite 库 #142186。
- 修复过期的 Gateway 服务 Node 运行时,而无需强制重新安装 #143159。感谢 @jialele、@TheAngryPit。
- 在不受支持的 Node 运行时上恢复诊断 #143344。
- 在启动和升级期间复用已安装的兼容 Node #143464。感谢 @aeoess。
- 在 Node 恢复期间,允许使用简短帮助和版本标志 #143485。
- 在托管服务中保留 macOS Bun SQLite 设置 #143651。
文档
限制与兼容性
在 Mac、Linux 和 Docker 上安装
Mac 安装不再会在受影响的 Homebrew Bash 环境中卡住,自行构建 Docker 镜像 的用户也可以绕过导致安装中断的缺失文件错误。Linux 说明现在会解释应该以哪个用户账户运行 OpenClaw,以便它找到正确的设置;安装帮助也会明确说明何时会启动或重启后台服务。对于自行管理终端设置的用户,受支持的命令补全条目也会被保留,而不会重复添加。
来源和完整变更列表
Bug 修复
- 防止较新版 Homebrew Bash 导致安装程序挂起 #141884。
- 恢复 Docker 源代码依赖安装 #142073。感谢 @vincentkoc。
- 在安装期间保留可移植的 shell 补全钩子 #143282。感谢 @LiuwqGit、@obviyus、@jlapenna。
文档
连接提供商并进入首次对话
新的代理现在可以使用你已保存在 OpenClaw 受保护存储中的 API 密钥,修复了导致普通聊天可以工作但新代理设置卡住的设置失败。Moonshot 中国 API 密钥设置也不再要求你重新安装已安装的提供商,并且浏览器登录会在你把手机设置代码粘贴到错误位置时给出说明。
空的后台记忆检查不再让新的 Claw 认为设置已经完成,因此你仍然会获得它的首次命名对话。
来源和完整更改列表
改进
Bug 修复
- 在新代理设置中使用受保护的提供商密钥 #141586。感谢 @miguelbranco80、@IWhatsskill、@wenbiyou、@lisheguo。
- 在空的 dreaming 扫描后保留首次运行设置 #141808。感谢 @SunnyShu0925、@obviyus、@dh-js、@ayaangazali。
- 停止 Moonshot 中国身份验证重装循环 #143742。感谢 @zwyhmcn。
文档
- 围绕一个 Gateway 密钥统一设置和轮换指南 #141723。
- 更正 Gateway 主机提供商设置说明 #143983。感谢 @vincentkoc。
为设置选择代理
如果你有多个代理,引导式消息设置现在允许你先选择要配置哪个工作区,然后单独选择谁应接收消息。你还可以在管理设置建议时选择代理,以便在预期的工作区中工作。当未配置默认值时,设置脚本仍需要显式选择 --agent。设备设置说明还解释了连接设备与批准其可运行的命令是分开的步骤。
来源和完整更改列表
Bug 修复
- 在引导式通道设置期间选择代理工作区 #128738。感谢 @Leon-SK668、@obviyus、@JunfXiao。
- 为入门建议选择代理 #141775。感谢 @ChrisCantwell、@obviyus。
- 解析通道设置检查的环境值 #141781。
- 在建议子命令后接受代理选择 #142019。感谢 @obviyus。
文档
将手机连接到 OpenClaw
手机设置帮助现在指向 openclaw qr,并且 Android 说明 解释了如何连接到运行 OpenClaw 的计算机并设置手机所需的登录。它们涵盖受信任的家庭网络和 Tailscale。尽可能使用 HTTPS 进行浏览器访问,因为 HTTP 不会加密你的登录信息或消息。
来源和完整更改列表
文档
- 更正 Android 配对和浏览器访问指南 4ccdd7e。感谢 @yetval。
- 在 CLI 帮助中将移动设置用户指向 QR 命令 #141756。感谢 @chelsealong、@obviyus、@tomdailey55。
完成导入现有设置
导入最后阶段的错误不再需要隐藏已完成的工作。当最终清理失败时,OpenClaw 会保留已完成的记忆导入结果,并能识别同一请求的重试,而无需再次复制所有内容。如果错误提示导入已完成,请在重新开始之前查看报告和导入的文件。该重试保护是临时的,重启 OpenClaw 后不会保留。
来源和完整更改列表
Bug 修复
- 在清理错误和匹配请求重试中保留已完成的导入结果 #142738。
移除安装
移除 OpenClaw 现在会提供与你安装方式匹配的说明,包括 Git 以及保留在独立文件夹中的安装。卸载指南 说明应删除哪些文件和启动器,以及哪些可能与其他工具共享。先移除后台服务,并在删除文件前保存你想保留的任何设置或工作区。
来源和完整更改列表
文档
- 说明 Git 和专用前缀安装的移除方式 [#127254](https://github.com/openclaw/openclaw/pull/127254)。
- 更正卸载帮助和补全指引 [#142629](https://github.com/openclaw/openclaw/pull/142629)。
</details>
遵循完整设置说明
首次运行帮助 将入门步骤与选择提供商或托管服务分开,以便找到当前步骤对应的答案。设置示例还会补充缺失的工具、凭据和命令,包括如何将 Mac 应用与正确的命令行版本匹配。当你要求设置代理检查某个设置时,它现在可以找到包含点或括号、之前被报告为缺失的名称,同时保持机密值隐藏。
来源和完整变更列表
错误修复
- 在设置代理中读取带引号的配置键 #143601。
文档
- 更正设置路由、Gateway 端口间距、日志样式,以及现有的 Windows、频道、Codex 和提供商指引 #141214。感谢 @vincentkoc。
- 将 Why OpenClaw 架构和对比参考拆分为聚焦页面 #142989。感谢 @vincentkoc。
- 直接链接工作区模板、macOS Skills 和相关设置指南 #143022。感谢 @vincentkoc。
- 更正复制的设置命令、token 显示说明、记忆示例,以及重试和心跳指引 #143029。感谢 @vincentkoc。
- 将首次运行 FAQ 拆分为聚焦的设置和托管页面 #143148。感谢 @vincentkoc。
- 更正 Diffs 安装、Ollama 凭据、IMAP 账户示例,以及 CLI 和工具指引 #143179。感谢 @vincentkoc。
- 明确显式 ClawHub 技能选择 #143371。
- 明确 voice-call 和 acpx 前置条件、文本模型验证、记忆设置以及委托示例 #143927。感谢 @vincentkoc。
- 更正转录模型、摄像头标志、Matrix 默认值、Signal 检查,以及现有的媒体迁移指引 #143950。感谢 @vincentkoc。
- 完善远程 Mac、Arcee 和插件 SDK 示例,并明确文档中的版本历史 #144032。感谢 @vincentkoc。
- 明确记忆 CLI 默认值、stop/backup/start 迁移步骤、Reef 设置,以及状态和群组链接 #144083。感谢 @vincentkoc。
- 添加安装前置条件,并明确 Render 故障排除、Ollama 凭据、Mac 版本匹配,以及现有客户端控制 #144085。感谢 @vincentkoc。
新的 Web UI¶
在 Web 应用中,你可以在跳回较早消息之前先预览它,将引用带入下一条回复,并查看 Codex 的辅助代理在处理你的请求时做了什么。还修复了那些让对话更难跟进的中断问题,从消失的图片预览到已完成但仍显示为忙碌的任务。
查找和组织对话
你的对话列表 现在会保留你选择的名称,并避免在收到较旧的更新时将其改回。即使自动命名失败,聊天也能获得有用的标题,便于之后识别。如果应用尝试重新打开你已删除的聊天,它会带你进入一个可用的对话,而不是让你卡住;它不会恢复已删除的消息。
花园开放的可识别对话。已发布的 2026.9.4 界面,使用虚构的 Harbor 数据;无实时任务执行。
来源和完整变更列表
改进
- 从“其他”标题启动未分组会话 #142544。感谢 @Patrick-Erichsen。
错误修复
- 打开 Web UI 时恢复过期的已记住聊天 #133653。感谢 @RomneyDa。
- 保持可读的聊天标题并保留手动名称 #141600。感谢 @DonnieFi、@IWhatsskill、@jjjhenriksen。
- 对齐侧边栏会话计数 #141924。感谢 @RomneyDa。
- 防止侧边栏会话控件重叠 #142042。感谢 @RomneyDa。
- 当新运行开始时清除上一个会话计时 #142187。
- 移除在线侧边栏名称中非预期的下划线 #142217。感谢 @vyctorbrzezowski。
- 在子代理删除后移除幽灵侧边栏子项 #142438。感谢 @jalehman、@vyctorbrzezowski。
- 在滑动后完成打开移动侧边栏 #142578。感谢 @jalehman。
- 保持会话详情、子面包屑和历史重试一致 #143049。
- 在模型回退后恢复多代理会话列表 #143337。
- 在采用后保留原生会话操作 #143342。感谢 @sunlit-deng、@obviyus、@bricelb。
- 在设备会话和云会话的第一轮之前为其命名 #143760。
浏览长会话
左侧有一个简洁的消息导航器,可在跳转前预览消息,让你无需滚动整个会话即可找到特定答案。在共享聊天中,当信息可用时,预览还会显示消息的发送者。它在桌面端空间足够时出现,并覆盖已加载的消息。
来源和完整变更列表
改进
- 使用紧凑的逐条消息导航栏浏览长聊天 #142227。感谢 @vyctorbrzezowski。
- 在共享聊天导航预览中显示发送者 #143486。感谢 @vyctorbrzezowski。
Bug 修复
- 在会话导航栏预览中渲染 Markdown #142442。感谢 @jalehman。
- 平滑“滚动到最新”过渡 #142720。感谢 @vyctorbrzezowski。
重连时阅读已保存的会话
重新加载应用时,在重连期间可以显示会话和侧边栏的已保存副本,让你在等待时有内容可阅读。此功能适用于已记住的 Gateway Token 或配对设备登录;其他登录方式仍会显示连接界面。发送消息和其他操作会等待连接建立。
如果使用同一个 Web 地址连接多个 Gateway,来自另一个 Gateway 的已保存会话可能会短暂出现。请等待实时会话加载完成后再依赖该视图。
来源和完整变更列表
改进
- 延迟并淡出会话加载占位符 3c322522。上下文 #134868。感谢 @jesse-merhi。
- 重连时显示缓存的聊天和侧边栏内容 #141121。上下文 #141690。
- 在保留已翻译的设置帮助的同时减少启动 JavaScript #143376。感谢 @vincentkoc。
引用文本并保持草稿可读
高亮一段文字并选择“添加到聊天”,即可将可编辑的引用放入草稿,同时不会丢失已写的内容。引用最多包含 300 个字符,在你自己发送消息之前不会发送任何内容。长草稿也更容易编辑,因为你正在输入的行不再在消息框边缘淡出。
选中的欢迎文本显示在消息输入框中且未发送。已发布的 2026.9.4 界面,使用虚构的 Harbor 数据;无实时任务执行。
来源和完整变更列表
改进
- 将选中文本添加到主聊天草稿 #142543。感谢 @Patrick-Erichsen。
- 将“添加到聊天”翻译到 20 个现有语言区域 #142576。
Bug 修复
- 修复移动端聊天间距、滚动预览和键盘焦点 #142143。感谢 @IWhatsskill,@vyctorbrzezowski。
- 在更改和调整大小后刷新附件溢出提示 #142577。
- 使消息输入框附件与草稿文本对齐 #142658。感谢 @vyctorbrzezowski。
- 输入时保持长草稿可读 #142955。感谢 @jalehman。
- 当标签页停止输入时刷新共享聊天预览 #143400。
在聊天中跟踪图片和文档
你发送的图片在会话更新时保持可见,当预览仍可用时,滚动回最近加载的图片可避免再次出现加载占位符。文档位于其对应文本上方,便于在繁忙的会话中识别文件。打开文件时现在会显示正在加载,而不是短暂提示预览不可用。
来源和完整变更列表
改进
- 将文件卡片置于文本上方并对齐参与者媒体 #142671。感谢 @vyctorbrzezowski。
Bug 修复
- 在聊天中向后滚动时保持已加载图片可见 #138303。上下文 #138301。感谢 @vyctorbrzezowski。
- 使聊天附件间距一致 #142246。感谢 @vyctorbrzezowski。
- 在聊天历史加载时防止重复最终回复 #142422。感谢 @jalehman。
- 在附件预览解析时显示加载进度 #142613。感谢 @vyctorbrzezowski。
- 使附件占位符与打开按钮对齐 #142665。感谢 @vyctorbrzezowski。
- 使发送者头像与附件文本对齐 #142694。感谢 @vyctorbrzezowski。
- 在 CLI 历史刷新后防止重复气泡 #142725。
- 在历史加载期间保持已发送图片可见 #143407。
发送前预览视频
现在,已选视频可以在消息框中显示一张静态图像,以便你在发送前区分相似的录像。预览会在你的设备上生成,无需上传视频。已发送的视频在对话中也会显示预览,选中时会在 Files 中打开;如果你的浏览器无法生成预览,则仍会显示常规的文件卡片或图标。
来源和完整更改列表
改进
- 发送前预览已选视频 #142623。感谢 @vyctorbrzezowski。
- 在聊天文本上方显示用户视频预览 #142639。感谢 @vyctorbrzezowski。
浏览文件并保护较新的编辑
Files 在你滚动浏览长列表时,可让搜索和筛选保持触手可及。你可以找到代理更改、读取或创建的文件,预览失败时会解释文件为何无法打开。手机预览也为文档留出更多空间,同时保持其名称可见。
如果你在打开代理文件进行编辑后该文件发生变化,Save 现在会提醒你并保留你的草稿。选择 Reload 以使用较新的文件,或选择 Overwrite 以用你的版本替换它。Overwrite 会丢弃较新的更改,而不是将它们合并,并且该警告无法捕获其他程序所做的所有同时编辑。
一个虚构的欢迎简报在 Review 中与其对话并排打开。2026.9.4 已发布界面,包含虚构的 Harbor 数据;无实时任务执行。
来源和完整更改列表
错误修复
- 保护较新的工作区编辑免受过期编辑器保存的影响 #135865。上下文 #127592。感谢 @yetval, @obviyus。
- 修正展开的文件预览工具提示 #142039。
- 紧凑的手机文件预览并保留全屏标识 #142536。感谢 @vyctorbrzezowski。
- 通过搜索和筛选浏览长文件列表 #143854。
- 显示文件为何无法打开 #143958。感谢 @Marvinthebored, @Peetiegonzalez, @obviyus。
查看 Codex 辅助代理做了什么
在 Tasks 中打开一个 Codex 辅助代理,以阅读其对话、查看其工作并加载较早的消息。你可以查看一个文件并返回,而无需让对话重新加载。新创建的任务在主聊天继续时也可保持可读,尽管一些较旧的任务仍缺少可读历史,并且重置聊天或更改 Codex 账户可能会阻止访问。
来源和完整更改列表
改进
- 在 Tasks 侧边栏中阅读原生 Codex 子代理转录 #143747。
错误修复
跟踪进行中和已完成的工作
已完成和已取消的辅助任务不再显示其旧的工作消息,但它们对已更改文件的摘要仍然可用。长报告保持可读,同时不会隐藏返回启动该任务的对话的按钮,简短的进度更新也不再显示多余的格式符号。代理还会获得更清晰的指令,以跳过快速问题的进度卡片,并将其保留给实质性工作。
来源和完整更改列表
错误修复
- 子代理任务完成时清除过期的活动文本 #129610。感谢 @jalehman。
- 刷新后保持工具评论单一且可见 #140834。感谢 @leapdragon, @obviyus。
- 在显示的推理中保留段落和代码块 #142231。
- 将子代理报告保持在只读页脚上方 #142275。感谢 @vyctorbrzezowski。
- 在工具活动预览中保留字面文本 #142436。
- 不鼓励为快速请求使用进度卡片 #142696。感谢 @vyctorbrzezowski。
- 使子代理活动预览可读 #143741。
放大 Dashboard 并恢复你的布局
点击 Dashboard 选项卡以将其扩展至完整任务区域,然后再次点击以返回你之前的布局。你的草稿以及输入到 Dashboard 中的任何内容都会保持原位。Dashboard 进度也会跟随其所属的对话,因此在其他地方选择不同的代理不会让正在运行的工作看起来暂停。
来源和完整变更列表
**改进** - 扩展仪表板并恢复原始分屏 [#143579](https://github.com/openclaw/openclaw/pull/143579)。感谢 [@fuller-stack-dev](https://github.com/fuller-stack-dev)。 **缺陷修复** - 显示仪表板组件目标会话的活动 [#137255](https://github.com/openclaw/openclaw/pull/137255)。上下文 [#137188](https://github.com/openclaw/openclaw/issues/137188)。感谢 [@sunlit-deng](https://github.com/sunlit-deng)、[@obviyus](https://github.com/obviyus)、[@Richard355168](https://github.com/Richard355168)、[@benjaml4](https://github.com/benjaml4)。上传文件并恢复终端标签页
当你在配对的计算机终端中使用 Claude Code、Codex、OpenCode 或 Pi 时,选择或拖放文件现在会将其位置放入终端供你使用。你可以在按 Enter 之前编辑它。在多个终端标签页正在重新连接时重新加载,也会保留之前从列表中消失的标签页。
如果崩溃后上传仍被阻止,请按照终端恢复步骤操作。在删除错误中指定的锁之前,请停止运行该终端的计算机上所有共享上传文件夹的 OpenClaw 主机进程。
来源和完整变更列表
缺陷修复
- 在锁释放失败后恢复终端上传 #141250。上下文 #137116。感谢 @shakkernerd。
- 将上传路径插入配对节点编码终端 #142001。感谢 @shakkernerd。
- 在恢复中断期间保留终端标签页 #144015。感谢 @vincentkoc。
文档
- 翻译终端上传路径错误 #142077。
搜索和编辑设置
在设置中,删除较早的列表项不再会丢弃另一个项中未完成的文本。在离开页面前,请更正并保存该文本,因为未完成的草稿在重新加载后不会保留。数字按钮也不再跳过第一个允许的值,并且当管理 OpenClaw 的人已禁用 Web 搜索时,Web 搜索会明确保持关闭。
搜索外观会将导航缩小到真正的主题和强调色控件。已发布的 2026.9.4 界面,使用虚构的 Harbor 数据;无实时任务执行。
来源和完整变更列表
改进
缺陷修复
识别人物和代理
提及选择器在你细化搜索时保持建议可用,使你更容易为共享聊天选择某人。代理图片现在可以在受 Token 保护连接的选择器和设置中加载,更改代理的名称或表情符号会更新已打开的聊天,而不会丢失你的草稿。
来源和完整变更列表
改进
- 简化提及标签并改进选择器布局 #142274。感谢 @vyctorbrzezowski。
- 减少跨监视会话的重复在线状态读取 #142612。
缺陷修复
- 在已认证的 Gateway 上恢复选择器头像 #140954。上下文 #140879。感谢 @LiuwqGit、@obviyus、@dimonnld、@rondavis007。
- 在 Web UI 中标记共享 Gateway 所有者的在线状态 #141863。
- 在代理设置中恢复已保存的头像 #142015。感谢 @LiuwqGit、@obviyus、@lei-happy。
- 在输入时保持人员提及建议可用 #142332。感谢 @vyctorbrzezowski。
- 在代理编辑后刷新已打开聊天的身份 #142581。感谢 @aimansour。
- 保存更小的替换代理头像而不会因尺寸降低被拒绝 #143147。感谢 @LiuwqGit、@obviyus、@skaneta。
读取用量和系统状态
用量会保留与正确 agent 的对话详情,并统计列表中实际显示的对话,总数会单独显示。如果你在 Linux 上使用 Bun 运行 OpenClaw,系统繁忙度可以再次显示 CPU 和延迟读数,而不是留下永久短横线。刚启动后出现的短横线仍表示首次读数尚未就绪。
来源和完整变更列表
Bug 修复
屏幕卡住后恢复聊天
如果回复已完成,但屏幕仍显示“停止”,点击它可以恢复已完成的回复和“发送”按钮,而无需重新加载页面。在手机上,当这些操作可用时,失败的消息会保持“重试”或“丢弃”可见;在回复前超时的请求可能会留下说明,该说明在重新加载后仍会保留。再次发送前,请检查第一个请求是否已经完成了工作,因为连接问题可能导致投递状态不确定。
来源和完整变更列表
Bug 修复
- 在移动端保持聊天投递恢复控件可见 #141798. 感谢 @Takhoffman.
- 在对话历史中保留无回复超时通知 #142135. 感谢 @chelsealong, @obviyus, @von8794.
- 在已记住的设备凭据失败后请求 Gateway token #143156.
- 当“停止”发现已完成的运行时恢复“发送” #143437. 感谢 @ylcn91, @obviyus, @YanHE1169.
文档
- 使连接指南与 Gateway UI 标签一致 #141789.
阅读回复并使用熟悉的控件
打开命令面板不再模糊其背后的对话,因此你可以在选择操作时参考某条消息。复制回复会显示一个紧凑的绿色对勾,GitHub 链接避免空的预览弹窗,第一条回复也不再触发彩带效果。在 Mac 上,使用 Command+B、Command+F 和 Command+K 分别对应侧边栏、对话搜索和命令面板;Control 版本保留给文本编辑。Windows 和 Linux 继续使用 Control 作为这些快捷键。
来源和完整变更列表
改进
- 在用户头像周围使用中性的边框 #138285. 上下文 #138277. 感谢 @vyctorbrzezowski.
- 在打开前准备收件箱面板 #142316. 感谢 @vyctorbrzezowski.
- 在命令面板后保持背景文本可读 #142944. 感谢 @jalehman.
- 从聊天中移除首次回复彩带效果 #143167. 感谢 @Patrick-Erichsen.
Bug 修复
- 在 exec 选择器中提供自动主机选择 #137565. 感谢 @jalehman.
- 在缩短 Mermaid 错误时保留 Unicode #137669. 感谢 @ly85206559, @obviyus.
- 保持不可用的 GitHub 预览不显示 #141896. 感谢 @RomneyDa.
- 在受限聊天中跳过被拒绝的读取更新 #142043.
- 使菜单高亮与当前主题匹配 #142243. 感谢 @vyctorbrzezowski.
- 使用聊天选择器后释放临时焦点处理器 #142258.
- 移除按钮链接中非预期的下划线 #142335. 感谢 @vyctorbrzezowski.
- 拒绝无效的自定义聊天消息宽度 #142635.
- 从 GitHub 预览链接中移除重复的工具提示 #142637. 感谢 @vyctorbrzezowski.
- 保留 Mac 文本编辑的 Control 快捷键 #142674. 感谢 @jalehman.
- 显示正确的 Option/Alt+Click 会话选择快捷键 #143051. 感谢 @vincentkoc.
- 对齐聊天操作并保留绿色复制确认 #143425. 感谢 @Patrick-Erichsen.
当交互式卡片出错时获取说明
OpenClaw 可以在 widgets(agent 可以放置在聊天中的小型交互式应用)出现之前捕获其中的一些编码错误。如果最近的一张卡片在你使用时失败,Web 应用可以显示 Script error 通知并告诉 agent 发生了什么,给它一个帮助你恢复的机会。
来源和完整变更列表
**改进** - 显示组件脚本失败并通知代理 [#142225](https://github.com/openclaw/openclaw/pull/142225). **缺陷修复** - 在显示前捕获组件脚本语法错误 [#141939](https://github.com/openclaw/openclaw/pull/141939).阅读更新后的界面指南
设置、插件浏览、文件和 cloud-worker 控件中的更多标签和帮助文本已翻译。设置还会在你搜索字段时使用可用翻译,便于在你选择的语言中找到选项。
来源和完整变更列表
改进
- 翻译连接进度和 setup-code 指南 #141750.
- 翻译 Web UI 中的 Shared 所有者标签 #141881.
- 翻译 board-widget 脚本错误标签 #142147.
- 翻译 model-discovery 状态和重试消息 #142334.
- 刷新 20 种界面语言的翻译 #142699.
- 刷新 20 种语言的插件界面翻译 #143622.
- 刷新 cloud-worker 和通知翻译 #143868.
- 翻译文件和快照控件 #143924.
- 翻译快照构建控件和错误 #144011.
缺陷修复
- 将可用翻译应用于核心设置字段 #137192. 上下文 #137190. 感谢 @husodrn46, @obviyus.
- 本地化选择器的“无匹配项”消息 #142255.
- 更正父会话和仪表板翻译 #142327.
文档
更新与维护¶
更新 OpenClaw 可修复升级停滞、插件遗留以及令人困惑的恢复消息。同时改进了将旧对话和设置向前迁移、备份你需要的文件,以及在不影响其他工作的情况下清理历史记录。
完成更新
从近期稳定版本更新时,可以越过那些导致更新无法完成或使 OpenClaw 在更新后停止的故障。从浏览器更新还会获得启动修复,并且活动对话不太可能阻塞更新。部分修复只有在安装新版更新器后才有效,因此如果当前版本卡住,请遵循更新指南,而不是反复尝试同一条失败命令。
来源和完整变更列表
缺陷修复
- 让旧版更新器完成并重启 Gateway #142195 感谢 @Newsstand.
- 在 dev-update 安装前检查 Node 兼容性 #142248 感谢 @TheAngryPit, @jialele, @obviyus.
- 更正更新期间的 Node 兼容性建议 #142322 感谢 @SunnyShu0925, @guarismo.
- 允许在代理数据库繁忙时进行更新检查 #142419 感谢 @jalehman.
- 恢复从 2026.9.1 Git 构建 0229a108 更新后的重启启动 #142631 感谢 @jason-allen-oneal.
- 在受管 pnpm 更新期间遵循已激活的包目录 #143137 感谢 @timetrvlr.
- 在更新试验期间保留捆绑插件的信任 #143190 感谢 @DonnieFi.
- 恢复从旧稳定版本升级 #143859
- 通过更新检查验证同一 Gateway #143863 感谢 @fuller-stack-dev.
- 修复受管更新辅助程序的启动 #144031 感谢 @IWhatsskill, @fuller-stack-dev.
- 允许已确认的无服务 Linux 更新,保持 transcript 的 stdout 干净,保留自定义 root/account schema 类型,并在准备好的 skills 未更改时复用热 Claude CLI 进程 #144402 感谢 @vincentkoc.
限制与兼容性
- 对齐包版本和扩展兼容性要求 86ef455b
更新从源码构建的安装
如果你从 Git 检出运行 OpenClaw,当上游发布标签发生变化时,更新可以恢复,并且 Windows 获得了一项修复,用于解决更新在开始之前失败的问题。状态现在会在失败的更新检查导致其信息过期时发出警告。该警告会在更新器下次成功获取后清除。如果你的检出有多个可能的更新来源,开发频道指南 解释了如何选择其中一个。
<details class="release-source-toggle">
<summary>来源和完整变更列表</summary>
**Bug 修复**
- 当上游发布标签移动时恢复 Git 更新 [#126816](https://github.com/openclaw/openclaw/pull/126816) 感谢 [@ruel225](https://github.com/ruel225), [@zhangguiping-xydt](https://github.com/zhangguiping-xydt), [@ToneLoke](https://github.com/ToneLoke)。上下文 [#123318](https://github.com/openclaw/openclaw/issues/123318)。
- 同步具有异常文件名的源资产 [#142024](https://github.com/openclaw/openclaw/pull/142024)
- 当失败的更新获取导致状态信息过期时发出警告 [#142199](https://github.com/openclaw/openclaw/pull/142199) 感谢 [@ToneLoke](https://github.com/ToneLoke)。
- 修复用于更新和克隆的 Windows Git 配置路径 [#142749](https://github.com/openclaw/openclaw/pull/142749) 感谢 [@pengzh1](https://github.com/pengzh1), [@aevgeniou](https://github.com/aevgeniou), [@jalehman](https://github.com/jalehman)。
</details>
从失败的更新中恢复
当更新失败时,如果之前的应用版本仍能与你的当前设置和数据配合工作,OpenClaw 可以恢复之前的应用版本。如果无法检查这一点,恢复将停止,并保留可用的恢复文件以供检查。被中断的更新可能仍需要手动帮助。回滚应用不会恢复你的数据,因此请在更新前创建并验证备份。
来源和完整变更列表
Bug 修复
- 当 Gateway 启动需要修复时保留现有状态 #141451 感谢 @Lendersmark, @jerabinovich。
- 在失败更新恢复后更正版本检查 #142817 感谢 @wangmiao0668000666。
- 在更新器所有权丢失后停止回滚 #143791 感谢 @vincentkoc, @fuller-stack-dev。
- 报告失败的临时副本清理 #143844 感谢 @fuller-stack-dev。
- 在更新所有权丢失后停止插件写入 #144130 感谢 @fuller-stack-dev。
限制与兼容性
- 保护兼容包回滚和中断的更新,在重启前完成插件工作,添加复制代理预检,遵循相同版本的包工件,并抑制未经请求的独立重启通知 000af986 感谢 @fuller-stack-dev。上下文 #140339。
清除卡住的更新消息
旧的“更新进行中”消息即使更新本身已不再运行,也可能阻止设置更改和账户登录。openclaw update repair 在确认更新器已停止且 OpenClaw 正在运行后,可以清除符合条件的卡住更新。一些从未开始的旧请求会在一天后自动清除,前提是没有内容仍需要恢复。它们会作为失败尝试保留在历史记录中,并提供重试指导。
来源和完整变更列表
Bug 修复
- 修复被放弃的更新运行,无需不必要的 30 分钟等待 #143136 感谢 @yncubys, @guarismo, @SunnyShu0925。
- 清除阻止设置写入的被放弃的旧版更新 #143774 感谢 @Colton-Harris, @syfvb, @ElvisIO7, @rlosito, @alexph-dev, @aaajiao, @c0ncatenate, @unknowbug, @KingAkrej, @DasX, @jlacroix82, @mikronn2, @najef1979-code。
文档
- 解释旧更新记录的自动过期 #143974
给冗长的修复留出完成时间
在较大安装上的更新现在会给 Doctor(OpenClaw 的修复工具)留出时间,以完成过去会被中断的工作。一些无法删除一次性文件的失败会变成带有清理建议的警告,而阻止更新后应用运行的问题仍会停止更新。卡住的修复可能会持续等待,除非你设置了限制,并且停止更新可能会留下仍在运行的修复工作,因此如果进度停止,请使用修复指南。
来源和完整变更列表
Bug 修复
- 允许长时间的更新 Doctor 修复完成 #143321 感谢 @fuller-stack-dev。
- 在可恢复的清理失败后继续更新 #143767
选择更新失败后的操作
如果更新失败,但先前安装已恢复并检查,菜单默认选择“退出”。你可以选择排查问题,或在发送前预览报告。对于其他交互式更新失败,修复提示会告知你将运行哪个 AI 代理,以及它会使用你的账户额度或付费 Token。你可以拒绝,但按 Enter 表示接受,若提示未作答,30 秒后会启动代理。
Claude 辅助修复会先启动,不包含可能延迟修复的项目自定义。如果你的修复需要这些自定义工具或指令,请改用提供的手动命令。修复代理指南 会说明相关选项和 Claude 要求。
来源和完整变更列表
改进
- 在自动更新修复启动代理之前提供选择 #143139
缺陷修复
- 在已验证的更新回滚后使诊断可选 #143657 感谢 @fuller-stack-dev。
文档
- 明确更新失败恢复选项 #143723
限制与兼容性
了解更新进度和警告
更新进度和最终报告现在对发生的情况保持一致,包括更新失败但先前版本成功恢复的情况。警告会保留有用的修复建议,并识别遗留的备份文件,读取历史记录的问题不再隐藏其他更新指导。如果更新停滞,会保留更多故障排查信息。你可以查看更新报告,或在之后运行 openclaw doctor 执行更新本身不需要的检查。
来源和完整变更列表
改进
- 在停滞的更新诊断中识别子进程 #141740 感谢 @hannesrudolph。
- 更新期间跳过无关的 Doctor 诊断 #142675 感谢 @fuller-stack-dev。
缺陷修复
- 跳过可选更新探测并保留 Doctor 警告 #141995 感谢 @hannesrudolph。
- 更新期间保留核心 Doctor 警告 #142091
- 更新最终处理超时时保留 Doctor 诊断 #142672 感谢 @fuller-stack-dev。
- 更新前显示刷新后的提交计数 #142837 感谢 @jalehman。
- 历史记录失败时保持更新指导可用 #143557
- 加载更新历史时不暂停其他 Gateway 工作 #143605
- 停止显示不可用的更新报告文件 #143748
- 修正已授权 SSH 更新到不同主机的代理指导,同时保留正常审批 #143754
- 报告最终更新结果和保留的备份 #143921 感谢 @fuller-stack-dev。
- 保持更新进度与最终报告一致 #143965
文档
- 将更新文档拆分为聚焦指南 #142858 感谢 @vincentkoc。
- 将更新指导拆分为聚焦页面 #142993 感谢 @vincentkoc。
当 OpenClaw 已是最新时更新插件
运行 openclaw update 现在会检查符合条件的插件,即使主应用已是最新,包括你单独更新它之后。如果没有变化,它会跳过不必要的后续工作。如果你有意将某个插件保留在特定版本,该选择会保持不变,而有关较新官方版本的提示会说明如何更改。插件更新可能需要重启,应用更新期间的插件下载可能会延长 OpenClaw 不可用的时间。
来源和完整变更列表
改进
- 更新期间跳过不必要的插件扫描 #143783
缺陷修复
- 报告较新版本而不替换官方插件版本固定 #137892 感谢 @pfrederiksen、@vincentkoc。上下文 #137624。
- 为保留的官方插件版本固定显示警告 #142457 感谢 @PollyBot13、@obviyus、@martins-oss。
- 核心已是最新时运行插件维护 #143174 感谢 @martins-oss、@fulgerulnegru、@kesslerio、@guojiongming、@soroyue、@Sedrak-Hovhannisyan。
- 更新未产生变化时跳过冗余完成处理 #143462 感谢 @RomneyDa。
- 跳过在新 ID 下已修复的插件 #143861
修复旧设置和已移动的工作区
Doctor 可以将更多旧设置和已保存的账户迁移过来,而不会丢失你的模型选择,也不会要求你手动编辑配置文件。它还可以识别已移动的工作区并保留其配置历史,同时将不确定的匹配项留待审查。
如果旧的 Claude 对话尚未转换为当前格式,请在恢复它之前运行 openclaw doctor --fix。Doctor 检查指南 解释了该步骤以及仍需手动处理的场景。
来源和完整变更列表
Bug 修复
- 修复可选 Codex 检查、无配置更新收尾以及私有 Doctor 快照清理 f212072e
- 修复已移动的工作区,且不阻塞排队消息 #133198 感谢 @safzanpirani、@obviyus。上下文 #133172。
- 在缩短的 SQLite worker 错误中保留 Unicode #137675 感谢 @ly85206559、@obviyus。
- 等待协作插件通过其注册本地处置回调释放 Doctor 检查资源 #141692
- 为不可读的 Doctor 状态显示备份恢复指导 #141776
- 停止 Doctor 建议已在进行中的技能修复 #141866
- 解释浅层快照失败和不完整克隆 #141936
- 在 Doctor 迁移期间保留模型选择和后端 #142284 感谢 @obviyus。
- 在缺失插件修复中尊重搜索提供商选择;独立的 release-repair 路径仍可从环境凭据中选择 Brave #142640 感谢 @vincentkoc。
- 修正完整的 Doctor lint 路径,并保留已检查的 sidecar 和技能链接;普通 lint 仍保留其独立的共享内存限制 #142839 感谢 @thien-ngn、@obviyus。
- 恢复旧版多智能体备份,无需手动编辑所有权 #143202 感谢 @GitHoubi。
- 使用 Doctor 修复旧版 music-model 引用 #143235 感谢 @obviyus。
- 在 Doctor 迁移过程中保留已保存的账户 #143429 感谢 @obviyus。
文档
- 按修复任务组织 Doctor 指导 #141961 感谢 @vincentkoc。
- 按任务组织 Doctor CLI 文档 #142855 感谢 @vincentkoc。
限制与兼容性
将旧对话迁移过来
导入旧的 Codex 对话时,现在会保留此前可能丢失的助手回复,并保持其原始顺序。如果你已经导入了受影响的对话,恢复功能可以添加缺失的回复,但会将它们追加到末尾,而不是重建原始对话顺序。当保存的对话存档被重新创建时,对附件信息的修复也会保留下来。如果备份关联的文件阻止了导入,错误会指向该文件以及安全恢复步骤。
来源和完整变更列表
Bug 修复
备份所有需要的设置文件
如果你将设置拆分到多个文件中,完整备份现在会包含主配置所引用的文件,即使它们位于常规备份文件夹之外。如果无法完整捕获这些文件,它会停止并提供修复指导。--only-config 选项仍然只保存主文件。
当临时数据库文件的内容已被安全捕获时,备份也会处理该临时数据库文件消失的情况。备份不会将整个安装冻结在某一瞬间,因此在备份运行期间所做的更改可能不会全部包含在内。请将存档视为敏感信息,因为设置文件可能包含机密,并在检查或恢复它时遵循备份指南。
来源和完整变更列表
Bug 修复
-
当快照的 SQLite 边车消失时,保持备份继续运行 #141161 感谢 @LiuwqGit, @vincentkoc, @Cobblestone-Digital1, @legupsystems. 上下文 #141042. 上下文 #67417.
- 在完整备份中保留必需的 configuration includes #143693 感谢 @fuller-stack-dev.
检查较大规模的安装
保存数据较多的安装会获得更长时间来完成数据库检查,部分检查需要更少的临时磁盘空间,并避免重复工作。当维护此前在未完成前停止时,这会有帮助,同时仍保留对损坏数据的检查。如果出现问题,错误会提供更多有用的线索,说明检查停在哪里,以及 Doctor 何时可能提供帮助。
来源和完整变更列表
改进
- 显示最后观察到的数据库完整性检查阶段 #141669
- 减少适用的 SQLite 检查快照所需的临时磁盘空间 #141773
- 报告缓慢的会话清理工作线程操作 #142525
- 减少数据库快照启动开销 #144022
Bug 修复
- 为大型数据库提供更多启动检查时间 #141918
- 为大型数据库检查提供基于大小的超时 #142179
- 在 Doctor 修复期间避免冗余数据库扫描 #142669 感谢 @fuller-stack-dev.
- 当无需修复时保持健康的内存数据库句柄打开,并在更新期间跳过 GitHub 凭据和引导大小建议 #143361 感谢 @fuller-stack-dev.
- 在 SQLite 启动错误中指明 Doctor 修复命令 #143531 感谢 @RomneyDa.
文档
- 整理数据库参考和恢复指南 #143152 感谢 @vincentkoc.
在历史记录清理期间保持工作
在 OpenClaw 检查其保存的数据时,删除会话和清理旧对话不太可能暂停其他工作。清理还会在删除更多历史记录之前再次检查,因此当释放了足够空间时可以停止,并且不会动新受保护的对话。你的保留设置仍然决定哪些内容可以被移除。
来源和完整变更列表
Bug 修复
重启和关闭 OpenClaw
Linux 用户将获得针对卡住的重启以及导致 OpenClaw 反复重启的冲突设置的修复。这些冲突现在会留下一个错误,需要在再次启动前修复。关闭也会给插件和语音连接时间来完成清理和最终写入,尽管卡住的插件仍可能延迟它。
重新连接会避免重复不必要的健康检查,同时需要时仍可进行新的检查。
来源和完整变更列表
Bug 修复
- 避免对已屏蔽的 systemd 服务给出错误修复建议 #137869 感谢 @teddytennant, @obviyus, @aniruddhaadak80. 上下文 #128928.
- 防止受管理的 systemd 重启挂起 #140914 感谢 @NianJiuZst, @rboy1, @obviyus. 上下文 #140821.
- 在瞬时 DNS 拒绝后,让受影响的 CLI 启动的 Gateway 继续运行,而不重试失败的操作 #141163 感谢 @ly85206559, @orangejon. 上下文 #141123.
- 当 Gateway 握手在 WebSocket 传输前失败时,返回服务不可用响应 #141303 感谢 @hugenshen, @obviyus.
- 在关闭期间等待 Talk 连接清理 #141706
- 在插件重新加载后保持启动日志最新 #141736
- 停止由冲突的 Gateway 设置引起的重启循环 #141771 感谢 @chelsealong, @tomdailey55, @jalehman.
- 在清理期间保持共享 Gateway 状态可用 #142286
- 在自动 macOS CLI 退出前完成待处理的清理 #142814
- 避免在重新连接时重复收集健康状态 #143384
- 在架构升级期间保留重启选项 #143738 感谢 @RomneyDa.
文档
- 按操作员任务拆分 Gateway CLI 参考 [#143005](https://github.com/openclaw/openclaw/pull/143005) 感谢 [@vincentkoc](https://github.com/vincentkoc)。
- 按症状组织 Gateway 故障排查 [#143160](https://github.com/openclaw/openclaw/pull/143160) 感谢 [@vincentkoc](https://github.com/vincentkoc)。
</details>
在 OpenClaw 外部管理设置
如果另一个工具管理你的 OpenClaw 设置,新的只读配置选项可防止 OpenClaw 覆盖这些设置,包括在自动恢复期间。请为正在运行的服务和终端命令都设置 OPENCLAW_CONFIG_READONLY=1。对话和其他工作数据仍然需要一个可写位置,并且模型更改可以应用于当前会话,而不会更改已保存的默认值。
在创建或更改代理之后进行的设置编辑也可避免虚假的“自上次加载以来已更改”错误。保存设置和应用设置仍然是分开的,因此如果你关闭了自动重新加载,请重启 OpenClaw 以使用这些更改。
来源和完整变更列表
改进
Bug 修复
文档
- 澄清关闭重新加载模式下的手动重启要求 #127205 上下文 #127203。
- 将 Gateway 配置指南拆分为主题页面 #143456 感谢 @vincentkoc。
在 Windows 上停止并更新 OpenClaw
对于使用 OpenClaw 标准启动器的 Windows 安装,停止计划 Gateway 任务现在也会停止它启动的工作,从而允许全新启动,而不会被遗留副本妨碍。早期启动失败也会记录到日志中。自定义可执行文件包装器或额外的命令 shell 层仍可能阻止启动。缓慢的 Windows 服务检查在更新期间会再获得一次机会,但持续挂起的检查可能会使等待时间大大延长;如果无法检查服务,更新会在替换应用之前停止。
来源和完整变更列表
Bug 修复
- 停止 Windows Gateway 任务的后代进程并记录子进程失败 #141744 感谢 @akagifreeez, @Devin-Linux, @unknowbug。
- 在 Windows 服务检查中遵守更新超时 #143292 感谢 @fanyuantaier。
查找监控帮助
监控指南 让你更容易找到设置监控的帮助、理解它捕获哪些信息,或了解如何在仪表板中使用这些信息。说明围绕这些任务组织,现有链接仍会指向正确位置。
来源和完整变更列表
文档
- 将 OpenTelemetry 指南拆分为聚焦页面 #142951 感谢 @vincentkoc。
消息¶
此更新修复了对话可能丢失其文字、回复或位置的若干情况。长回复会保留其格式,Feishu 文档工具在受影响的聊天中再次可用,并且 Talk 可以在将工作交给另一个代理后带回答案。
回复和进度更新
在 OpenClaw 暂停期间到达的消息现在会等待,直到它再次就绪,未完成的回复也不再被误认为已完成的发送。如果你显示详细进度,较新的工作会保持可见,而不会被旧的命令失败挤出。缺少回复的通知也会提供更清晰的解释,以及管理员可用于调查的参考。
来源和完整变更列表
Bug 修复
- 在仅消息组中隐藏内部终结器占位符 73ca607b1d99。感谢 @razvangirgiz, @obviyus, @omarshahine。上下文来源 #138645。
- 在强制清理期间保持未完成回复为待定状态 #141900。感谢 @Takhoffman。
- 在 Gateway 暂停期间暂停消息重试 #142064。感谢 @goutamadwant, @obviyus, @Stephane-fci。
- 在重复命令退出后保持计划和较新活动可见 #142802。感谢 @obviyus。
改进
- 添加更清晰的缺少回复通知和运行引用 #136462。感谢 @RomneyDa, @sloptop-the-terrible。
可读性更好的长回复
长回复 会在更自然的位置换行,并且当代码延续到另一条消息时,代码会保留其格式。已成功接收的代码不再导致整个答案在末尾重复。引用示例也会保留其间距,使其更易于阅读和复制。
来源和完整变更列表
缺陷修复
Telegram 格式与贴纸
如果启用 Telegram 富消息,列表、引用和可展开部分中的链接将保持可点击并保留其样式。代码示例在消息和照片说明中也会保留其间距。贴纸描述现在会使用你选择的图像模型,并能在你的 Claw 首次回复前及时送达。
来源和完整变更列表
缺陷修复
Telegram 提及与命令
Telegram 可以识别在消息和照片说明中标记机器人账户的提及。如果你已关闭原生命令,可以在一行中写入 /think high,并在其下方写入你的请求,而不会丢失该请求。/think 菜单还会显示处理该聊天的代理的设置,并且取消的尝试之后不再留下具有误导性的“停滞”表情。
来源和完整变更列表
缺陷修复
- 在文本和说明中识别机器人身份提及 #140266。感谢 @cai-ops、@obviyus。
- 在取消准备后停止过期的停滞表情 #141079。感谢 @ooiuuii、@obviyus。
- 在多行 Telegram 指令后保留任务 #142008。感谢 @wangmiao0668000666、@obviyus。
- 在 Telegram 中显示路由代理的思考默认值 #143789。
文档
- 按任务组织 Telegram 文档 #142963。感谢 @vincentkoc。
代理故障后的 Telegram 回复
如果你通过代理连接 Telegram,并且在回复发送之前代理拒绝了连接,OpenClaw 可以在连接恢复时保留该回复以便再次尝试。它仍然会避免重新发送投递状态不确定的消息,因此这不会自动恢复所有之前失败的回复。
来源和完整变更列表
缺陷修复
- 在代理隧道拒绝后恢复排队中的回复 #140388。感谢 @Hekzory、@MAG-Linares-Andalucia。
Discord 消息、语音留言和进度
在 Discord 频道中,如果你的 Claw 已经可以在未被提及时读取消息,语音留言现在会在对话中保留其口述内容。附件说明也会保留重复的指令,并且如果最终答案无法发送,进度更新仍会保持可见。
当你拥有权限时,诸如检查 OpenClaw 系统状态之类的请求现在可以从服务器消息中再次正常工作,修复了尽管工具可用但请求被拒绝的情况。
来源和完整变更列表
缺陷修复
- 从启动和重连快照填充成员在线状态 #141218。感谢 @harshitgupta31415、@vincentkoc、@nissl24。
- 在发送失败后保留 Discord 评论和进度 #141621。感谢 @anyech、@obviyus、@dw1161。
- 保留重复的 Discord 说明和链接按钮表情 #142342。
- 在 Discord 环境对话中保留语音留言的文字 #142860。感谢 @ericcaiwx-star、@aatreya、@jalehman。
- 在 Discord 服务器消息中恢复已允许的系统代理委托 #143006。感谢 @Marvinthebored、@Peetiegonzalez、@obviyus、@0xCyda、@lisheguo。
文档
- 将 Discord 文档整理为专题指南 [#142666](https://github.com/openclaw/openclaw/pull/142666)。感谢 [@vincentkoc](https://github.com/vincentkoc)。
</details>
Slack 表情回应与消息格式
即使你已关闭持续状态表情回应,当 Slack 识别到你的提及时,它仍可以显示已配置的表情回应。包含 Windows 路径的消息 也会保持其格式,而不会意外将后续文本变成代码。
来源和完整变更列表
错误修复
- 解决所有者心跳私信的共享工作区问题 #138689。感谢 @Kimiyu-186。
- 确保 Windows 路径后的 Slack 正文不会进入代码格式 #142288。
- 在状态表情回应关闭时,保留 Slack 确认回应 #142595。感谢 @sunlit-deng、@alexjpanagis。
Feishu 文档与格式化消息
如果单独安装的 Feishu 插件曾导致你的 Claw 无法从聊天中操作文档、Wiki、Drive 或 Bitable,这些工具现在可凭你现有的权限再次使用。对工具和账户设置的更改现在可应用于新请求,而无需重启 OpenClaw;已在进行中的工作仍保留其原有设置。你的 Claw 也会接收你在格式化消息、链接和提及中设置的强调。
来源和完整变更列表
改进
- 跳过普通 Feishu 卡片中不必要的表格解析,并停止检查超限卡片 #141770。表格较多的场景不会获得普遍加速。
错误修复
- 在消息驱动的运行中恢复 Feishu 工作区工具 #141984。感谢 @SunnyShu0925、@hayden-cc、@lizhengwu、@jalehman、@seven7763、@itanyplus。
- 将更新后的 Feishu 工具设置应用于新轮次 #141993。
- 在接收到的帖子中保留 Feishu 内联样式 #142627。
文档
- 按任务整理 Feishu 文档 #143085。感谢 @vincentkoc。
Matrix 消息与表情回应
Matrix 会保留此前可能被误认为附件并从引用回复或对话历史中消失的消息文本。当先前的代码格式未完成时,标记为纯文本的提及也会保持纯文本。在终端中,表情回应列表会显示人们使用了哪些表情,而不是留下空白标签。
来源和完整变更列表
错误修复
- 为未知消息类型保留 Matrix 文本 #135359。感谢 @teddytennant、@obviyus。
- 在 CLI 列表中显示 Matrix 表情回应标签 #141811。
- 在未匹配的反引号之后,保持转义的 Matrix 提及为字面文本 #142369。
文档
- 将 Matrix 文档整理为专题指南 #142996。感谢 @vincentkoc。
Teams 消息文本
你的 Claw 现在能够正确读取以 HTML 形式提供的 Teams 消息 中的标点符号和符号,而不会收到替代它们的格式代码。例如,版权符号会以 © 形式到达,而不是用于表示它的代码。
来源和完整变更列表
错误修复
- 正确解码仅含 HTML 的 Teams 消息文本 #142496。
文档
- 将 Teams 文档整理为专题指南 #142986。感谢 @vincentkoc。
Signal 回复引用
如果你将 Signal 设置为仅在首次回复时引用你的消息,那么当较早的发送失败时,该引用现在仍会保持可用。实际到达的首条回复会显示它正在回复的内容。
来源和完整变更列表
文档
- 记录 Signal 表格模式、默认项目符号以及块级内容到代码的回退 #138160。感谢 @SunnyShu0925、@obviyus。
错误修复
- 在流式发送失败后保留 Signal 引用 #142600。
WhatsApp 回复标签
如果你在 Claw 的 WhatsApp 回复开头使用自定义标签,它不会再被添加到来自其他人的消息中。你的出站标签仍然有效,而入站消息会保留发送者所写的内容。
来源和完整变更列表
错误修复
- 避免将回复前缀添加到传入的 WhatsApp 消息中 #138819。感谢 @sunlit-deng、@vincentkoc、@Jackten。
iMessage 会话名称
当相关信息可用时,iMessage 会话可以显示熟悉的联系人和群组名称,例如 Alice 或 Family。您自己设置的名称会保留在原位,便于找到正确的聊天,而无需在电话号码或技术 ID 中翻找。
来源和完整变更列表
文档
- 在成熟度文档中澄清当前 iMessage 支持情况 #141963。感谢 @RomneyDa。
- 按设置和消息任务组织 iMessage 指南 #143038。感谢 @vincentkoc。
错误修复
- 显示已解析的 iMessage 联系人和群组名称 #142128。感谢 @omarshahine。
Mattermost 连接和进度
对于将登录令牌与账户设置分开存储的 Mattermost 设置,编辑一个账户不再会不必要地重新连接其他账户;所有账户共享的设置仍可以一起重启它们。替换进度消息在旧消息被移除时也会保持可见,即使两者包含相同的计划。
来源和完整变更列表
错误修复
返回 Google Chat 会话
从恢复的 Google Chat 会话中发送的回复现在可以再次正确使用其已保存的目标。这修复了一种情况:更改目标中的大写字母会导致权限错误,即使您的 Claw 被允许发送到该位置。
来源和完整变更列表
错误修复
Nextcloud Talk 表情回应延迟
启用诊断录制时,成功的 Nextcloud Talk 表情回应不再需要等待该录制完成后再报告成功。录制可能不完整,但不再阻塞结果。
来源和完整变更列表
错误修复
- 避免 Nextcloud Talk 响应中的诊断捕获延迟 #141307。感谢 @hugenshen、@obviyus。
缺失的 Tlon 设置详情
如果由于设置不完整导致 Tlon 消息无法发送,错误现在会告诉您需要关注哪个账户以及缺少哪些设置。您可以直接前往 Tlon 设置 的相关部分,而无需猜测,并且错误不会泄露您的登录代码。
来源和完整变更列表
错误修复
- 在发送错误中识别缺失的 Tlon 账户设置 #137664。感谢 @ly85206559、@obviyus。
修复旧版 Zalo Personal 设置
如果您使用多个 Zalo Personal 账户且采用旧版设置,openclaw doctor --fix --non-interactive 现在可以完成之前跳过的设置修复。您的账户资料以及关于谁可以给机器人发消息的明确选择将保持完整。
来源和完整变更列表
错误修复
- 恢复 Zalo Personal 策略迁移 #143860。感谢 @wangmiao0668000666、@obviyus。
选择和管理消息账户
账户列表和健康检查更准确地显示您的代理使用哪些账户。移除账户 现在会在没有移除任何内容时报告,消息命令错误 会在需要时解释如何选择代理。
如果您使用脚本,当希望使用默认值时,请省略 --account 和 directory 选项 --limit。传入空值现在会导致错误;提供的限制值必须是正整数。移除脚本还必须处理没有移除任何内容时的错误。
来源和完整变更列表
限制和兼容性
- 拒绝目录命令中的空白账户选项 #137334。感谢 @Alix-007、@obviyus。
- 拒绝显式空白的目录列表限制 #141738。感谢 @hugenshen、@obviyus。
- 拒绝消息和频道命令中的空账户选择器 #143088。感谢 @ly85206559、@obviyus。
错误修复
- 在代理列表中正确显示频道账户选择器 #141724。
- 为消息命令提供可用的所有权补救措施 #141886。感谢 @Dreamer-HIT、@obviyus、@schwanncells。
- 在健康输出和 listBoundAccountIds 中包含隐式默认账户 #143319。感谢 @qingminglong、@obviyus。
- 在插件加载前保留频道副标题 #143416。
- 在插件设置前拒绝空白目录组 #143440。
- 在移除期间拒绝未知频道账户 #143561。感谢 @masatohoshino、@obviyus。
文档
- 将通道配置文档拆分为专题页面 [#142910](https://github.com/openclaw/openclaw/pull/142910)。感谢 [@vincentkoc](https://github.com/vincentkoc)。
- 更正 Matrix Token 和重启步骤、Tlon 登录指引、Yuanbao App Key 说明,以及插件发布和 SDK 示例 [#144018](https://github.com/openclaw/openclaw/pull/144018)。感谢 [@vincentkoc](https://github.com/vincentkoc)、[@sunnyiren-max](https://github.com/sunnyiren-max)。
</details>
在 Claw 委派工作时保持对话
Talk 可以在另一个代理处理你的请求时继续监听,然后将完成的答案带回同一个语音对话以及聊天中。当任务需要多轮协助时,这也同样有效。保持该语音对话打开以接收语音结果;结束它或重启 OpenClaw 可能导致答案只能通过聊天获取。
来源和完整变更列表
Bug 修复
- 让语音后续消息和回复与当前任务保持关联 #129186。感谢 @vincentkoc。
- 将委派的答案返回到当前 Talk 会话 #129535。感谢 @vincentkoc。
- 在多次委派后交付 Talk 答案 #142830。
文档
- 将 Talk 指引整理为专题页面 #143149。感谢 @vincentkoc。
电话中断和短暂音频错误
当你在电话中打断你的 Claw 时,它现在会使用电话服务的播放确认,以避免将你从未听到的答案视为已经说出。通过 OpenClaw 进行的 GPT-Live 通话在偶尔出现可恢复的音频错误后也可以继续,尽管你可能会听到短暂停顿。反复失败仍可能结束通话;有关设置和故障排除,请参阅 Voice Call 指南。
来源和完整变更列表
Bug 修复
- 为某些无法识别的名称恢复默认 Twilio 语音 #137678。感谢 @teddytennant、@obviyus。
- 防止未知通话状态结束当前通话 #137679。感谢 @teddytennant、@obviyus。
- 当来电者打断时跟踪已确认的电话播放 #138619。感谢 @LiuwqGit、@obviyus、@fabiolr、@xueqingli1。
- 在可恢复的音频错误后保持 GPT-Live 通话连接 #140702。感谢 @zenglingbiao、@obviyus。
- 为未知语音流路径返回清晰的错误 #141315。感谢 @hugenshen、@obviyus。
文档
- 将 Voice Call 指引整理为专题页面 #143055。感谢 @vincentkoc。
记忆¶
记忆修复可帮助你的 Claw 找到已记住的详细信息并返回较早的对话。当记忆无法保存,或删除对话后仍保留其记忆时,也有更清晰的指引。
查找已记住的详细信息
请求较短的记忆列表时,不再仅仅因为请求的结果较少而丢弃更好的匹配项。当可选搜索卡住时,你的 Claw 也可以继续查找;并且本地记忆搜索服务会在 OpenClaw 放弃之前有时间启动。这些修复可帮助已记住的信息无需不必要的修复步骤即可到达你的对话。
来源和完整变更列表
Bug 修复
- 在较小的结果限制下保持最佳记忆匹配一致 ff1d91f。感谢 @linhongyu510。
- 在管理器替换后恢复记忆搜索 #141879。
- 在可选查找超时后保留 Active Memory 召回 #142567。感谢 @ylcn91、@obviyus、@BsnizND。
- 允许在计时记忆搜索之前启动本地嵌入 #143590。感谢 @wangmiao0668000666、@obviyus、@PeterHodl。
- 跳过代理交付中不必要的召回 #143903。感谢 @LiuwqGit、@obviyus、@kiagentkronos-cell、@syfvb。
设置记忆搜索
OpenClaw 可以等待你的记忆搜索提供商的临时限制,并在切换到已配置的备用提供商时使用正确的模型。它也不会仅仅因为主提供商已恢复就提示你重建工作记忆搜索。如果你更改为不兼容的模型,仍需要使用 openclaw memory index --force 重建。
使用 Bun 运行 OpenClaw 的 Mac 用户可以通过 brew install sqlite 启用原生记忆搜索。如果你之前使用了自定义 SQLite 启动脚本,请将其替换为 OPENCLAW_SQLITE_LIBRARY 设置,以避免启动失败。
<details class="release-source-toggle">
<summary>来源与完整变更列表</summary>
**改进**
- 在 macOS Bun 上通过 Homebrew SQLite 启用原生记忆搜索;用 `OPENCLAW_SQLITE_LIBRARY` 替换自定义 SQLite 预加载,并用 `OPENCLAW_CLI_BACKEND_LOG_OUTPUT` 替换已移除的 `OPENCLAW_CLAUDE_CLI_LOG_OUTPUT` 别名 [#141854](https://github.com/openclaw/openclaw/pull/141854).
**缺陷修复**
- 在记忆索引期间遵守提供商冷却期 [#134959](https://github.com/openclaw/openclaw/pull/134959). 感谢 [@shojikumaru](https://github.com/shojikumaru), [@obviyus](https://github.com/obviyus), [@developercrocodiles](https://github.com/developercrocodiles).
- 使用回退提供商的模型用于记忆嵌入 [#142364](https://github.com/openclaw/openclaw/pull/142364). 感谢 [@Yigtwxx](https://github.com/Yigtwxx), [@obviyus](https://github.com/obviyus).
- 在深度记忆状态中识别回退构建的索引 [#142609](https://github.com/openclaw/openclaw/pull/142609). 感谢 [@Yigtwxx](https://github.com/Yigtwxx), [@obviyus](https://github.com/obviyus).
</details>
选择哪些内容成为长期记忆
在默认设置下,笔记不再仅仅因为 OpenClaw 在后台扫描中反复遇到它而成为长期记忆。它还必须出现在不同的记忆搜索中,这有助于避免临时笔记仅仅因为不断出现而被保存。更新后,一些较旧的笔记可能需要更长时间才符合条件,而已保存的记忆保持不变。
默认长期记忆选择会添加一个搜索使用信号。这是概念示意图,不是截图。之前保存的记忆保留。更新后,一些较旧的笔记可能需要更长时间才符合条件。
来源与完整变更列表
缺陷修复
- 要求自动记忆提升使用不同的回忆查询;具有
minUniqueQueries=0的配置保留其现有许可 #119624. 感谢 @pcpilot-dev, @RomneyDa, @sunnyandtec-ak, @zachisfine.
返回较早的对话
会话搜索 现在可以打开对话重置之前保存的消息,让你回到原始讨论,而不是空白页面。修复还有助于在 OpenClaw 缩短长对话后,让排队中的回复继续,以便你可以从上次中断处继续。
来源与完整变更列表
改进
- 减少长对话检查期间的临时内存 #143175.
缺陷修复
- 重置后打开保留的会话搜索结果 #141437. 感谢 @VACInc.
- 接受锚定会话历史请求中的冗余偏移量 #141664. 感谢 @FlagshipClaw, @obviyus, @VACInc, @brainatworkharris.
- 防止压缩和会话交接后丢失回复 #141718. 感谢 @VACInc.
- 避免为投递确认读取完整历史 #142453. 感谢 @VACInc, @todddickerson.
- 将记忆维护保持在对话上下文预算内 #143193. 感谢 @KirDE, @obviyus.
了解哪些内容被保存或遗忘
删除对话现在会告诉你其保存的历史何时仍可能出现在记忆搜索中,并显示遗忘这些记忆的命令。遗忘仍是一个单独的步骤,即使你远程删除了对话,也需要在托管 OpenClaw 的计算机上运行。
当自动记忆保存缺乏写入权限时,日志现在会指出无法保存的文件。它们还会解释更多 Active Memory 跳过搜索的原因,使缺失的记忆更容易排查。这些是更清晰的警告,因此报告的保存问题仍需关注。
来源与完整变更列表
缺陷修复
- 当记忆刷新无法写入目标文件时发出警告 #127031. 感谢 @ayaangazali, @fede-kamel, @vincentkoc.
- 在默认日志中显示选定的回忆跳过原因 #138658. 感谢 @DasX, @obviyus, @Oliverbot26.
- 在删除会话后解释记忆清理 #141841. 感谢 @glenn-agent, @obviyus, @dh-js, @he-yufeng.
- 在代理数据库繁忙时检查记忆就绪状态 #142361.
- 避免共享内存布局的不必要 Doctor 拒绝;保留已编辑的归档而不导入其更改,并推迟该工作区中后续事件生成 #143138.
文档
- 解释 Lossless Claw recall 的工具授权 [#142705](https://github.com/openclaw/openclaw/pull/142705)。感谢 [@MasterSwords1](https://github.com/MasterSwords1)、[@obviyus](https://github.com/obviyus)、[@guarismo](https://github.com/guarismo)。
- 将 Active Memory 指南拆分为任务特定页面 [#143057](https://github.com/openclaw/openclaw/pull/143057)。感谢 [@vincentkoc](https://github.com/vincentkoc)。
</details>
保持对话历史插件正常工作
如果你使用管理对话历史的插件,由于连接过早关闭,摘要不太可能失败。OpenClaw 还会避免在轮次开始时意外切换到备用插件。取消仍可在插件完成关闭其连接时停止对对话的进一步更改。
来源和完整变更列表
错误修复
使用其他工具添加的记忆
如果另一个工具向你的 LanceDB 记忆扩展 添加记忆,你的 Claw 可以在下次搜索时找到它们,而无需重启 OpenClaw。你无需先在 OpenClaw 内部做出更改,即可列出或删除这些新添加的记忆。
来源和完整变更列表
错误修复
文档
- 澄清 OpenClaw 主机版本
>=2026.5.31和插件 API>=2026.9.3的现有 LanceDB 要求,两者都必须通过 #142827。感谢 @obviyus、@ly85206559。
技能¶
技能为你的 Claw 提供可复用的指令,用于你们共同完成的工作。本次更新让它们更容易查找和配置,并让你能够观察和引导你的 Claw,当它基于过去的对话寻找改进技能的方式时。
同时搜索已安装技能和 ClawHub
技能页面 现在会同时搜索你已安装的技能与 ClawHub,这样你无需查看不同位置,就能看到已有内容和可添加内容。卡片会显示哪些技能已就绪或需要设置,切换代理会显示该代理可用的技能。你还可以在不输入搜索的情况下浏览热门技能,更清晰的标题和可读的描述让选择更容易。
实际的技能发现页面,填充了虚构的 Harbor 工作区技能。2026.9.4 发布的界面,使用虚构的 Harbor 数据;无实时任务执行。
来源和完整变更列表
改进
- 同时搜索已安装技能和 ClawHub #143758。感谢 @Patrick-Erichsen。
错误修复
- 在独立的执行工作区中查找仓库技能 #141966。感谢 @obviyus。
- 按实际标题显示和查找技能 #142535。
- 保持 ClawHub 详情和变更日志在对话框中可读 #142555。感谢 @vyctorbrzezowski。
导入、安装和阅读技能
导入技能时,你现在可以看到自己选择了哪些文件,并在继续前清除它们。技能窗口适配屏幕并保持“关闭”按钮触手可及,使较长的指令在手机上更容易阅读。需要更多时间下载或设置支持软件的安装也可以完成,而不会过早被中断。
来源和完整变更列表
改进
- 在技能导入期间显示并清除所选文件 #142540。感谢 @vyctorbrzezowski。
错误修复
- 使用紧凑的关闭控件使技能对话框适配内容 #142550。感谢 @vyctorbrzezowski。
- 允许较慢的 Control UI 技能依赖安装完成 #143000。感谢 @gozu、@obviyus。
在可见聊天中从过去的对话中学习
在 Skill Workshop 中选择“从过去的对话中学习”以打开一个聊天,你可以在其中跟踪工作、添加方向或停止它。Auto 让你的 Claw 根据发现的内容应用改进,而 Propose 会留下建议供你批准。你自己启动此功能不会开启自动自学习,正常的模型费用和访问权限仍然适用。
旧版未完成的历史扫描无法在新流程中恢复,因此请改为开始一个新的学习聊天。你已安装的技能以及现有提案仍会保持可用。Workshop 还会在自动每周审查因调度关闭而暂停时进行说明,并带你前往相应设置。
<details class="release-source-toggle">
<summary>来源和完整变更列表</summary>
**改进**
- 在可引导的聊天中从过往对话中学习 [#142909](https://github.com/openclaw/openclaw/pull/142909)。感谢 [@obviyus](https://github.com/obviyus)。
- 说明已暂停的每周技能审查 [#142840](https://github.com/openclaw/openclaw/pull/142840)。感谢 [@obviyus](https://github.com/obviyus)。
**缺陷修复**
- 为 Workshop 审查目标提供依据并恢复 Team Reports 列表 [#141575](https://github.com/openclaw/openclaw/pull/141575)。
**文档**
- 将 Skill Workshop 文档拆分为专题指南 [#143079](https://github.com/openclaw/openclaw/pull/143079)。感谢 [@vincentkoc](https://github.com/vincentkoc)。
</details>
保持当前技能说明可用
重启 OpenClaw 后,你可以在其下一轮继续现有对话,并使用已更新的本地技能文件。技能列表也能更可靠地获取新安装或已修复的文件。从托管库中选择的技能会保留你选择的版本,直到你刷新它们。
新的 Workshop 变更会保留完整描述,帮助你的 Claw 识别何时使用某个技能,而不是用简短的变更标签替换它们。这可以保护后续编辑,但不会恢复已经丢失的描述,也不会修复较早的待处理提案。
来源和完整变更列表
缺陷修复
- 在 Gateway 重启后刷新会话技能 #122110。感谢 @sappkevin, @obviyus, @kashivreddy, @aspalagin。
- 在 Workshop 更新中保留完整技能描述 #140864。感谢 @LiuwqGit, @obviyus, @XX441, @laisonamarante, @RuiCatalao7, @thomasmoenco。
- 在安装和编辑后刷新技能可用性 #141979。感谢 @RomneyDa。
- 在首次状态检查中显示已修复的技能 #142123。感谢 @ericcaiwx-star, @aspalagin, @obviyus。
- 明确代理在 Workshop 之外应如何执行请求的仓库技能编辑 #142844。感谢 @Finn763, @obviyus, @jmissig。
- 为沙箱插件代理提供可读的技能路径 #143291。感谢 @sallyom, @sercada, @Artemeey。
在云和远程计算机上使用技能
如果你的 Claw 运行在云计算机或 SSH 连接的计算机上,现在它在启动前复制技能所花费的时间更少,尤其是当你有大量小型技能文件时。云工作节点还可以使用同一本地技能内指令文件之间受支持的链接,因此你不必为了在该处让技能正常工作而重复这些文件。
来源和完整变更列表
改进
- 在远程轮次前批量传输技能 #142440。
缺陷修复
- 向云工作节点传递包含的技能文件别名 #143378。
更新后修复 Workshop 问题
Doctor 可以修复若干已知的 Workshop 问题,这些问题曾导致升级停止或阻止 OpenClaw 启动。当启动过程要求时,运行 openclaw doctor --fix。需要你识别其代理的提案和备份仍可供审查,同时其他修复继续进行。如果无法识别其代理,一些较早的审查历史可能会被丢弃,受影响的提案可能需要再次审查。
来源和完整变更列表
缺陷修复
- 使用 Doctor 修复旧版 Workshop 审查索引 1e7797ad9836。感谢 @jjjhenriksen, @RomneyDa。
- 在保留含义不明的 Workshop 工件的同时继续 Doctor 修复 #143141。感谢 @fahrenhe1t, @GitHoubi, @cjn119-ui, @obviyus。
- 修复已识别的未完成 Workshop 数据库升级 #143153。感谢 @syfvb, @pbergeot, @rjamoul, @cjn119-ui。
- 在 Doctor 预检期间忽略已退役的 Workshop 任务 #143325。感谢 @cjn119-ui, @jerabinovich, @obviyus。
替换已弃用的 video-frames 辅助工具
捆绑的 video-frames 技能及其辅助脚本已被移除。如果你使用它们从视频中保存静态图像,请改为直接使用 ffmpeg,或安装单独的帧提取技能。OpenClaw 的视频理解功能可以分析视频,但不会为你生成这些图像文件,现有工作流也不会自动转换。
来源和完整变更列表
限制和兼容性
- 移除捆绑的 video-frames 技能和辅助脚本 #142232.
原生应用¶
Android 应用可帮助你在阅读时保留位置,查看你的 Claw 已完成的操作,并从通知中回复。此外,还改进了移动应用重新连接的方式,修复了 Mac 设置问题,并增加了防止休眠的 Linux 桌面中断另一台计算机上 OpenClaw 的变更。
阅读 Android 对话并跟进工作
Android 应用 会在回复到达或你调整窗口大小时保留你的位置。你可以阅读较早的消息而不会被带离,然后使用“跳转到最新”来赶上进度。你还可以打开工具详情,查看你的 Claw 执行了哪些操作;同时,仪表盘聊天会收起已完成的步骤,并保留答案可见。
搜索和侧边栏会显示哪个对话正在忙碌,刷新失败时会保留你已加载的对话。在折叠屏手机上,模型设置和后台任务会避开折叠区域。
来源和完整变更列表
改进
Bug 修复
- 在回复增长时保持 Android 阅读位置,并显示展开的消息和代码端点 #140759.
- 显示 Android 会话刷新错误,同时不丢失已加载页面 #141603.
- 保持 Android 的 Thinking 和 Fast 控件避开折叠区域 #141860. 感谢 @vincentkoc.
- 线程活动标签跟随正确的对话 #141883.
- 保持后台任务位于可折叠窗格内 #141899. 感谢 @vincentkoc.
- 保持匹配的 Android 线程可见 #142046.
- 区分 Android 聊天就绪状态与 Gateway 断开连接 #142182.
- 保持 Android 分支选项位于可用的折叠窗格内 #142418. 感谢 @vincentkoc.
- 恢复 Android 工具活动并折叠已完成的工作 #142810. 感谢 @ansxor, @IWhatsskill.
- 区分 Android 聊天就绪状态与 Gateway 连接状态 #143128.
从 Android 通知中回复
Android 通知回复会在需要时重新连接到该对话保存的计算机。通知现在会告诉你回复是已排队、失败还是状态未知。已排队表示应用已保存你的回复以便发送;它不确认已送达。如果结果未知,请在再次发送前打开对话。在回复继续之前,你可能仍需要批准连接安全提示。
来源和完整变更列表
改进
- 翻译 Android 回复状态消息 #143928.
Bug 修复
- 保持通知操作在其已保存的 Gateway 上,明确回复状态,并保持已关闭的批准反馈为关闭状态 #143812.
发送 Android 附件及其说明文字
Android 会等待你选择的文件加载完成后再启用发送,因此你的消息不会只发送说明文字而没有附件。如果你取消某个文件或它加载失败,说明文字会保留在原位,以便你继续编辑。
来源和完整变更列表
Bug 修复
- 在发送说明文字前等待 Android 附件,并澄清导入警告 #143162.
重新连接移动应用
当 Android 或 iPhone 无法连接到运行 OpenClaw 的计算机时,应用现在会说明问题并提供重试。iPhone 会重试你正在设置的连接,而看似使用 Tailscale 的连接会显示相关设置帮助。Android 可能需要一点时间来关闭上一个连接,然后再尝试。
Android 设置还会使所选安全选项可供辅助功能工具使用。当你的 Claw 检查手机或 Apple Watch 电量时,结果现在会包含清晰的百分比,有助于避免将满电和 1% 混淆。
来源和完整变更列表
改进
- 刷新原生连接和恢复翻译 #142807.
Bug 修复
-
在移动状态响应中添加明确的电池百分比 #141069。感谢 @NullArbitrage、@obviyus。
- 向辅助服务公开 Android 连接安全选择 #142131。
- 显示移动连接失败并提供针对性重试操作 #142651。感谢 @vincentkoc。
查找官方移动应用
现在,你可以直接从 iPhone 设置指南 访问官方 App Store 列表。如果你在 Google Play 之外安装 Android,Android 指南 可帮助你找到应用下载并检查文件是否完整。下载文件会附加到特定版本,并且可能晚于版本本身出现。
来源和完整变更列表
文档
- 查找同时提供 APK 和校验和的 Android 版本下载 #141762。感谢 @xiaoguomeiyitian、@obviyus、@tomdailey55。
- 在其设置指南中链接官方 iPhone 应用 #142132。感谢 @mgabor3141、@obviyus。
了解 iPhone 会话数量
iPhone 应用现在会明确显示当前显示的会话数量以及总会话数量,包括其翻译后的消息。如果部分会话尚未加载,请使用“刷新”加载其余会话。
来源和完整变更列表
改进
设置和更改 Mac 连接
在 Mac 上选择“稍后设置”或清除连接后,该选择现在会保持保存,而不会在你重新打开应用时恢复旧连接。如果保存失败,应用会提示你。受密码保护的连接还会显示在哪里输入密码并重新尝试。另一台计算机上的旧版 OpenClaw 安装需要更新,才能接受在标记为 Gateway token 的字段中输入的密码。
如果你通过命令行准备 Mac 设置,现在可以从私有文件读取密码或 Token,而无需将其直接写入命令本身。设置还会尊重你选择的配置文件,而不是更改默认配置文件。远程设置指南 解释了这些选项,以及当应用已在运行时使用的单独命令。
来源和完整变更列表
错误修复
- 在 macOS 远程入门过程中显示密码恢复 #141857。
- 保留 Gateway 清除操作并接受基于文件的 macOS 设置凭据 #141872。
- 在离线远程设置中遵循所选 macOS 配置文件 #142163。
文档
使用 Command-W 关闭 Mac 侧边栏选项卡
当你在 Mac 应用中使用侧边栏选项卡时,Command-W 现在会关闭该选项卡并保持主窗口打开。你可以再次按下它来关闭下一个选项卡。如果你正在主聊天中操作,该快捷键仍会像往常一样关闭窗口。
来源和完整变更列表
错误修复
- 使用 Cmd+W 关闭聚焦的 macOS 侧边栏选项卡 #142634。感谢 @Patrick-Erichsen。
排查 Mac 启动和反复重启问题
如果 OpenClaw 在 Mac 上启动失败,其服务日志现在可以包含以前在正常日志记录开始之前消失的错误。现有安装需要刷新其后台服务设置,这些错误才会出现在日志中。Mac 故障排查指南 解释了设置以及查看位置。
Status 和 Doctor 还可以指出可能正在反复重启 OpenClaw 的后台任务。这些检查可能会错误地标记某个任务,因此在删除任何内容之前请先检查。
来源和完整变更列表
错误修复
- 诊断多余的 macOS Gateway 重启任务 #142230。感谢 @piotx、@rondavis007、@jodok、@jarvismazz。
- 在服务日志中保留 macOS Gateway 启动错误 #143519。感谢 @RomneyDa、@Enominera、@igs-rogenlo、@lonexreb。
保持 Linux 连接和更新正常工作
将 Linux 桌面设为睡眠状态不再会让另一台计算机上的 OpenClaw 暂停,包括通过 SSH 连接时。已保存的 SSH 连接也会使用其配置的端口。如果你将密码或 Token 保存在单独的文件或环境设置中,重新连接会保留该设置,以便后续启动可以读取更新后的密钥。被旧版本覆盖的设置仍需要手动恢复。
Linux 伴侣 也会在你使用仪表板时保持更新通知和托盘操作可用。如果后续检查或下载失败,已准备好安装的更新仍会保留,以便再次尝试。
<details class="release-source-toggle">
<summary>来源和完整变更列表</summary>
**缺陷修复**
- 保持桌面更新通知和重试操作可用 [#121938](https://github.com/openclaw/openclaw/pull/121938)。感谢 [@vincentkoc](https://github.com/vincentkoc)。
- 在 Linux 伴侣中支持 SSH 别名端口 [#142900](https://github.com/openclaw/openclaw/pull/142900)。感谢 [@vincentkoc](https://github.com/vincentkoc)。
- 防止 Linux 睡眠挂起远程 Gateway [#142913](https://github.com/openclaw/openclaw/pull/142913)。感谢 [@vincentkoc](https://github.com/vincentkoc)。
**安全与信任**
- 在 Linux 重新连接时保留远程凭据引用 [#142907](https://github.com/openclaw/openclaw/pull/142907)。感谢 [@vincentkoc](https://github.com/vincentkoc)。
**文档**
- 更正 Linux 伴侣成熟度描述 [#141955](https://github.com/openclaw/openclaw/pull/141955)。感谢 [@RomneyDa](https://github.com/RomneyDa)。
</details>
收听包含代码的解释
包含少量代码的解释现在可以被朗读出来,而不会被跳过或替换为提示查看屏幕的消息。当启用语音时,这适用于语音回复和Talk。以代码为主的答案仍遵循现有规则,将该内容保留在屏幕上。
来源和完整变更列表
缺陷修复
- 朗读普通 Markdown 解释,同时保留代码密集型回复回退 #142415。
模型与提供商¶
你在生成图像和转录语音备注方面有更多选择,选择你的 Claw 背后的模型也更容易了。模型菜单可搜索,已保存的选择会保留正确的设置,并且控件不再提供模型无法使用的选项。对于使用 Codex、Claude 或自有 AI 服务器的人,还修复了指令缺失、工作中断以及令人困惑的登录失败问题。
来自正确 Gateway 的模型列表
如果你连接到多个 Gateway,模型列表现在会跟随你选择的 Gateway 和代理,因此你可以看到工作将运行位置对应的选项。浏览列表不再在后台启动另一次模型搜索。刷新会检查新选项,刷新失败时会显示警告,同时保持兼容的已保存选项可用。在更新独立的命令行客户端之前,请先更新 Gateway。对 OpenClaw 的模型和价格参考的更新仍需要重启 Gateway 才能生效。
来源和完整变更列表
改进
- 浏览所选 Gateway 的模型清单 #142063。感谢 @obviyus。
- 减少首次使用 Copilot 元数据加载 #142134
- 在模型发现期间加载更少的会话代码 #143146。感谢 @vincentkoc。
- 浏览模型时避免未使用的准备工作 #144095
缺陷修复
- 在 Token 过期或冷却后刷新模型可用性 #141727。感谢 @obviyus。
- 显示刷新后的模型信息何时需要重启 #141885。感谢 @obviyus。
- 警告不完整的模型刷新 #141951。感谢 @obviyus。
- 将推理模型检查保持在代理目录内 #142367。感谢 @obviyus。
- 防止模型选择触发额外的提供商发现 #142375。感谢 @obviyus。
- 保持内部目录读取为被动,并转发显式刷新 #142557。感谢 @obviyus。
- 恢复公共 SDK 模型发现默认值 #142620。感谢 @obviyus。
- 当来源更改时清除过期的目录警告 #142622。感谢 @obviyus。
- 启动后保持已保存模型可见 #142766。感谢 @obviyus。
- 在冷会话重置期间避免加载无关提供商 #143254
- 通过异步读取保持模型目录资源 #143492
文档
- 澄清模型状态和目录刷新指南 #141927。感谢 @obviyus。
- 翻译模型刷新重试指南 #142000
- 修复模型指南中的 Gateway 目录链接 #142379。感谢 @vincentkoc。
保留你选择的模型
已保存的模型选择不太可能意外更改,尤其是当自定义模型名称几乎相同时。每个模型都会保留其自身的图像、工具和可处理文本量的设置。从另一个聊天启动的聊天也会显示它们实际继承的模型,并且选择 Default 在重启后仍会保持。Default 会跟随已配置的模型及其备份;显式选择某个特定模型会将聊天固定到该选择。
来源和完整变更列表
**Bug 修复** - 使子会话模型显示与路由保持一致 [#131805](https://github.com/openclaw/openclaw/pull/131805);上下文相关 [#86174](https://github.com/openclaw/openclaw/issues/86174)。感谢 [@jalehman](https://github.com/jalehman)、[@rqlangley](https://github.com/rqlangley)、[@wpu911](https://github.com/wpu911)。 - 在状态和权限中一致解析 Anthropic 别名 [#137376](https://github.com/openclaw/openclaw/pull/137376)。感谢 [@Yigtwxx](https://github.com/Yigtwxx)、[@obviyus](https://github.com/obviyus)。 - 在 /models 中尊重 CLI 支持模型的显式可见性策略 [#141642](https://github.com/openclaw/openclaw/pull/141642)。感谢 [@IWhatsskill](https://github.com/IWhatsskill)、[@NovaUnboundAi](https://github.com/NovaUnboundAi)。 - 使用所选提供商插件解析模型别名 [#141679](https://github.com/openclaw/openclaw/pull/141679) - 在模型目录命令中遵循所选 agent [#141859](https://github.com/openclaw/openclaw/pull/141859)。感谢 [@obviyus](https://github.com/obviyus)。 - 在终端选择前说明不可用模型 [#142160](https://github.com/openclaw/openclaw/pull/142160)。感谢 [@obviyus](https://github.com/obviyus)。 - 在目录中保持不同的模型 ID 和元数据可见 [#142285](https://github.com/openclaw/openclaw/pull/142285)。感谢 [@obviyus](https://github.com/obviyus)。 - 在各个会话视图中一致显示继承的模型 [#142751](https://github.com/openclaw/openclaw/pull/142751) - 当别名共存时优先使用精确模型元数据 [#143686](https://github.com/openclaw/openclaw/pull/143686) - 推断提供商时优先使用精确模型拼写 [#143708](https://github.com/openclaw/openclaw/pull/143708) - 保留目录模型标识和能力元数据 [#143777](https://github.com/openclaw/openclaw/pull/143777) - 保留不同的模型条目和元数据 [#143872](https://github.com/openclaw/openclaw/pull/143872) - 保持不同的允许模型可见 [#143954](https://github.com/openclaw/openclaw/pull/143954) - 在目录刷新过程中保留模型标识 [#143967](https://github.com/openclaw/openclaw/pull/143967) - 读取会话时保留已保存的模型选择 [#143975](https://github.com/openclaw/openclaw/pull/143975) - 保留所选模型及匹配的图像限制 [#143994](https://github.com/openclaw/openclaw/pull/143994)。感谢 [@elikampf](https://github.com/elikampf)。 - 仅解析一次已配置的别名 [#143999](https://github.com/openclaw/openclaw/pull/143999) - 使用所选模型的上下文限制 [#144009](https://github.com/openclaw/openclaw/pull/144009) - 使用所选模型的工具能力 [#144010](https://github.com/openclaw/openclaw/pull/144010) - 在默认项之前选择精确模型条目 [#144034](https://github.com/openclaw/openclaw/pull/144034) - 遵循所选模型的图像和压缩限制 [#144060](https://github.com/openclaw/openclaw/pull/144060) - 对工具使用所选提供商的设置 [#144107](https://github.com/openclaw/openclaw/pull/144107)查找模型并编辑备用选择
可搜索的模型菜单让长列表更易使用,在你选择结果之前不会更改你的选择。聊天菜单遵循为该对话保存的账户,而 New Session 允许你预览你拥有的另一个账户。如果列表加载失败,你可以看到问题并重试。
编辑备用模型现在会保留继承的主模型,并且删除所有备用项后,重新加载仍会保持该状态。不可用的已保存选择仍会显示,以便你将其移除。全局默认值标签有助于区分共享设置与单个 agent 的选择。
来源和完整变更列表
改进
Bug 修复
- 丢弃未确认的备用模型搜索 #141953。感谢 @shakkernerd。
- 编辑备用项时保留模型继承 #141967。感谢 @shakkernerd、@najef1979-code。
- 保留区分大小写的备用引用 #141997。感谢 @shakkernerd。
- 保持不可用的已保存模型可见但不可选择 #142048。感谢 @obviyus。
- 打开选择器时加载更多默认模型选择 #142105。感谢 @xiaoguomeiyitian、@obviyus、@dh-js。
- 在设置选择器中恢复模型发现 #142346。感谢 @vyctorbrzezowski。
- 在 Control UI 中显示失败的模型列表刷新 #142372。感谢 @obviyus。
- 重新打开设置选择器时避免重复模型发现 #142384。感谢 @vyctorbrzezowski。
- 减少大型目录中模型选择器的延迟 #142465
- 明确全局模型默认值和 agent 设置 #143424。感谢 @obviyus、@schjonhaug。
与模型匹配的 Thinking 和 Fast 控件
Thinking 菜单现在遵循所选模型提供的 effort 级别,因此不再凭空生成选项,并正确显示你保存的 Off 设置。当 OpenClaw 知道 Fast 无法更改请求时,它会禁用该选项,同时仍允许你清除旧偏好。这些控件使你可以调整的内容更清晰;实际速度、访问权限和费用仍取决于提供商。
来源与完整变更列表
Bug 修复
让自定义 AI 连接指向正确的服务器
使用自定义 AI 服务器的用户,在模型列表刷新时会保留其输入的连接设置,而不是被其他模型的设置覆盖。手动添加的模型也会保留在列表中。如果你使用自定义服务器替代提供商的常规服务,可能需要显式列出其支持的模型。集成必须使用当前登录信息或显式配置的凭据;仅随下载模型列表保存的旧凭据不再授权请求。
来源与完整变更列表
改进
- 在 Cloudflare AI Gateway、Featherless、Hugging Face、LongCat、Meta、Mistral、NVIDIA、Synthetic、Together、Xiaomi 按量付费和 Z.AI 的常规设置中排除生成的模型列表 #142202。感谢 @obviyus。
Bug 修复
- 遵循托管 OpenAI 和 Azure Responses 代理的会话亲和性设置 #141107;相关 #140918。感谢 @louisfy、@obviyus、@alexph-dev。
- 在生成目录刷新期间保留手动模型 #142302。感谢 @obviyus。
- 在已配置的模型列表中保留已保存的端点 #143643。感谢 @obviyus。
- 保留已编写的 SDK 路由,并要求使用当前身份验证,而不是生成目录凭据 #143664。感谢 @obviyus。
- 在别名之前遵循精确配置的模型设置 #143822
- 遵循合并后的提供商运行时设置 #143848
- 静默有意为之的提供商调优警告 #92288。感谢 @ai-hpc、@obviyus、@kingkong9817。
限制与兼容性
复用登录并从登录问题中恢复
受支持的 OpenAI 登录方法可以复用 Codex 已保存的账户或密钥,省去再次登录或粘贴。共享登录的 Agent 也能更可靠地处理续期,对于某次请求完成过晚的续期,可以帮助下一次请求成功。
如果登录仍需处理,OpenClaw 能更好地区分已保存的凭据和尚未获取它们的连接,并告诉你应检查哪台计算机。等待修复的旧凭据不再禁用无关提供商;请使用 openclaw doctor --fix 处理受影响的账户。
来源与完整变更列表
改进
Bug 修复
- 分别说明已保存凭据和失败的 Gateway 刷新 #131968;相关 #131944。感谢 @vyctorbrzezowski、@obviyus。
- 协调共享 OAuth 刷新,而不复用已消耗的 token #141477。感谢 @vincentkoc、@kopl-blip、@100yenadmin。
- 在模型发现期间识别带范围的 Codex 原生登录 #141759。感谢 @DonnieFi、@obviyus。
- 复用已完成的 Codex 登录刷新 #142628。感谢 @vincentkoc、@kopl-blip、@zhuyankarl、@100yenadmin。
- 保持 OpenAI、xAI 和 Copilot 设备登录链接在 Slack 中可点击 #142873。感谢 @obviyus。
- 在凭据迁移期间保持无关提供商可用 #143310。感谢 @tskerpnext。
- 在后台工作期间保持模型设置资源 #143542
- 保留模型身份验证证据中的大小写 #143780
恢复失败的工具请求并解释停止原因
当模型发送损坏的工具指令时,OpenClaw 可以重试,而不是立即放弃任务。对于 Anthropic,它还可以修复某些格式错误。重试仅限于重复请求安全的情况,且可能增加成本。如果之前的操作已经发生,请在要求你的 Claw 继续之前检查其结果。
错误还能更好地区分连接问题、被拒绝的登录以及提供商无法接受的请求。说明会保留在聊天历史中,便于理解工作为何停止或为何未尝试备用模型。
来源和完整变更列表
错误修复
- 在插件重新加载后刷新备用模型别名 0e1f60ec;上下文 #133633
- 保留最终 ChatGPT 事件,且无需结尾空行 #120902。感谢 @zenglingbiao、@obviyus。
- 停止重试包装后的参数拒绝 #140991;上下文 #140987。感谢 @ooiuuii、@obviyus。
- 修复已完成的 Anthropic 工具参数中的字符串编码 #141323;上下文 #135111。感谢 @lraesly、@1Vision365-PeterTijsma、@infocus13、@peterkaynie、@jalehman、@MaxVidkrytaklishnya、@chrislro、@narbs。
- 当模型回退时刷新终端页脚 #141436。感谢 @ooiuuii。
- 解释模型回退尝试停止的原因 #141658。感谢 @von8794、@obviyus。
- 在脱敏后显示具体的提供商网络错误 #141665。感谢 @SunnyShu0925、@obviyus、@DonnieFi。
- 修正回退警告并保留有意的静默回复 #141725。感谢 @leilei3167、@obviyus、@markthebest12。
- 在聊天历史中保留未完成的工具调用说明 #141870。感谢 @Takhoffman。
- 重试可安全重放的格式错误工具调用失败 #142176。感谢 @lraesly、@obviyus、@1Vision365-PeterTijsma、@peterkaynie、@infocus13、@MaxVidkrytaklishnya、@chrislro、@narbs。
- 解释终端超时后的回退停止 #142278。感谢 @MoerAI、@obviyus、@von8794。
- 在历史和状态中解释提供商身份验证和模型错误 #143243
在请求之间复用更多 Prompt
使用工具的 Anthropic 对话可以复用更多已处理的指令和对话文本,而无需反复保存同一份不断增长的历史记录。当你使用相同的指令和工具开始另一段对话时,兼容的本地模型也会获得更可复用的起始 Prompt。这可以避免重复处理,但对等待时间或费用的任何影响取决于提供商和工作负载。
来源和完整变更列表
错误修复
- 保留可复用的本地模型 Prompt 前缀 #137371;上下文 #137257。感谢 @gwiltschek、@obviyus。
- 在工具续接期间保留 Anthropic 缓存复用,并省略空的 thinking-disabled beta 请求头 #140621;上下文 #140607。感谢 @LightningWareLLC、@he-yufeng、@vincentkoc。
在 Codex 对话中保留工作区指令
由 OpenClaw 管理的 Codex 对话 重新获得工作区个性、偏好、技能和记忆指导,包括后续编辑。这适用于受支持的管理连接;其他连接类型保持现有处理方式,并可能显示警告。
普通 Codex 聊天也可以在长对话中完成工作后恢复缺失的最终答案,而无需重复这些操作。后续消息会保留新的更正,而不会重新发送已被成功最终回复覆盖的历史记录。
来源和完整变更列表
**Bug 修复** - 在受管理的 Codex 对话中恢复工作区指令 [#142276](https://github.com/openclaw/openclaw/pull/142276)。感谢 [@vincentkoc](https://github.com/vincentkoc)。 - 接受不带单独指令的 Codex Responses Lite 请求 [#142823](https://github.com/openclaw/openclaw/pull/142823)。感谢 [@jalehman](https://github.com/jalehman)。 - 遵循已配置的 Codex 工作区指令限制 [#142932](https://github.com/openclaw/openclaw/pull/142932)。感谢 [@ashawwal](https://github.com/ashawwal)、[@obviyus](https://github.com/obviyus)。 - 在长 Codex 对话中,于工具操作后恢复最终答案 [#143081](https://github.com/openclaw/openclaw/pull/143081)。感谢 [@barbarhan](https://github.com/barbarhan)、[@obviyus](https://github.com/obviyus)。 - 避免在最终消息投递后重复 Codex 历史 [#143506](https://github.com/openclaw/openclaw/pull/143506)。感谢 [@sunlit-deng](https://github.com/sunlit-deng)、[@dbarbatti](https://github.com/dbarbatti)、[@obviyus](https://github.com/obviyus)。 **文档** - 按主题拆分 Codex harness 参考 [#142803](https://github.com/openclaw/openclaw/pull/142803)。感谢 [@vincentkoc](https://github.com/vincentkoc)。 - 将 Codex 运行时指南拆分为聚焦页面 [#143458](https://github.com/openclaw/openclaw/pull/143458)。感谢 [@vincentkoc](https://github.com/vincentkoc)。返回 Claude 及其他编码代理对话
返回 Claude 对话时会保留其原始聊天连接,并在受影响的恢复场景中避免重复的用户消息。当技能检查发现没有变化时,Claude 也可以在轮次之间保持运行。在固定模型选择的 Codex 聊天中,粘贴的文本现在会到达代理,而不会丢失。
来源和完整变更列表
改进
- 减少 Anthropic CLI 历史的冷启动设置 #142801
Bug 修复
- 在合并重复历史时保留 Claude 会话身份 #130494;上下文 #130456。感谢 @jalehman。
- 完成没有字段的有效 ACP 表单 #133269。感谢 @xydt-juyaohui、@obviyus。
- 在时钟变化期间保持 ACP 启动等待一致 #137303。感谢 @qingminglong、@obviyus。
- 将生效的 Fast 设置转发给 CLI 插件,并保留所选账户 #138667。感谢 @Szqub、@obviyus。
- 在时钟校正期间保持 Codex 操作超时稳定 #141071;上下文 #141000。感谢 @ooiuuii、@obviyus。
- 在模型锁定的 Codex 会话中恢复粘贴文本 #142021。感谢 @RomneyDa。
- 避免在 Claude 恢复后出现重复的用户轮次 #143960。感谢 @Marvinthebored、@Peetiegonzalez、@obviyus。
文档
- 按任务拆分 ACP 指南 #142958。感谢 @vincentkoc。
为本地模型使用正确的对话限制
如果你在自有服务器上运行模型,OpenClaw 现在会使用 vLLM、SGLang 及兼容服务报告的对话大小,而不是回退到可能错误的限制。这有助于它规划发送给模型的文本量,而你自行输入的任何限制仍然优先。首次打开 vLLM 模型信息时,也会避免一些不必要的加载工作。
来源和完整变更列表
Bug 修复
- 为自托管模型使用已声明的上下文限制 #141113。感谢 @vincentkoc。
- 避免首次使用 vLLM 模型信息时的不必要加载 #142125
文档
- 将 Ollama 文档整理为聚焦指南 #143004。感谢 @vincentkoc。
试用腾讯 Hy4 预览
腾讯用户可以通过 TokenHub 或 TokenPlan 选择 Hy4 预览,并且当账户有访问权限时,新设置会默认选择它。现有模型选择保持不变,因此升级不会悄悄将你切换到预览版。其思考选项为 Off 或 High;选择 Low 等中间级别会使用 High,这可能会影响等待时间和用量。
来源和完整变更列表
改进
Grok 4.6 成为新设置的默认选项
新的 xAI 设置会使用 Grok 4.6;如果你未为 xAI 网络搜索、X 搜索和代码执行工具选择模型,它们也会使用 Grok 4.6。你的明确选择保持不变,但新的工具默认值可能会改变你账户的成本或可用性。如果较旧的订阅设置仍在使用已退役的 Auto 选项,请运行 openclaw doctor --fix 或自行选择一个可用模型。
来源和完整变更列表
**限制和兼容性** - 使用 Grok 4.6 默认设置,并修复已退役的订阅自动选择 [#142136](https://github.com/openclaw/openclaw/pull/142136)。感谢 [@obviyus](https://github.com/obviyus)。发起一次性 OpenCode 请求
在持续对话之外发起的 OpenCode Go 和 Zen 请求,不再仅仅因为服务需要缺失的会话信息而失败。对于受支持的直接连接,OpenClaw 会自动提供该信息,包括来自命令行和受支持集成的请求。自定义服务器连接保留其现有要求。
来源和完整变更列表
错误修复
- 为无会话的 OpenCode Go 调用提供路由标识 #143558。感谢 @RomneyDa。
- 为独立的 OpenCode 补全提供路由标识 #143659。感谢 @HAPPYFAPTAIN、@obviyus、@GDXbsv、@spectrl。
- 在使用显式 OpenCode 会话时保留路由 #143890。感谢 @vincentkoc。
使用已保存的 OpenRouter 账户配合 Arcee
如果你通过 OpenRouter 使用 Arcee,OpenClaw 现在会使用与你匹配的已保存 OpenRouter 账户,而不是要求提供单独的 Arcee 凭据。你的模型设置会保持与该选择关联,同一个 Arcee 模型的不同拼写也不会再看起来像意外的模型切换。
来源和完整变更列表
错误修复
区分 Kimi 配额限制和无效密钥
当 Kimi 明确报告你已用完每周额度时,OpenClaw 不再将你的有效密钥视为损坏。它可以尝试已配置的备用方案,而不会不必要地阻止该提供商的其他模型。不过,更改密钥不会恢复额度;请等待 Kimi 的配额窗口,或使用另一个有可用容量的提供商。
来源和完整变更列表
错误修复
- 将明确的 Kimi 配额失败视为速率限制 #142656。感谢 @RileyJJY、@obviyus、@rico007、@shaozhengkun123。
使用 GPT Image 2.5 生成和编辑
你可以通过 OpenAI 或 fal 使用 GPT Image 2.5 Flare 或 Sunburst 生成和编辑图像,包括自定义尺寸、更高质量设置以及透明 PNG 或 WebP 输出。编辑可以通过 OpenAI 使用最多五张参考图像,或通过 fal 使用最多十六张,并且任一通道都可以返回最多四张图像。
直接 OpenAI 访问 需要 API 密钥;如果你已经使用 ChatGPT 登录,则需显式选择该密钥;fal 需要其自己的凭据。你的默认图像模型保持不变,因此当你想使用时,请选择其中一个新变体。
GPT Image 2.5 Flare 和 Sunburst 的生成或编辑。概念性插图,不是截图。任一通道都可以返回最多 4 张图像。默认保持不变;未显示生成的提供商输出。
来源和完整变更列表
改进
- 通过 OpenAI 添加 GPT Image 2.5 Flare 和 Sunburst #143068。感谢 @vincentkoc。
- 通过 fal 添加 GPT Image 2.5,支持 16 张参考图像编辑 #143069。感谢 @vincentkoc。
使用 Deepgram Flux 将语音留言转换为文本
你现在可以选择 Deepgram Flux 将传入的语音留言转换为你 Claw 可以使用的文本,提供英语和多语言选项。在选择 Flux 之前,请在运行 OpenClaw 的计算机上安装 ffmpeg。这是现有音频设置中的一个可选项;Nova 仍然是默认选项。
来源和完整变更列表
改进
- 使用 Deepgram Flux 转录语音留言 #141836。感谢 @obviyus、@safzanpirani。
使用 Gemini 3.6 Flash 进行网络搜索
Gemini 网络搜索现在使用 Gemini 3.6 Flash,除非你选择了特定的搜索模型,这有助于那些无法再使用旧默认设置的账户。你的主聊天模型保持不变。升级时请检查计费差异,因为 Gemini 3 按每个搜索查询收费,而不是每个 Prompt 收费一次。此外,还有更清晰的帮助,用于设置 Kimi 搜索以及使用 Ollama 云搜索同时保持模型对话本地。
来源和完整变更列表
**改进** - 为未配置的网页搜索使用 Gemini 3.6 Flash [#111964](https://github.com/openclaw/openclaw/pull/111964); 上下文 [#96974](https://github.com/openclaw/openclaw/issues/96974)。感谢 [@dillona](https://github.com/dillona)、[@vincentkoc](https://github.com/vincentkoc)、[@anguslogan01](https://github.com/anguslogan01)。 **文档** - 记录搜索插件的安装和重启、本地 Ollama 模型路由、浏览器端口、可选 jq、/tell、补丁语法、审批检查、节点选择、反应以及屏幕可用性 [#143856](https://github.com/openclaw/openclaw/pull/143856)。感谢 [@vincentkoc](https://github.com/vincentkoc)。以更清晰的估算读取用量成本
成本报告现在会在总计可能仍不完整时发出警告,因此临时零值不太可能看起来像没有用量。它们还将用于保存可复用 prompt 的 token 与普通输入区分开来,并填补某些 OpenRouter 估算中的缺口。这些是报告修复;提供商的账单仍是你实际应付的金额。
来源和完整变更列表
错误修复
无需等待诊断即可获取模型结果
启用诊断记录后,OpenRouter 可以在不等待记录完成的情况下返回已完成的音乐或用量检查错误。即使该可选记录不完整,你也能更早获得结果。相关修复让已停止的请求能够完成关闭其连接,而不会中断清理。
如果你直接从终端运行 openclaw models status --probe,请先停止 Gateway,并等待命令退出后再重新启动它。结果可能在检查仍在关闭其文件和连接时出现。
来源和完整变更列表
错误修复
找到你需要的提供商说明
在重新整理的 OpenAI 和 模型提供商指南 中,设置账户或查看提供商选项变得更加容易。更短的页面会直接带你到相关说明,旧书签仍会指向已移动的内容。
来源和完整变更列表
文档
- 将 OpenAI 指南整理为聚焦的任务页面 #141224。感谢 @vincentkoc。
- 按设置任务整理模型提供商文档 #143058。感谢 @vincentkoc。
自动化与调度¶
自动化更易于管理,提供直接编辑它们的链接以及可识别的名称。计划任务也获得了针对卡住、将结果返回到你的聊天,以及在无内容可报告时保持静默的修复。
使用你选择的工具运行计划任务
由 OpenClaw 运行的计划命令可以在不关闭密钥保护的情况下工作,Codex 聊天可以使用对话中已可用的工具设置自动化。任务还会避免因模型设置刷新或不相关插件被禁用而导致的启动失败。你现有的权限仍然适用,禁用的插件保持关闭。
来源和完整变更列表
错误修复
修复卡住的定时任务
定时任务之间的冲突可能导致 OpenClaw 不断重试,直到停止响应。该循环已修复。将工作交给另一个代理的任务也会避免一种无法恢复的暂停,由 OpenClaw 通过任务的现有设置交付结果。
来源和完整变更列表
Bug 修复
- 防止定时代理进入无法恢复的 yield #135318。感谢 @LiuwqGit、@obviyus、@youens、@postoso、@BottaniCals。
- 停止停滞的定时任务预留循环,并在数据库打开失败后清理资源 #142741。感谢 @galiniliev。
后台结果与静默检查
后台命令可以在你的 Claw 先前的回复结束后,将结果带回聊天。没有可报告内容的例行检查可以保持静默,而不是发送不必要的消息。
当自动化结果正在等待,而你的 Claw 正在回复你时,取消该结果现在可以解除诸如固定对话等操作。你的 Claw 可以完成回复,而不会将已取消的结果添加到聊天中。
来源和完整变更列表
Bug 修复
查找和编辑自动化
你可以从 设置 → 代理 → 自动化 直接跳转到自动化的编辑器,即使任务已暂停。列表现在会显示你保存的友好名称,并且你可以将定时对话分组在一起,以便更容易找到。大型自动化列表在加载结果将发送到的位置时也会花费更少的时间。
如果你通过命令行管理自动化,缺失的任务和无效选项会提供更实用的指导。警告还会解释当已保存的任务因调度关闭而无法运行时,应检查哪些内容。
来源和完整变更列表
改进
- 直接从代理的设置中编辑自动化 #139782。感谢 @jjjhenriksen、@vyctorbrzezowski。
- 当启用诊断时,解释加载自动化列表所花费的时间 #141805。
Bug 修复
每日重置与自动化指南
如果你已设置对话每天重置,它们现在会避免在春季时钟调整期间过早丢失上下文。重置仍然遵循运行 OpenClaw 的计算机的时区。
当你想要在指定时间或命令完成时启动任务,或使用 hook 为事件设置自动响应时,指南更容易找到。这些指南解释现有功能,并提供更清晰的说明,用于选择和设置它们。
来源和完整变更列表
Bug 修复
- 防止在夏令时调整附近过早进行每日重置 #142482。
文档
- 记录所有自动化调度类型和选项约束 #135964。感谢 @qingminglong、@obviyus。
- 将 hooks 指南拆分为聚焦的参考页面 #143041。感谢 @vincentkoc。
- 澄清没有原生的 WebSocket 调度源,且旧版
cron.failureDestination设置不会被直接读取 #144039。感谢 @vincentkoc。
浏览器与计算机使用¶
你可以继续在自己的浏览器中操作,同时你的 Claw 在另一个标签页中工作,而在远程桌面上加入它所需步骤更少。此版本修复了在打开窗口、响应网站弹出窗口以及跟随另一台计算机上的工作时出现的中断。
在不切换标签页的情况下跟踪浏览器操作
浏览器面板 可以在不将你从自己的标签页切换走的情况下,显示你的 Claw 正在做什么。你仍然可以选择 Open 将其页面置于前台。如果实时视图在启动后断开连接,OpenClaw 会刷新画面并尝试自动重新连接,同时保留你正在标注的图像位置不变。空白页面也不会再在聊天中显示为具有误导性的预览卡片。
来源和完整变更列表
Bug 修复
- 在自动面板更新期间保持浏览器焦点 5c70585。感谢 @scotthuang。
- 在流断开后恢复浏览器面板 #141576。感谢 @safzanpirani、@obviyus。一个已打开但从未发送其第一帧的连接仍不在此修复范围内。
- 隐藏空白和内部浏览器页面的预览卡片 #142213。感谢 @vyctorbrzezowski。
文档
- 将浏览器文档拆分为聚焦指南 #142984。感谢 @vincentkoc。
处理网站弹出窗口和更长的任务
当网站弹出窗口中断 浏览器命令 时,OpenClaw 会告诉你哪个提示需要回答,以及哪些步骤尚未完成。回答一个弹出窗口后,也不会再阻止回答下一个弹出窗口。在已打开的浏览器中执行更长的任务时,可避免这些修复所涵盖的过早连接失败。
取消无法撤销已经对页面所做的更改。如果你自动化浏览器命令,请在继续之前检查其报告的结果,因为被阻止的任务并不总是返回错误状态。
来源和完整变更列表
Bug 修复
限制与兼容性
- 拒绝无效的 Browser CLI 鼠标按钮值 #140976。感谢 @WOLIKIMCHENG、@DilapidatedDolphin98、@obviyus。提供的值必须恰好为
left、right或middle。
找到你的 Claw 所需的窗口
本次发布修复了 computer-use 错误,这些错误可能会在 Claw 找到正确窗口之前使其停止。受支持的桌面控制从一开始即可用,并且当窗口前置操作成功时,不再看起来像失败。你的 Claw 仍需要权限才能使用计算机,并且计算机必须支持其请求的控制。
如果 Codex Computer Use 因原生插件被禁用而无法启动,现在它会及时说明这一点,并告诉你如何启用它们并重试安装。
来源和完整变更列表
Bug 修复
- 当原生 Codex 插件被禁用时跳过发现等待 #137485。感谢 @shojikumaru、@noelillinger、@obviyus。
- 使受支持的配对桌面操作在首次调用时可用 #141277。感谢 @oywino、@obviyus。现有的视觉和权限限制仍然适用。
- 修复首次操作 CUA 窗口发现 #143736。
- 修复激活结果和目标捕获指导 #143953。窗口输入使用
get_window_state带includeScreenshot返回的observationId,而不是整个桌面帧引用。
打开远程桌面并粘贴文本
从聊天中打开 Desktop 现在会带你到运行该聊天的计算机,并且当你在旁边的另一个窗格中输入时,视图会保持连接。必须启用 Desktop 支持,并且你从观看开始,直到选择 Take control。
要从你自己的计算机粘贴文本,请选择 Take control,打开 Keyboard,并在连接就绪后在那里粘贴。直接在桌面视图上使用的粘贴快捷键会发送到远程计算机。如果其他人接管控制,通知现在会在可用时显示其登录名称或用户 ID。
来源和完整变更列表
改进
- 显示谁接管了共享桌面 #143828。
Bug 修复
在开始下一个会话之前关闭计算机会话
在已连接的计算机上停止 OpenClaw 现在会允许其活动的 computer-use 会话在另一个会话开始之前完成关闭。如果关闭失败,错误会保持可见,以便你知道为什么新会话被阻止以及需要关注什么。
来源和完整变更列表
**Bug 修复** - 在节点关闭前等待计算机会话关闭 [#142787](https://github.com/openclaw/openclaw/pull/142787).在 Azure 云工作器上打开桌面
现在你可以为 Azure 云工作器 启用桌面访问,无论 OpenClaw 是直接管理它们,还是通过协调器管理。打开 Cloud Worker Desktop 实验室,并在工作器配置文件中启用桌面访问。在未启用桌面的情况下创建的现有工作器需要停止,并在启用该设置后重新设置。这会将 Azure 添加到受支持的桌面选项中;GCP 桌面仍不受支持。
来源和完整变更列表
改进
- 移除冗余的云桌面启动请求 #142172.
Bug 修复
- 为 Azure 云工作器启用桌面访问 #141895.
文档
- 更新已翻译的 Azure 桌面指南 #141909.
插件和集成¶
为你的 Claw 发现新内容更容易了,无论是浏览插件还是在聊天中请求推荐。你可以在浏览器中审查和设置插件,同时云工作器获得了复用项目设置、为下一次会话保持计算机就绪,以及在提供商支持时选择 Windows 或 macOS 的方式。
浏览插件并从聊天中打开推荐
现在你可以一起搜索已安装和可用的插件,按用途浏览,并无需点击多个页面即可继续探索。在聊天中,你的 Claw 可以推荐最多三个官方插件或技能,并给你一个可以打开其详情的卡片。推荐需要启用消息工具,选择 Install 会在添加任何内容之前打开审核。已安装的插件在你使用之前可能仍需要设置或账户连接。
来源和完整变更列表
改进
- 在 Web UI 中浏览和筛选 ClawHub 插件 #137659 — 感谢 @Patrick-Erichsen.
- 在详情页面中查看插件文档和兼容性 #137846 — 感谢 @Patrick-Erichsen.
- 在发现中包含本地插件和本地支持的详情 #137856 — 感谢 @Patrick-Erichsen.
- 统一内置插件和 ClawHub 插件浏览 #138755 — 感谢 @Patrick-Erichsen.
- 添加由 Gateway 支持的 ClawHub 目录发现 #139042 — 感谢 @Patrick-Erichsen.
- 复用已准备的插件目录元数据 #142500
- 在插件发现中使用包类别 #142711 — 感谢 @Patrick-Erichsen.
- 按用途分组已安装插件 #142712 — 感谢 @Patrick-Erichsen.
- 统一插件浏览并添加 ClawHub 聊天卡片 #142782 — 感谢 @Patrick-Erichsen.
- 自动加载插件目录页面 #143731 — 感谢 @Patrick-Erichsen.
- 为内置通道加载更少的未使用代码 #143846
限制与兼容性
- 声明有序的插件类别 #142710 — 感谢 @Patrick-Erichsen.
Bug 修复
- 将已安装插件匹配到正确的 ClawHub 注册表 #143644
- 修正插件排名、内置身份和技能名称 #143730 — 感谢 @Patrick-Erichsen.
在浏览器中审查和设置插件
你可以阅读插件的功能,检查它需要什么,并在不离开浏览器的情况下跟踪安装直至设置完成。插件设置将其配置、权限和故障排除信息集中在一起,并在设置未完成时显示更清晰的消息。安装对话框会保留你最新的选择,并在确认完成之前等待所需的重启。安装或更改插件仍然需要相应的权限和你的同意。
来源和完整变更列表
改进
- 在插件工作区中浏览和搜索已安装插件 #135839 — 感谢 @Patrick-Erichsen.
- 在专用设置页面中管理已安装插件 #135840 — 感谢 @Patrick-Erichsen.
- 从插件详情页面安装和配置插件 #137886 — 感谢 @Patrick-Erichsen.
- 将已安装插件详情组织为选项卡 #142713 — 感谢 @Patrick-Erichsen.
错误修复
- 明确插件设置状态和软件包图标 [#142624](https://github.com/openclaw/openclaw/pull/142624) — 感谢 [@Patrick-Erichsen](https://github.com/Patrick-Erichsen), [@jalehman](https://github.com/jalehman).
- 更正插件能力同意被拒绝后的恢复命令 [#143125](https://github.com/openclaw/openclaw/pull/143125) — 感谢 [@liuwqgit](https://github.com/liuwqgit), [@obviyus](https://github.com/obviyus), [@yxloveql](https://github.com/yxloveql).
- 保持插件选择和安装进度为最新 [#143671](https://github.com/openclaw/openclaw/pull/143671)
</details>
插件命令失败时获取有用的帮助
如果你从终端管理插件,错误消息 现在会指向你的配置文件或容器的恢复命令,并说明你是否需要重启 OpenClaw。插件检查也会报告清理失败,而不是声称成功,并且缓慢的目录响应不再让命令无限期等待。
来源和完整变更列表
错误修复
- 为 ClawHub 元数据和错误响应强制设置截止时间 #109092 — 感谢 @Pick-cat, @obviyus.
- 在插件恢复命令中保留配置文件和容器上下文 #117631
- 在报告检查成功之前释放插件资源 #141780
- 在回复之前关闭聊天插件检查资源 #141819
- 在报告完成之前释放 Plugin Doctor 资源 #141845
- 在插件检查后关闭 Workboard 连接 #141858
- 恢复已加载插件的通知 #141930
- 明确安装插件后的重启要求 #142129 — 感谢 @WOLIKIMCHENG, @obviyus, @dh-js.
- 在诊断中识别已更改的插件注册表记录 #142192
- 在清理完成后释放插件 CLI 资源 #142388
- 在插件注册清理期间保持资源存活 #142636
- 为开发路径安装保留捆绑插件的信任 #143516 — 感谢 @RomneyDa.
- 准确报告受支持的捆绑钩子布局 #143687
文档
- 按任务拆分插件 CLI 参考 #142980 — 感谢 @vincentkoc.
- 明确默认插件软件包解析 #143867 — 感谢 @vincentkoc.
改进
- 在插件摘要表中跳过未使用的安装详情处理 #143105
构建并预览你自己的插件
构建插件的用户将获得针对类型错误和缺失支持文件的修复,这些问题可能会阻止构建。你还可以选择启用浏览器中的实时预览,查看你的插件相对于真实 OpenClaw 安装的变化。如果你封装了多账户配置助手,请在重新构建时检查其更新后的类型;SDK 指南 涵盖开发设置。
来源和完整变更列表
文档
- 在 SDK 目录中记录私有补全助手 #111706 — 感谢 @xydt-tanshanshan, @obviyus, @chegherian.
- 将提供商 SDK 指南拆分为聚焦参考 #141958 — 感谢 @vincentkoc.
- 按任务组织插件钩子指南 #142605 — 感谢 @vincentkoc.
- 将 SDK 迁移指南拆分为聚焦页面 #142607 — 感谢 @vincentkoc.
- 将 SDK 概览组织为聚焦参考 #142641 — 感谢 @vincentkoc.
- 将通道 SDK 指南拆分为聚焦参考 #142703 — 感谢 @vincentkoc.
- 将插件架构拆分为聚焦指南 #142730 — 感谢 @vincentkoc.
- 将 agent-harness SDK 参考拆分为聚焦页面 #142889 — 感谢 @vincentkoc.
- 将插件入口点文档拆分为聚焦参考 #143151 — 感谢 @vincentkoc.
- 更正插件示例和能力指南 #143857 — 感谢 @vincentkoc.
- 更正提供商目录和 Claude 捆绑指南 #143895 — 感谢 @vincentkoc.
- 明确插件迁移历史和示例 #143982 — 感谢 @vincentkoc.
限制与兼容性
- 暴露实际的 catchall 多账户 schema 类型 [#141796](https://github.com/openclaw/openclaw/pull/141796) — 感谢 [@RomneyDa](https://github.com/RomneyDa)。
**缺陷修复**
- 接受接口类型的入站 hook 上下文 [#141934](https://github.com/openclaw/openclaw/pull/141934) — 感谢 [@RomneyDa](https://github.com/RomneyDa)。
- 对同级检出插件使用正在运行的 Gateway SDK [#142508](https://github.com/openclaw/openclaw/pull/142508)
- 在未跟踪的 source-plugin 构建中包含已声明的资源 [#142527](https://github.com/openclaw/openclaw/pull/142527)
**改进**
- 针对真实 Gateway 开发 Control UI 插件并支持热重载 [#143052](https://github.com/openclaw/openclaw/pull/143052) — 感谢 [@shakkernerd](https://github.com/shakkernerd)。
</details>
防止插件请求过早停止
使用模型插件的请求不太可能因为工作仍在完成时连接关闭而失败。OpenClaw 会在取消、插件重载和关闭期间保持这些连接可用。无法完成关闭的插件仍可能延迟关闭。
来源与完整变更列表
缺陷修复
- 停止通告已退役的 native-hook 中继端点 #141608
- 在插件完成期间保持模型状态存活 #141938
- 在取消清理期间保留插件模型资源 #142197
- 在重载清理期间保留插件资源 #142519
- 在主机清理期间保留 provider 资源 #142838
- 在列出工具时保留 provider 上下文 #142896
- 模型检查完成后释放临时插件资源 #143109
- 在请求清理期间保持本地模型资源 #143302
- 工具被取消时保留插件身份 #143305
- 在清理期间保持隔离的模型调用存活 #143414
- 修复从 CLI 列出运行时特定环境的问题 #143446 — 感谢 @jalehman。
- 在延迟代理清理期间保留插件资源 #143490
- 代理工作完成后释放模型选定的插件资源 #143725
文档
- 将工具配置引用拆分为专题页面 #142960 — 感谢 @vincentkoc。
改进
- 选择插件 provider 时减少重复检查 #143091
限制与兼容性
- 在主机工作完成前保留插件准备好的模型 #143270
完成创建并保存图像、音乐和视频
图像、音乐和视频任务即使启动它们的插件配置被替换,也可以完成并保存其结果。相关修复使语音和文档分析的连接保持可用,并防止流式音频的最后部分丢失。已开始的付费生成在你取消后可能继续。
来源与完整变更列表
缺陷修复
- 从媒体下载错误中移除错误的空 body 说明 #141674
- 生成完成后关闭音乐插件资源 #142834
- 在生成完成前保留图像插件资源 #142843
- 在生成完成前保留视频插件资源 #142876
- 在 provider 清理期间保持已接受的图像任务存活 #142991
- 在保存和清理期间保持音乐任务存活 #143060
- 在合成和清理期间保持电话语音 provider 存活 #143065
- 在后台任务完成前保持视频 provider 可用 #143260
- 在合成和清理期间保持语音资源 #143313
- 在流清理期间保持语音 provider #143369
- 在清理期间保持图像 provider 资源 #143403
- 在取消清理期间保持 PDF provider 资源 #143460
- 在主机关闭前保持已准备的语音设置可用 #143493
- 在媒体任务清理期间保持插件资源 #143530
- 在清理期间保留受管理的语音摘要资源 #143627
- 为多张图像保留插件图像处理器 #143717
文档
- 按任务组织文本转语音文档 #142992 — 感谢 @vincentkoc。
为插件数据使用更少的额外内存
拥有大量已保存数据的插件在列出这些数据时使用更少的额外内存,有助于减轻大型集合带来的压力。在存储更新后的首次使用可能需要额外时间和磁盘空间。
来源和完整变更列表
改进
- 在 plugin-state 配额检查期间减少数据库读取 #142318
- 列出插件状态时减少临时内存 #142568 — 感谢 @arcabotai。
Bug 修复
处理大型工具回复和断开连接
如果你通过 MCP 连接外部工具,来自已连接设备的大型文本回复不再包含不必要的重复副本。停止独立 MCP 服务会为正在进行的工具工作留出时间完成清理,且已接受的断开连接不再卡在等待响应清理。失败的断开连接仍会报告可能需要关注的问题。
来源和完整变更列表
Bug 修复
- 完成 MCP 清理,而无需等待停滞的取消 #141289 — 感谢 @hugenshen, @obviyus。
- 在释放资源前等待 MCP 工具清理 #142632
- 在关机清理期间保持 MCP 插件资源可用 #143031
改进
- 从节点托管的 MCP 快照中移除重复文本 #142518
文档
- 按任务拆分 MCP 文档 #142995 — 感谢 @vincentkoc。
为已连接设备使用准确的时间限制
在已连接设备上的命令不再仅仅因为系统时钟变化而过早超时或等待更久。唤醒设备所花费的时间与运行命令计入同一限制。如果你使用脚本,并希望使用默认值,请省略数值选项——现在传入空值会在 OpenClaw 联系设备之前给出明确错误。
来源和完整变更列表
Bug 修复
- 在时钟变化期间保持节点命令超时稳定 #137147 — 感谢 @qingminglong, @obviyus。
限制与兼容性
文档
- 按任务拆分 Nodes 文档 #142779 — 感谢 @vincentkoc。
在 Google Meet 中从单独代理获取答案
Google Meet 和语音会话现在即使原始对话有锁定的模型选择,也可以向单独配置的代理寻求帮助。该代理使用自己的对话,而不会复制你之前的聊天,且其自身的模型限制仍然适用。失败的 Chrome 会议启动也会尝试停止其打开的音频,并只关闭新创建的标签页,而不影响你现有的标签页。
来源和完整变更列表
文档
- 按任务组织 Google Meet 指南 #142729 — 感谢 @vincentkoc。
Bug 修复
- 允许从模型锁定会话咨询单独代理 #142736 — 感谢 @RileyJJY, @jai-assistant, @jalehman。
- 在 Chrome 启动失败后清理 Google Meet 音频 #143408
将 A2A 工作发送到你选择的代理
如果你使用 A2A 连接代理,即使新对话开始,传入请求现在也会到达分配给该连接的代理。你仍可以为特定对话选择不同的代理,且不同对话保留各自的历史。
来源和完整变更列表
Bug 修复
- 遵守 A2A 对等代理绑定 #142485 — 感谢 @eleqtrizit。
当答案被截断时通知已连接的应用
通过 Chat Completions 或 Responses API 使用 OpenClaw 的应用现在可以判断答案是否因达到输出限制而停止。它们会保留部分答案,并收到一个明确信号表示答案被截断,包括在流式传输期间,从而可以决定接下来显示或执行什么。已连接的应用还会获得更准确的报告,说明配置更新后哪些设置发生了变化。
来源和完整变更列表
错误修复
- 准确报告输出受限的 Chat Completions [#141268](https://github.com/openclaw/openclaw/pull/141268) — 感谢 [@ooiuuii](https://github.com/ooiuuii), [@obviyus](https://github.com/obviyus).
- 将输出受限的 Responses 回答报告为不完整 [#142778](https://github.com/openclaw/openclaw/pull/142778) — 感谢 [@zhangguiping-xydt](https://github.com/zhangguiping-xydt), [@obviyus](https://github.com/obviyus), [@ooiuuii](https://github.com/ooiuuii).
**改进**
- 报告配置补丁中实际发生变化的路径 [#141757](https://github.com/openclaw/openclaw/pull/141757)
**文档**
- 将 Gateway RPC 方法组暴露为标题 [#143459](https://github.com/openclaw/openclaw/pull/143459) — 感谢 [@vincentkoc](https://github.com/vincentkoc).
- 更正 Gateway 参考层级和模型视图链接 [#143472](https://github.com/openclaw/openclaw/pull/143472) — 感谢 [@vincentkoc](https://github.com/vincentkoc).
- 将 Gateway RPC 指南拆分为聚焦的主题页面 [#143515](https://github.com/openclaw/openclaw/pull/143515) — 感谢 [@vincentkoc](https://github.com/vincentkoc).
</details>
在更宽敞的空间中打开报告和插件面板
报告 在 OpenClaw 内的短地址 /reports 打开,嵌入的插件页面会使用更多窗口空间。在之前文件权限造成阻碍的受影响容器中,插件面板也能加载。
如果你使用单独的 Team Reports 报告或导出链接,请将 /reports/... 更改为 /plugins/team-reports/...;旧链接不会自动重定向。指南说明了如果你需要自定义地址,如何保留它。
来源和完整变更列表
错误修复
- 使生成的插件面板可被容器运行时用户读取 #142997 — 感谢 @ylcn91, @obviyus, @Conan-Scott.
- 让嵌入报告填满内容区域 #143765
限制和兼容性
- 添加短插件选项卡 URL 并移动 Team Reports HTTP 默认值 #143183
改进
- 为 Team Reports 使用完整页面宽度 #143340
在新的云会话中复用项目配置
新的云会话可以复用已配置好的项目,在保留你的会话更改的同时,节省重复的安装和准备工作。你可以使用符合条件的本地项目,或直接从公共 GitHub 仓库启动。仅从私有仓库 URL 启动仍会使用全新检出;已在本地检出的私有项目可以使用本地项目路径。已保存的配置在启动时仍需要一台机器,除非有可用的运行中备用节点。
升级前请按照备份和回滚说明备份 OpenClaw 的数据。旧版本无法读取更新后的数据格式,因此仅回滚应用是不够的。恢复较早的备份也会丢弃之后所做的更改。
来源和完整变更列表
改进
- 为公共 GitHub 仓库复用已准备好的工作节点 2bcb98a4b280
- 在新的云工作节点会话之间复用已完成的项目配置 #143227
为下一个会话保持一台云计算机就绪
就绪工作节点 可让你的下一个匹配会话使用一台已在运行的计算机,同时 OpenClaw 准备替换节点。符合条件的 Linux 项目默认每个项目和配置文件获得一个备用节点,共享上限为四个。这些计算机在删除确认前会产生费用。将配置文件的就绪工作节点值设为零以禁用其备用节点,或将共享的预置池上限设为零以移除未使用的备用节点,而不会停止活动会话。
如果你已经使用已保存的工作节点镜像,请停止 OpenClaw 及其启动的任何镜像捕获,然后在启动更多工作节点之前遵循 Doctor 升级步骤。
预置容量以持续成本换取等待时间。概念示意图,非截图。工作节点在删除确认前会产生费用。移除未使用的备用不会停止活动会话。
来源和完整变更列表
改进
错误修复
- 在配置供应期间保留工作节点捆绑包 #143663
选择 Linux、Windows、WSL2 或 macOS 工作节点
当你的提供商支持时,你可以为配置文件或单个会话选择云计算机的操作系统。原生 Windows 运行 Windows 命令,而 WSL2 在 Windows 上提供 Linux 环境。AWS 上的 Mac 工作节点需要 Dedicated Host 和 On-Demand 容量;桌面访问和可复用工作节点镜像仍仅限 Linux。操作系统指南 涵盖可用性,并包含原生 Windows 的设置要求。
_提供商可用性决定您可以使用哪些云选项。概念性示意图,并非截图。桌面访问和可复用工作器镜像在本版本中仍仅限 Linux。_
<details class="release-source-toggle">
<summary>来源和完整变更列表</summary>
**改进**
- 选择提供商定义的云会话操作系统 [#142095](https://github.com/openclaw/openclaw/pull/142095)
- 使用兼容的 Crabbox 启用 Windows WSL2 云工作器 [#142679](https://github.com/openclaw/openclaw/pull/142679)
- 通过 Crabbox 运行 macOS 云工作器 [#143463](https://github.com/openclaw/openclaw/pull/143463)
- 在原生 Windows 上运行云工作器 [#143769](https://github.com/openclaw/openclaw/pull/143769)
**文档**
- 翻译云工作器操作系统控件 [#142120](https://github.com/openclaw/openclaw/pull/142120)
**Bug 修复**
- 说明不可用的云操作系统 [#143798](https://github.com/openclaw/openclaw/pull/143798)
</details>
从设置中配置云工作器
云工作器设置现在允许管理员更改高级选项、设置备用计算机限制,并为每个仓库选择默认配置文件。保存更改并重启 OpenClaw 以使其生效。您还将鼠标悬停在云会话上,即可查看其已知的操作系统、CPU 和内存容量。
当您的 Crabbox 工具缺失或过时时,OpenClaw 可以自动下载受支持的 Crabbox 工具。如果您的计算机阻止这些下载或安装,请在升级前准备 Crabbox 0.55.0 或更高版本,因为即使要检查或停止现有云工作器,您也需要它。
来源和完整变更列表
文档
- 更正云工作器设置指南中的 Node 要求 #141871
- 将云工作器指南拆分为聚焦的主题页面 #143158 — 感谢 @vincentkoc。
改进
保存和管理已准备的云项目
管理员可以在设置中保存已准备的项目、查看其进度、取消它,或固定一个有用的快照以保留它。您可以为新的工作器选择之前的快照,而无需更改已在运行的计算机。构建会使用项目已提交的文件和设置说明,并可能复用合适的现有副本。
在中断的捕获之后使用 Recover 之前,请停止受影响的工作器,并通过您的提供商捕获并检查已保存的镜像。Recover 只会清除 OpenClaw 对中断的记录;它不会为您停止计算机或删除镜像。
来源和完整变更列表
Bug 修复
改进
在更新期间保留消息和云计算机
当云会话正在设置或同步文件时,您可以发送消息,并查看它正在等待什么。OpenClaw 会保留该消息,并在目标计算机就绪时启动它,从而免去您复制和重新发送的麻烦。
受支持的云计算机还可以在OpenClaw 更新期间保留其文件、已安装的工具和桌面。尚未开始的消息可以在工作器更新后继续,但已在进行中的工作不会自动重复。计算机必须支持更新并重新连接;这无法恢复提供商丢失的机器。
来源和完整变更列表
Bug 修复
更快地复制远程工作区
保存包含许多小文件的远程工作区可以更快完成,并且其文件列表需要传输的字节更少。取消准备会停止新的扫描并关闭上传连接,而不是让其挂起,但已在进行中的文件操作可能需要一些时间才能完成。超大或正在更改的文件也会更早被拒绝,而不会留下部分工作区结果。
来源和完整变更列表
**错误修复** - 允许在工作节点启动时使用较长的已准备工作区路径 [#142198](https://github.com/openclaw/openclaw/pull/142198) - 防止已取消的云工作区上传挂起 [#142237](https://github.com/openclaw/openclaw/pull/142237) - 在工作节点启动期间跳过未使用的工作区文件 [#143721](https://github.com/openclaw/openclaw/pull/143721) - 当工作节点准备被取消时停止工作区扫描 [#143746](https://github.com/openclaw/openclaw/pull/143746) - 在工作节点工作区捕获期间停止过多读取 [#143795](https://github.com/openclaw/openclaw/pull/143795) **改进** - 在传输期间压缩云工作区文件清单 [#142242](https://github.com/openclaw/openclaw/pull/142242) - 更快地捕获包含大量文件的远程工作区 [#144017](https://github.com/openclaw/openclaw/pull/144017)查看云清理后仍需关注的事项
当云工作节点失败时,错误现在会保持原始问题和最新清理失败可见,而不会堆叠重复消息。即使保存可选镜像失败,停止计算机也可以成功,并附带警告说明剩余内容。失败的镜像删除会保持可见以便重试,费用可能会持续,直到你的提供商确认删除。
来源和完整变更列表
错误修复
查找并连接 Codex 插件
所有者和管理员可以搜索 Codex 插件,打开它们的设置链接,并一起查看安装、权限和账户连接信息。打开设置链接不会完成该步骤——完成后请返回并提交完成响应。连接后,使用 /codex plugins refresh 更新应用列表,然后在需要时使用 /new 或 /reset;刷新不会替你登录或启用应用。
来源和完整变更列表
改进
- 查找、连接并检查 Codex 插件 #132158 — 感谢 @stevenlee-oai。
安全与隐私¶
你的 Claw 可以在不打扰你的情况下,对常规命令做出更多决策,同时仍会在需要时请求批准。还有修复,用于将文件访问限制在你选择的权限范围内,在删除代理时保护共享对话历史,并将私有更新记录排除在备份和支持包之外。
决定命令何时需要你的批准
自动命令审查 现在可以让合适的常规命令运行,带解释地拒绝命令,或请你决定。这在现有的自动模式和工作区模式下生效。在 OpenClaw 内置代理中,审查者可以使用你对话的一部分来检查命令是否符合你的请求。高风险操作仍需要人工批准,始终询问的设置仍然有效。
来源和完整变更列表
改进
错误修复
- 防止超时的命令审查在清理完成前释放模型资源 #143308。
保持你的工具权限不变
现在关闭工具会传递到受支持的已连接代理,包括 Copilot,即使你返回到之前允许它们的对话。如果集成无法遵守该限制,OpenClaw 会停止,而不是在工具启用的情况下继续。更新插件或选择受支持的代理以继续。
你的 Claw 的指令还允许它使用现有登录信息来执行你授权的任务,例如登录网站,同时保持你的其他权限不变。当它无法在聊天中提供安全设置时,它会引导你到隐藏你输入内容的终端提示。
来源和完整变更列表
改进
- 在英文界面中澄清现有只读权限的范围 #141283。感谢 @north-echo 和 @obviyus。
错误修复
- 对无效批准决定显示用法,并接受具有有效决定的异常 ID #137877。感谢 @teddytennant 和 @obviyus。
- 移除笼统的凭据使用拒绝并修正设置路由 #143238。感谢 @ejc3、@Stephane-fci 和 @Sedrak-Hovhannisyan。SDK 调用方应将
buildCredentialSafetyPrompt的旧版字符串参数替换为{ controlToolsAvailable };旧版字符串在 2026 年 11 月 30 日前仍被接受。 - 在清理结束前保留批准回复解释资源 #143307。
安全与信任
- 在插件交接期间保留已禁用的工具 [#142093](https://github.com/openclaw/openclaw/pull/142093)。感谢 [@pgondhi987](https://github.com/pgondhi987)。对于[插件作者](../plugins/sdk-agent-harness.md),空的运行时 `toolsAllow` 列表表示拒绝所有,而空的配置 `allow` 列表仍保持不受限制。
**文档**
- 澄清完整模式下的命令审批、严格内联代码审查以及等待行为 [#142368](https://github.com/openclaw/openclaw/pull/142368)。感谢 [@Glucksberg](https://github.com/Glucksberg)、[@obviyus](https://github.com/obviyus)、[@JKamgang](https://github.com/JKamgang) 和 [@russellweiss](https://github.com/russellweiss)。这记录了现有策略;严格内联评估默认仍保持关闭。
</details>
修复密码和设备登录问题
密码登录现在会拒绝空白密码和已知示例值。如果某个密码阻止 Gateway 启动,请替换它,重启 OpenClaw,并更新连接到它的应用。较短的真实密码会触发警告,而不是新的启动阻止。
更多模型连接可以使用受保护的 API 密钥,而无需关闭保护。Doctor 还为管理员提供了针对某些旧设备登录故障的可用修复方法,使重新连接受影响设备更加容易。
来源和完整变更列表
安全与信任
- 拒绝占位符 Gateway 密码并审计密码强度 #141720。
错误修复
- 对于符合条件的仅密码连接,跳过未使用的已保存凭据 #142290。这适用于使用只读本地共享状态的已签名客户端,且没有特定来源的凭据范围或其他凭据类型。
- 更正凭据恢复通知 #142498。感谢 @obviyus。
- 通过托管密钥出口恢复 WebSocket 推理,并同步捆绑的 autoreview 身份验证处理以及机器可读状态输出 #143354。感谢 @fuller-stack-dev。该辅助同步还移除了 autoreview 对外部凭据扫描器的依赖。
- 使用
--no-scopes恢复旧版节点令牌 #143599。感谢 @obviyus 和 @matthewmoroz。该选项不能与--scope组合使用;清理仅移除匹配的本地旧版节点凭据。
文档
- 将密钥指南拆分为聚焦的运行时、SecretRef、存储与出口、集成以及运维指南 #143520。感谢 @vincentkoc。
保护传入消息和网络访问
对于使用 HTTP webhook 的 Slack 连接,OpenClaw 现在会在处理之前对超大、缓慢或过多的传入请求强制执行限制。Feishu 和 Lark webhook 还会拒绝日期早于或晚于计算机时钟一小时以上的已签名请求。请保持该时钟同步,如果延迟投递被拒绝,请查看 Feishu 故障排查。Feishu 的 WebSocket 连接模式不受影响。
如果你为反向代理或设备配对使用 IPv4 映射网络规则,请审查你允许的地址。这些规则现在覆盖其完整声明范围,修复了被错误拒绝的连接。因此,宽泛的规则可能会信任比以前更多的地址,包括计算机本身;请将允许范围保持得尽可能窄,以满足你的配置需求。其他登录和审批检查仍然适用。
来源和完整变更列表
安全与信任
- 在处理之前强制执行 Slack HTTP webhook 限制,包括 1 MiB 正文限制和 30 秒读取截止时间 c11ea063。感谢 @drobison00。上下文意图和审查参考 #136508。
- 在启用代理兼容性的同时保留 IPv6 云元数据阻止 #137684。感谢 @eleqtrizit。
- 在身份验证查找之前拒绝格式错误的 Tlon 引用 #142041。感谢 @pgondhi987。
- 拒绝固定一小时时钟窗口之外的过期已签名 Feishu 和 Lark webhook 回调 #143484。感谢 @eleqtrizit。
限制与兼容性
- 在代理和配对规则中遵循 IPv4 映射网络范围 #137668。感谢 @elbourne12345 和 @obviyus。原生 IPv6 对等体不匹配这些范围,并且全匹配代理信任仍可能阻止正确的客户端归属。
将共享文件限制在其权限范围内
当代理被限制在其工作区时,它现在可以发送当前聊天沙箱中的文件,而无法附加来自另一个聊天沙箱的文件。发送这些附件的插件必须识别正确的工作区,因此某些第三方插件可能需要更新。
将共享对话更改为草稿现在还会阻止无法再看到该对话的读者发起新的文件请求,即使没有单独配置用户角色。之前签发的下载链接在过期之前仍然有效,共享同一个 OpenClaw 安装的人员仍需相互信任。
来源和完整变更列表
**安全与信任** - 在仅工作区策略下,阻止从同级沙箱读取附件 [#143521](https://github.com/openclaw/openclaw/pull/143521)。感谢 [@eleqtrizit](https://github.com/eleqtrizit)、[@yetval](https://github.com/yetval) 和 [@yangxiansheng](https://github.com/yangxiansheng)。 **缺陷修复** - 将草稿可见性应用于新的工件读取和下载 [#143873](https://github.com/openclaw/openclaw/pull/143873)。感谢 [@vincentkoc](https://github.com/vincentkoc)。 **文档** - 将沙箱化指南拆分为聚焦的后端、工作区、镜像和设置页面 [#143522](https://github.com/openclaw/openclaw/pull/143522)。感谢 [@vincentkoc](https://github.com/vincentkoc)。 - 记录文件传输审批迁移,并澄清 SecretRef 字段、Moonshot 模型示例以及插件引用导航 [#144029](https://github.com/openclaw/openclaw/pull/144029)。感谢 [@vincentkoc](https://github.com/vincentkoc)。保持外部工具应用为只读
如果你具有只读访问权限,在单独视图中打开 MCP 应用不再授予你运行其工具的权限。你仍然可以查看该应用并使用你被允许读取的资源。对于在同一台计算机上运行的 MCP 工具,拒绝超大上传还会阻止排在其后面的工具命令在该连接上运行。
来源和完整变更列表
安全与信任
- 在独立 MCP 应用中保留只读权限 #142661。感谢 @eleqtrizit。客户端工具权限在签发启动票据时捕获;持续检查涉及实时应用授权。
- 在已认证的环回连接上,拒绝上传后阻止排队的 MCP 工具执行 #143724。
保护共享历史和私有更新记录
如果另一个代理需要它来读取共享历史,删除代理现在会停止。目前尚不支持移动该历史,因此请保留该代理配置。如果删除中途失败,请修复报告的存储问题并重试。在删除链接到相邻文件夹的工作区之前,请检查将被删除的内容。通过 Gateway 删除可能也会将该链接文件夹移至回收站;离线命令仅删除链接。
备份和支持包会排除已识别的私有更新记录。如果你移动受保护文件夹,请将其隐私标记文件一起保留。没有该标记而复制到其他位置的文件不受导出保护。
来源和完整变更列表
缺陷修复
- 在删除代理期间保留共享历史和可重试清理 #141731。感谢 @andrea-kingautomation。
- 清理外部状态卷上已删除的代理,并遵循上述 Gateway 的同父级工作区符号链接行为 #142130。
安全与信任
- 将已识别的私有更新捕获排除在备份和支持导出之外 #143799。感谢 @fuller-stack-dev。
- 当标记保持完整时,排除已移动的私有捕获目录,并拒绝无效标记 #143899。感谢 @fuller-stack-dev。
保留你的 WhatsApp 群组访问选择
运行 openclaw security audit --fix 现在会保留你已选择的 WhatsApp 群组访问列表,而不会仅仅因为某人之前已与你的 Claw 配对就将其添加进去。当将开放群组策略更改为受限访问时,如果你未提供列表,它仍可使用已批准的发送者。之前修复添加的人员不会自动移除,因此如果你受到影响,请检查你的列表。
来源和完整变更列表
安全与信任
- 在安全修复期间保留 WhatsApp 群组允许列表 #142589。感谢 @eleqtrizit。
了解更新检查共享的内容
遥测指南现在解释了更新检查可能透露你的大致位置、本地预览可以显示的内容,以及文档中说明的三个月保留期。关闭可选统计或设置 DO_NOT_TRACK 不会停止自动更新检查。如果你也想停止这些请求,请使用指南中说明的单独控制项。该位置可能是 VPN、代理或远程计算机的位置,而不是你所在的位置。
来源和完整变更列表
缺陷修复
- 在可选统计及其预览中规范化公共提供商名称,同时保留私有提供商过滤器和现有同意设置 #141134。感谢 @vincentkoc。
文档
- 将 Gateway 安全指南组织为聚焦的设置、信任、审计和事件响应页面 #141162。感谢 @vincentkoc。
- 将策略命令指南拆分为编写、规则、范围、检查、证明和发现指南 #142961。感谢 @vincentkoc。
- 解释托管更新遥测中的大致位置、预览限制、保留期和请求控制 #143311。感谢 @vincentkoc。
- 将威胁目录组织为聚焦页面,同时保留共享风险上下文 #143517。感谢 @vincentkoc。
- 澄清 Anthropic setup-token 登录、密钥范围、审批升级指南、共享速率限制和代理验证失败 #144030。感谢 @vincentkoc。
体验改进¶
现在你可以从终端回答 Claw 的问题并输入密钥,之后输出更清晰,便于阅读和复制。此外,还修复了启动和恢复编码工作区、为委派任务预留足够时间,以及在出现问题时找到所需帮助的问题。
在终端中回答问题并输入密钥
当 Claw 需要回答时,你现在可以直接在终端中选择一个选项或输入回复,包括在任务等待你回复时。按 Esc 可暂时搁置问题,按 /question 可重新调出该问题。
密钥请求 会提供一个掩码输入框,使你输入的内容不会出现在对话和输入历史中。保存密钥需要 Gateway 连接,终端输入每次只接受一行。如果需要更改哪些站点可以使用该密钥,请使用 Web 应用。本地会话支持普通问题,你应在关闭终端前回答这些问题。
来源与完整变更列表
改进
- 在终端中回答代理问题和 Gateway 密钥请求 #143273。感谢 @Sedrak-Hovhannisyan。
阅读和复制终端输出
长地址和其他文本现在会在终端聊天中换行,而不会增加额外空格,因此你可以按原样复制它们。表格会保持相关值对齐,进度指示器也不会再在窄窗口中留下重复行。如果你使用脚本读取命令结果,审批 JSON 和转录输出也会将无关通知移开。
来源与完整变更列表
改进
缺陷修复
理解命令错误
命令错误现在能更好地告诉你下一步该做什么,例如提供登录信息或选择要使用的代理,而不会让缺失的选项看起来像安装损坏。如果 openclaw agent 在任务被接受后失去连接或超时,错误会提供该任务的 ID,以便你在重试前检查发生了什么。请先检查其对话历史和 Gateway 状态,因为连接丢失后工作可能仍在继续。
来源与完整变更列表
缺陷修复
- 在连接丢失和超时提示中显示已接受的运行 ID #111899。感谢 @xialonglee、@MrNozz、@obviyus。
- 区分命令错误和 CLI 启动失败 #142109。
- 为 Gateway 覆盖显示直接的凭据指引 #142112。感谢 @DasX、@obviyus。
- 在完整状态报告中显示可用的 Gateway 详情 #142174。
- 说明 CLI 命令何时需要显式代理 #143266。
文档
- 记录系统命令的端口和密码选项 #139071。感谢 @qingminglong、@obviyus。
保留更有用的 Code Mode 结果
Code Mode 用于格式化的结果空间更少,从而为 Claw 请求的信息留出更多空间。终端也会按原样显示这些数据,而不会将其部分视为消息格式。递归调用过深的代码现在会返回一个 Claw 可以处理的错误,从而可以修正该代码并继续。
来源与完整变更列表
缺陷修复
- 适配紧凑的 Code Mode 结果并显示字面 JSON #141417。
- 保持递归 Code Mode 单元格可恢复 #141960。感谢 @vincentkoc。
文档
- 按任务组织 Code Mode 指引 #142425。感谢 @vincentkoc。
启动和恢复编码工作区
工作树 会为 Claw 提供代码项目的独立工作副本。设置重试现在会保留你最初选择的版本,拥有许多分支的项目也会保留启动工作树的选项。你可以输入建议中缺失的分支或提交,如果找不到则会显示错误。
已保存的工作树还会恢复将文件替换为文件夹、或将文件夹替换为文件的更改,并保持替换后的内容完整。
<details class="release-source-toggle">
<summary>来源和完整变更列表</summary>
**错误修复**
- 验证工作树起始引用并保留已接受的提交 [#135917](https://github.com/openclaw/openclaw/pull/135917)。感谢 [@RomneyDa](https://github.com/RomneyDa)。
- 接受托管工作树 ID 中的周围空格 [#141373](https://github.com/openclaw/openclaw/pull/141373)。感谢 [@nocodet888-arch](https://github.com/nocodet888-arch)、[@obviyus](https://github.com/obviyus)。
- 在拥有许多分支的仓库中保持工作树会话可用 [#143205](https://github.com/openclaw/openclaw/pull/143205)。
- 在工作树恢复中保留文件和文件夹替换 [#143324](https://github.com/openclaw/openclaw/pull/143324)。
**文档**
- 将工作树命令添加到 CLI 索引 [#137422](https://github.com/openclaw/openclaw/pull/137422)。感谢 [@qingminglong](https://github.com/qingminglong)、[@obviyus](https://github.com/obviyus)。
</details>
保持指令和旁路问题不跑偏
当较长的 AGENTS.md 指令文件需要缩短时,示例会保留其正上方解释其内容的行,有助于避免引文看起来像新指令。缩短后的指令还能识别更多繁体中文规则,尽管可用空间仍然限制了可包含的内容。
如果你跟踪模型用量,已完成的 /btw 旁路回答现在可以将报告的用量包含在你已配置的诊断中。这些旁路问题仍不计入对话的 /usage 成本总计。
来源和完整变更列表
改进
- 在列出未固定会话时减少重复工作 #141788。
错误修复
- 在缩短的指令中保留相邻示例的上下文 #137974。感谢 @SunnyShu0925、@obviyus、@Hawk5150。
- 报告直接 /btw 回答的用量 #141620。
- 在目标更新被拒绝后引导代理 #142808。感谢 @SunnyShu0925、@obviyus、@aminekhettat。
- 在原生 Git 署名重放迁移到会话指令之前修复它 #142869。感谢 @Marvinthebored、@obviyus。
- 在超大指令中保留繁体中文规则 #142915。感谢 @sunlit-deng、@obviyus、@igs-rogenlo。
- 在条件会话指令中保留符合条件的 Git 共同作者指导 #143198。感谢 @Marvinthebored。
- 在清理过程中保持旁路问题资源可用 #143366。
文档
- 按操作员任务组织会话参考 #143082。感谢 @vincentkoc。
委派工作的时间限制
子代理 是你的 Claw 可以派去处理任务部分的助手。具有可见对话的助手现在会获得为其首个任务选择的时间,因此较长的工作不会因常规截止时间而被中断。后续消息使用正常时间限制。另一项修复有助于在多个代理共享一个 Gateway 时,让已完成的结果在重启后返回到正确的代理。
来源和完整变更列表
错误修复
- 将恢复的子代理结果路由到其已保存的请求者 #141480。感谢 @aeoess、@obviyus、@laurenceputra、@toraiwa。
- 拒绝不完整的子代理续接交接 #141901。感谢 @Takhoffman。
- 允许独立的子运行从父工具注册 #142652。感谢 @jalehman。
- 遵守初始可见子代理的时间限制 #142812。感谢 @fanyangCS、@obviyus。
文档
- 将子代理指导拆分为聚焦的链接页面 #142999。感谢 @vincentkoc。
找到你需要的帮助
FAQ 围绕你试图回答的问题进行组织,文档主页为你提供到发布、技能、自动化和构建插件的直接路径。设置示例更清晰,对旧书签和帮助链接的修复使相关说明更容易找到。简体中文导航也增加了翻译后的标签,包括独立的“发布”和“贡献”选项卡。
来源和完整变更列表
错误修复
- 修复自动支持回复中的故障排除链接 #143194。感谢 @vincentkoc。
- 将示例标题排除在文档地图之外 #143299。感谢 @qingminglong、@obviyus。
- 修复错误和故障排除中的文档链接 #143497。感谢 @vincentkoc。
文档
- 更正 Windows、ChromeOS 和 durable-work 成熟度列表 [#142066](https://github.com/openclaw/openclaw/pull/142066)。感谢 [@RomneyDa](https://github.com/RomneyDa)。
- 关联相关插件和提供商指南 [#143021](https://github.com/openclaw/openclaw/pull/143021)。感谢 [@vincentkoc](https://github.com/vincentkoc)。
- 添加相关指南链接和中文标签翻译 [#143040](https://github.com/openclaw/openclaw/pull/143040)。感谢 [@vincentkoc](https://github.com/vincentkoc)。
- 将常见问题整理为聚焦的主题页面 [#143150](https://github.com/openclaw/openclaw/pull/143150)。感谢 [@vincentkoc](https://github.com/vincentkoc)。
- 改进指南和命令参考之间的链接 [#143157](https://github.com/openclaw/openclaw/pull/143157)。感谢 [@vincentkoc](https://github.com/vincentkoc)。
- 恢复旧版文档章节链接 [#143586](https://github.com/openclaw/openclaw/pull/143586)。感谢 [@vincentkoc](https://github.com/vincentkoc)。
- 明确设置指南、修剪默认值和 Exa 模式 [#143770](https://github.com/openclaw/openclaw/pull/143770)。感谢 [@vincentkoc](https://github.com/vincentkoc)。
- 改进文档指南之间的导航 [#143773](https://github.com/openclaw/openclaw/pull/143773)。感谢 [@vincentkoc](https://github.com/vincentkoc)。
- 重新组织 CLI 和工具文档 [#143775](https://github.com/openclaw/openclaw/pull/143775)。感谢 [@vincentkoc](https://github.com/vincentkoc)。
- 更正 Gateway 和提供商设置文档 [#143796](https://github.com/openclaw/openclaw/pull/143796)。感谢 [@vincentkoc](https://github.com/vincentkoc)。
- 将 bot-loop、transcripts、Copilot、Baseten 和 incident-response 指南添加到侧边栏 [#143845](https://github.com/openclaw/openclaw/pull/143845)。感谢 [@vincentkoc](https://github.com/vincentkoc)。
- 改进中文文档标签 [#143853](https://github.com/openclaw/openclaw/pull/143853)。感谢 [@vincentkoc](https://github.com/vincentkoc)。
- 改进指南链接和章节导航 [#143855](https://github.com/openclaw/openclaw/pull/143855)。感谢 [@vincentkoc](https://github.com/vincentkoc)。
- 修复概念和故障排查链接 [#143923](https://github.com/openclaw/openclaw/pull/143923)。感谢 [@vincentkoc](https://github.com/vincentkoc)。
- 改进频道和插件指南导航 [#143926](https://github.com/openclaw/openclaw/pull/143926)。感谢 [@vincentkoc](https://github.com/vincentkoc)。
- 简化设置和概念文档 [#143931](https://github.com/openclaw/openclaw/pull/143931)。感谢 [@vincentkoc](https://github.com/vincentkoc)。
- 重新组织设置和操作指南 [#143977](https://github.com/openclaw/openclaw/pull/143977)。感谢 [@vincentkoc](https://github.com/vincentkoc)。
- 明确工具和频道参考文本 [#143979](https://github.com/openclaw/openclaw/pull/143979)。感谢 [@vincentkoc](https://github.com/vincentkoc)。
- 改进文档选项卡和标题 [#144021](https://github.com/openclaw/openclaw/pull/144021)。感谢 [@vincentkoc](https://github.com/vincentkoc)。
- 对齐中文发布和贡献者导航 [#144037](https://github.com/openclaw/openclaw/pull/144037)。感谢 [@RomneyDa](https://github.com/RomneyDa), [@vincentkoc](https://github.com/vincentkoc)。
- 恢复 Windows 成熟度章节链接 [#144067](https://github.com/openclaw/openclaw/pull/144067)。
- 明确代理设置和 Gateway 概念 [#144086](https://github.com/openclaw/openclaw/pull/144086)。感谢 [@vincentkoc](https://github.com/vincentkoc)。
- 改进文档主页链接和措辞 [#144089](https://github.com/openclaw/openclaw/pull/144089)。感谢 [@vincentkoc](https://github.com/vincentkoc)。
</details>
其他错误修复¶
OpenClaw 现在能处理更多可能导致你得不到答案、阻止对话加载,或让成功任务看起来像失败的中断。错误消息和故障排查记录也会解释更多发生了什么。
工作完成后获取答案
在更多工作已完成但答案从未到达的情况下,你的 Claw 可以恢复缺失的最终回复,包括在模型连接丢失或更早的工具错误之后。它会请求模型给出解释,而不重复已完成的动作,让你有机会再次看到已完成的工作。
来源和完整变更列表
错误修复
重新开始并重新打开对话
使用 /new 或 /reset 重新开始可以避免不必要的等待,尤其是在你的 Claw 已将工作交给其他代理的对话中;当迟到的结果到达时,已取消的任务会保持停止状态。你保存的历史记录和其他对话仍然可用。
当前对话之外的旧插件消息不再阻止其历史记录加载,并且当你的 Claw 暂停等待其他工作时,长对话会保留最近消息可用。如果纯文本回复在中途失败,当你继续时,模型还会收到一条关于该失败的简短说明,因此该尝试不会再从它的上下文中消失。
来源和完整变更列表
**Bug 修复** - 为下一次模型请求保留失败的部分回答上下文 [989abf6](https://github.com/openclaw/openclaw/commit/989abf68703796dedcdd91d0ab7116684de69b8d),并在 [#125977](https://github.com/openclaw/openclaw/pull/125977) 中提供上下文来源。感谢 [@ayaangazali](https://github.com/ayaangazali)。 - 防止未激活的自定义消息破坏会话历史 [#125413](https://github.com/openclaw/openclaw/pull/125413)。 - 在 yield 清理期间保持长历史可读 [#137381](https://github.com/openclaw/openclaw/pull/137381),与 [问题 #109638](https://github.com/openclaw/openclaw/issues/109638) 相关。感谢 [@jalehman](https://github.com/jalehman)、[@samrrr](https://github.com/samrrr)、[@VACInc](https://github.com/VACInc)。 - 避免独立会话重置时的 thinking-lookup 延迟 [#143281](https://github.com/openclaw/openclaw/pull/143281)。 - 重置后保持当前历史可读 [#143726](https://github.com/openclaw/openclaw/pull/143726)。 - 在保持子任务停止的同时减少重复的重置工作 [#143916](https://github.com/openclaw/openclaw/pull/143916)。感谢 [@obviyus](https://github.com/obviyus)、[@aleps001](https://github.com/aleps001)、[@zhangguiping-xydt](https://github.com/zhangguiping-xydt)。更清晰的文件错误和命令结果
当你的 Claw 无法在其工作区中保存文件时,现在会说明是访问被拒绝、磁盘已满还是位置为只读。这为你解决问题提供了有用的起点。Tool Search 还修复了一种在文件能够被读取之前,提供的文件路径丢失的情况。
在 Linux 上,受影响的 SSH 命令可以正常结束,而不是过早停止。macOS 和 Linux 上的命令还会避免在成功执行后出现误报的清理错误。如果你使用 --no-restart 更新,请重启 OpenClaw 以获取该清理修复。
来源和完整变更列表
Bug 修复
- 解释工作区写入失败的文件系统原因 #116378,与 问题 #115920 相关。感谢 @sloptop-the-terrible、@obviyus、@609NFT、@geekforlife。
- 在命令超时后清理已接管的 Linux 进程 #139548,这是 问题 #97616 的部分修复。清理为尽力而为,并在 30 秒后停止。感谢 @srikolagani、@obviyus、@avp717、@Grynn、@islandpreneur007、@jinngimk-lang。
- 在关闭继承的文件句柄后,让服务管理的 SSH 命令正常结束 #141463。该修复已在 Linux 上验证。感谢 @jjjhenriksen、@obviyus、@manumadrigal09、@ouioui33、@avcarp、@kaspnov。
- 避免在成功的 POSIX 命令后出现误报的清理失败 #143240。
- 在空包装器旁边保留工具参数 #143729。感谢 @xydigitLybnnnn、@obviyus、@nkdmike。
故障排查错误和导出的对话
OpenClaw 现在可以等待短暂的数据库锁,而不是立即因读取其已保存的设置而失败。当数据库问题确实导致失败或关闭时,错误消息会保留更多调查所需的信息。日志 还为操作员提供了更清晰的视图,显示哪些工作正在等待或耗时,并在启用诊断时提供额外细节。
导出的对话会保留被错误移除的文件读取结果,包括读取文件下一部分的说明。在启用相关诊断记录后,记录还会包括切换到备用模型后采取的操作,以及中断前收到的部分响应。敏感信息仍会被移除,并且记录大小限制仍然适用。
来源和完整变更列表
改进
- 识别缓慢和失败的 SQLite 会话写入 #143451。
- 在 SQLite 警告中识别执行线程 #143629。
- 识别持有会话队列的操作 #143886。
- 解释缓慢的会话清理准备 #143942。
- 澄清 SQLite 写入和 worker-release 诊断 #144038。仅释放事件本身不能证明清理或提交成功。
Bug 修复
- 在轨迹导出中包含回退工具活动 #114662,与 问题 #114602 相关。感谢 @synthalorian、@obviyus、@jackatagenticforce。
- 保留来自工作线程的 SQLite 致命诊断 #143039。
- 保留部分调试捕获并报告关闭时的存储失败 #143107。感谢 @vincentkoc。
- 在清理期间保留引发数据库错误 #143574。
- 在状态读取期间等待短暂锁 #143908。持久锁仍可能失败。感谢 @pash-openai。
- 在会话导出中保留分页文件读取 #143930。感谢 @linhongyu510、@obviyus、@cp1369。
维护者和内部变更¶
本次发布包含 692 个仅限维护者的单元,涵盖代码清理、测试、发布准备和贡献者工具。展开来源列表以查看完整变更历史。
内部代码清理
共享代码和类型定义替换了 OpenClaw 中重复的逻辑。这使维护者在更改行为时只需更新更少的地方,并移除了未使用的代码。
来源和完整变更列表
入站钩子映射器的兼容性问题由单独记录的公开修复解决。两个终端写入器清理移除了私有重置和关闭状态辅助函数;与未跟踪的私有导入消费者的兼容性尚未确定。
改进
- 移除固定的孤立提示策略包装器 746e53f2
- 简化共享工具摘要格式化 #136181
- 移除未使用的内部健康检查执行路径 #138211
- 移除未使用的 Doctor 健康检查参数 #141475。感谢 @vincentkoc。
- 从其现有事务返回 cron 激活状态 #141676。感谢 @RomneyDa。
- 跳过尾部唤醒名称的未使用距离计算 #141683
- 将传入的 Reef 版本类型化为未验证输入 #141687。感谢 @RomneyDa。
- 将 cron 脚本结果解析与执行分离 #141688
- 将转录摘要持久化与实时捕获分离 #141695
- 分离已准备运行时快照构建 #141711
- 移除冗余的 CLI 二进制名称解析 #141713
- 移除未使用的重启测试覆盖 #141714
- 在 web-fetch 阶段之间共享 HTML 标签扫描 #141726
- 分离已准备运行时保留和认证失效 #141728
- 统一 Profile 身份保存处理 #141730
- 在不改变投递顺序的情况下共享 Slack 回复准备 #141733
- 共享 CLI 本地入门决策 #141735
- 集中处理原生审批适配器类型 #141737。感谢 @RomneyDa。
- 集中处理原生 WebKit 桥接消息类型 #141764。感谢 @RomneyDa。
- 共享转录幂等键读取器 #141772。感谢 @vincentkoc。
- 移除未使用的 UI 文本格式化选项 #141783。感谢 @vincentkoc。
- 复用 Doctor 的共享旧版源身份比较 #141784。感谢 @vincentkoc。
- 分离模型目录源准备 #141810
- 在本地读取器之间共享模型目录展示 #141815。感谢 @obviyus。
- 将缓存轮次重放移入去重模块 #141824
- 复用 Doctor 的路径包含辅助函数 #141828。感谢 @vincentkoc。
- 简化内置内存运行时委托 #141847
- 在宿主 SDK 中集中管理内存做梦类型 #141873。感谢 @RomneyDa。
- 通过协议共享 ClawHub 技能响应类型 #141874。感谢 @RomneyDa。
- 从解析器派生会话能力类型 #141878。感谢 @RomneyDa。
- 从生产者派传入站钩子上下文类型 #141880。感谢 @RomneyDa。
- 共享提供商请求机密字段定义 #141882
- 复用通道设置配置写入器 #141929
- 简化 Markdown 跨度顺序记录 #141945。感谢 @vincentkoc。
- 移除不可达的 TUI 流式状态 #141999
- 在列出会话时避免重复验证 #142005
- 在搜索设置期间保留插件类型 #142006
- 从 Gateway 定义派生 UI 会话类型 #142025。感谢 @RomneyDa。
- 从模式派生 Matrix 配置类型 #142026。感谢 @RomneyDa。
- 从模式派生 Nextcloud Talk 类型 #142027。感谢 @RomneyDa。
- 从模式派生 Mattermost 类型 #142028。感谢 @RomneyDa。
- 共享激活配置合并 #142045
- 移除一个无效的源加载器选项 #142050
- 整合插件安装元数据分类 #142075
- 移除未使用的插件加载器缓存记录 #142078。感谢 @vincentkoc。
- 移除未使用的看板通知注入输入 #142101
- 移除未使用的插件安装选项转发 #142121
- 从锁句柄中移除未使用的配置路径 #142127。感谢 @vincentkoc。
- 在配额驱逐后避免重新统计插件状态 #142148
- 在编辑输出之间共享分配检测 #142183
- 从缓冲回复中移除冗余的重复跟踪 #142205
- 将插件检查权限与资源生命周期分离 #142214
- 在回复解析期间跳过未使用的 Markdown 扫描 #142220
- 减少代理名册中的临时集合工作 #142229
- 共享会话列表选择逻辑 #142239
- 复用已准备的插件工具清单查找 #142249
- 避免在命令投递时重复准备富回复 #142252
- 减少终端消息中重复的 URL 准备 #142262
- 共享沙箱文件系统操作编码 #142269
- 缩小 Memory Core 的配置导入 #142270
- 避免冗余的 HTTP 会话历史副本 #142309
- 跳过精简提示的未使用设置准备 #142311
- 避免匹配的读取工具文本的重复副本 #142354
- 共享插件注册来源类型 #142359
- 共享 Android 持久聊天发送分发 #142363
- 减少匹配插件命令时的临时分配 #142374
- 当其槽位填满时停止转发头像选择 #142387
- 在历史图像修剪期间避免未使用的副本 #142391
- 在插件规划中复用共享配置扫描 #142396
- 整合等效的 Nodes 分发情况 #142402
- 跳过未使用的 Telegram 草稿前缀准备 #142404
- 从已解析设置派生 Google Meet 类型 #142407。感谢 @RomneyDa。
- 从其模式派生 IRC 配置类型 #142408。感谢 @RomneyDa。
- 共享插件清单和注册表类型 #142409。感谢 @RomneyDa。
- 为 Workshop 存储复用 Gateway 类型 #142410。感谢 @RomneyDa。
- 共享有界的 Web 响应字节读取 #142413
- 避免冗余的聊天代码块准备 #142444
- 减少临时 Discord 格式化分配 #142447
- 避免模型消息准备中的中间数组 #142450
- 移除未使用的基于提示的队列去重 #142455
- 简化额外引导文件加载 #142469
- 减少临时 Swarm 名册集合 #142488
- 在聊天导出期间避免未使用的显示准备 #142491
- 移除未使用的设置回调认证参数 #142494。感谢 @vincentkoc。
- 移除不可达的 Matrix 强制重置重试 #142495
- 共享诊断监听器注册 #142499。感谢 @vincentkoc。
- 整合 Gateway 重启健康状态最终化 #142513
- 复用已准备的 LINE 表格单元格 #142542
- 在聊天渲染期间复用消息准备 #142570
- 共享启动插件成员检查 #142587。感谢 @vincentkoc。
- 简化待处理 tool-result 的记录管理 #142599
- 集中管理 Apple Gateway 错误展示覆盖 #142601
- 共享 Go 和 UV 技能包验证 #142625。感谢 @vincentkoc。
- 提取 Codex feature-list 协议类型 #142648。感谢 @RomneyDa。
- 简化内部状态报告格式化 #142707
- 在 Control UI 页面间共享路由恢复 #142709。感谢 @vincentkoc。
- 隔离 model-policy 整数解析 #142804
- 复用已准备的 provider 所有权元数据 #142818
- 简化出站回复镜像 #142819
- 简化交互式 SDK 导出 #142824
- 减少 media-reference 格式化开销 #142836
- 渲染 HTTP 历史而不产生中间条目副本 #142856
- 移除重复的配置标签准备 #142864。感谢 @vincentkoc。
- 在贡献发现期间复用插件元数据 #142975
- 移除未使用的插件元数据发现回退 #143020
- 在 Claude 插件清单加载中复用已准备的路径 #143027
- 避免冗余的 JSON-mode 调用解析 #143097
- 共享沙箱文件系统参数类型 #143189
- 共享主机桌面状态格式化 #143223
- 整合更新后续接处理 #143269
- 移除过时的 node CLI 超时覆盖 #143330
- 统一 Android 能力审批状态 #143352
- 简化 Synology webhook 主体处理 #143360
- 复用共享的 dreaming 统计类型 #143368
- 共享 Pi 和 Claude 转录范围读取 #143374
- 共享配对节点请求组装 #143380
- 移除未使用的 chat-history 配置参数 #143395。感谢 @vincentkoc。
- 移除重复的 Automations 编辑器状态 #143405
- 统一缺失命令的所有权解析 #143411
- 共享向导 prompt 参数构造 #143430
- 整合 hook-source 选择策略 #143439
- 避免重复的系统消息修剪 #143453
- 复用规范化渠道设置元数据 #143470
- 简化内部 CLI 帮助上下文 #143477
- 避免额外的 Code Mode 诊断数组副本 #143482
- 共享 Doctor 会话迁移验证 #143507
- 复用共享的渠道配置写入器 #143547
- 从校验模式派生沙箱设置类型 #143551。感谢 @RomneyDa。
- 从校验模式派生安装记录类型 #143552。感谢 @RomneyDa。
- 从现有模式派生 Codex 配置类型 #143553。感谢 @RomneyDa。
- 共享 agent 配置模式和类型 #143554。感谢 @RomneyDa。
- 共享 Memory Wiki 报告和索引渲染 #143568
- 集中管理 Policy 文档验证 #143600
- 共享 Comfy 工作流轮询 #143653
- 整合 worker 验证和工作区协调 #143667
- 为助手消息复用共享的 Markdown 渲染 #143706
- 重新导出共享的 provider ID 辅助函数 #143712
- 共享模型目录元数据合并 #143715
- 共享 completion 和 speech-summary 清理所有权 #143716
- 移除冗余的 completion 媒体检查 #143734
- 移除过时的 Discord thread-expiry 回退 #143737
- 整合 Matrix 操作解析和无效操作诊断 #143759
- 共享问题验证和终端状态处理 #143766
- 移除 Doctor 未使用的独立转录写入器 #143772
- 共享已准备的 completion 资源清理 #143792
- 在 UI 中复用 Gateway 会话响应类型 #143803
- 整合 fast-mode 状态构造 #143816
- 共享 thinking-default 策略解析 #143849
- 共享 image-request 资源所有权 #143871
- 共享浏览器操作执行选项 #143887
- 简化迁移停止跟踪 #143912
- 简化推理命令注册 #143920
- 共享桌面渲染输入 #143922
- 共享 Mattermost 反应分发 #143949
- 移除未使用的终端写入器重置 #143969
- 整合 root 选项转发 #143993
- 通过写入行为验证终端关闭 #144007
- 复用模型目录去重 #144012
- 简化 provider 密钥标记恢复 #144036
- 共享实时 Talk 响应类型 #144077
- 在恢复过程中一起携带模型选择 #144088
- 避免通知中未使用的 task-detail 副本 #144115
- 简化压缩设置 #144121
Bug 修复
- 恢复桌面 lint 检查 [#143889](https://github.com/openclaw/openclaw/pull/143889)
</details>
测试可靠性与维护
测试更不容易因时序、残留数据或运行测试的机器而失败。复用测试环境并移除重复检查也能减少贡献者的不必要工作。
来源和完整变更列表
报告的耗时涵盖不同的本地工作负载,不能累加为整个版本的提速。以下仅涉及测试的变更不会在运行中的应用中引入新行为。
改进
- 在 Gateway 测试中复用延迟 Promise 辅助函数 2a4d6a10
- 保持交互式预览操作与夹具状态一致 #138350。感谢 @vyctorbrzezowski。
- 在隔离测试中禁用无关的 catalog 刷新 #141266。感谢 @vincentkoc。
- 测试现有的 Parallels 日志尾部边界 #141470
- 在 catalog-auth 测试中复用 provider 注册表 #141682
- 避免 Kova 身份验证测试中的冗余等待 #141693
- 使终端启动测试与历史记录加载同步 #141704
- 在 config RPC 测试中跳过浏览器资源准备 #141741
- 共享不可达 Gateway 探测测试夹具 #141758
- 清理 security-scan 夹具的 lint 违规 #141778
- 共享 migration-test 快照输入 #141782
- 避免 webhook 交接测试中的空闲连接等待 #141790
- 使 web-search 校验器夹具独立于客户端默认值 #141792
- 简化 Discord 录制测试分支 #141804
- 保持 image-probe 回复匹配器私有 #141823
- 精简 Code Mode 源验证测试矩阵 #141831。感谢 @RomneyDa。
- 精简 CLI 参数测试矩阵 #141832。感谢 @RomneyDa。
- 精简 reasoning-tag 测试夹具 #141833。感谢 @RomneyDa。
- 精简 Control UI 路由测试夹具 #141834。感谢 @RomneyDa。
- 移除未使用的 Comfy 测试夹具选项 #141844
- 合并 model-command 策略测试 #141861。感谢 @RomneyDa。
- 测试 HTML 比较脚本的实际响应限制 #141877
- 简化 Crabbox shell 检测测试表 #141888。感谢 @RomneyDa。
- 简化 Doctor 插件修复测试表 #141889。感谢 @RomneyDa。
- 简化 Active Memory 策略测试表 #141890。感谢 @RomneyDa。
- 简化 message 账户隔离测试表 #141891。感谢 @RomneyDa。
- 合并 Vitest 项目加载检查 #141908
- 在核心测试间共享新的 logger 夹具 #141911
- 移除特定于实现的配置断言 #141919
- 简化 Google 图像测试夹具 #141926
- 通过写入验证播放缓存限制 #141944
- 在插件兼容性测试中使用运行时上下文 #141989
- 在致命 Git 结果测试中使用受控时序 #142009
- 精简 channel 账户辅助测试表 #142029。感谢 @RomneyDa。
- 精简 execution-wrapper 测试夹具 #142030。感谢 @RomneyDa。
- 精简 secrets 运行时测试矩阵 #142031。感谢 @RomneyDa。
- 简化 npm 注册表测试表 #142032。感谢 @RomneyDa。
- 在现有预览中测试滚动重置 #142044
- 在 agent 测试中复用 text 工具结果夹具 #142051
- 添加 Android 分支切换测试场景 #142057。感谢 @vincentkoc。
- 使用真实默认间隔测试 watcher 关闭 #142079
- 简化 inline-command 测试表 #142081。感谢 @RomneyDa。
- 精简 Gateway 网络策略测试 #142082。感谢 @RomneyDa。
- 精简 CLI 配置保护测试 #142083。感谢 @RomneyDa。
- 精简 WhatsApp 格式测试 #142084。感谢 @RomneyDa。
- 共享带时间戳的工具结果夹具 #142094
- 使 Mac 脚本测试与系统 Bash 保持一致 #142096
- 在聊天生命周期测试中复用延迟 Promise #142098
- 简化内存召回超时测试设置 #142108
- 强化 Feishu 权限错误回归测试 #142117
- 复用 xAI 视频响应夹具 #142118
- 移除未使用的 language-hint 测试选项 #142119
- 共享用户和助手消息测试夹具 #142133
- 避免 Doctor 进程测试中的重复编译 #142140
- 为 Code Mode 轮询测试添加有界失败详情 #142157
- 移除重复的 Discord 重试测试 #142177
- 共享带时间戳的助手测试输入 #142184
- 共享 API 密钥凭据测试夹具 #142245
- 共享 OAuth 凭据测试夹具 #142272
- 在测试中验证实际分发的 merge 方法 #142329
- 减少 Telegram Markdown 分块测试夹具 #142365
- 合并重复的 group-policy 解析器测试 #142366
- 在 New Session 测试间共享 cloud-agent 夹具 #142376
- 在 Docker 测试日志中报告安装成功 #142405。感谢 @vincentkoc。
- 移除未使用的 Telegram 编辑测试分支 #142411
- 共享插件安装测试路径检查 #142448。感谢 @vincentkoc。
- 移除不可达的 process-poll 测试分支 #142466
- 合并 memory-flush 测试覆盖 #142478
- 在 message-cleanup 测试中复用已编译的 CLI 代码 #142503
- 移除未使用的 Doctor 配置测试 mock #142507
- 在对齐测试前稳定 composer 动画 #142509。感谢 @RomneyDa。
- 移除冗余的 Matrix QA 场景转发 #142546
- 从 Telegram 观察测试中移除真实超时等待 #142602
- 从 skills 测试中移除未使用的终端 mock #142604
- 移除重复的 deep-transcript 导入压力覆盖 #142614
- 在 release-note 校验器测试中共享 changelog 夹具 #142659
- 澄清实时文件读取测试中的生成标记 #142685。感谢 @RomneyDa。
- 在测试间共享 Discord 操作预期 #142690
- 共享 Codex 生命周期测试夹具 #142732
- 从清理回归测试中移除空闲延迟 #142733
- 简化原生聊天测试夹具 #142757
- 减少存储迁移测试中的插件加载 #142777
- 在迁移测试中隔离插件输入 #142785
- 在回归测试中检查实时会议标题草稿 #142795
- 明确 Signal 测试回复策略 #142796
- 在原生命令测试中复用模型夹具 #142797
- 在测试中共享 Gateway 作用域预期 #142806
- 共享独立回放测试预期 #142816
- 简化会话测试并暴露早期回滚设置失败 #142833
- 共享回复分发测试预期 #142845
- 简化 worker 生命周期测试门控 #142865
-
移除 Swift 轮询测试中的实际截止时间等待 #142882。感谢 @vincentkoc。
- 移除 Mermaid 超时测试中的实时等待 #142886。感谢 @vincentkoc。
- 在 cron 生命周期测试中复用延迟测试夹具 #142887
- 移除重复的 OpenCode Go 元数据测试 #142894。感谢 @vincentkoc。
- 整合重复的设置推理测试 #142899
- 在进程测试中提前 ngrok 启动截止时间 #142903
- 在 service-worker 更新测试中复用构建 #142904。感谢 @vincentkoc。
- 减少 worker-cache 测试中的重复编译 #142911。感谢 @vincentkoc。
- 减少聚焦快速测试的启动工作 #142912
- 减少升级测试配置启动 #142917。感谢 @vincentkoc。
- 复用共享的响应取消测试夹具 #142919
- 共享 Google 网络搜索测试选项 #142928
- 复用 Memory Wiki 源状态测试夹具 #142934
- 共享 agent-turn 测试输入夹具 #142962
- 在 security-scan 测试中复用包测试夹具 #142982。感谢 @vincentkoc。
- 共享 cron 上下文窗口测试夹具 #142985
- 移除重复的 model-usage 聚合测试 #142990。感谢 @vincentkoc。
- 移除冗余的 worker-transform 测试编译 #143009
- 在 release-evidence 测试中复用隔离的 Git 测试夹具 #143014。感谢 @vincentkoc。
- 串行化 worker-transform 测试序列 #143034
- 共享 Codex 上下文引擎测试设置 #143035
- 每个测试套件仅构建一次手机恢复测试夹具 #143046。感谢 @vincentkoc。
- 复用 Doctor 插件修复成功测试夹具 #143047
- 整合重复的 QA Lab image-result 覆盖 #143048
- 移除重复的 warm chat 元数据覆盖 #143059
- 复用已编译的 feature-plugin 测试夹具 #143062。感谢 @vincentkoc。
- 整合 xAI credential-reference 测试夹具 #143075
- 共享 Doctor routing-warning 测试夹具 #143076
- 共享 Memory Wiki session-search 测试夹具 #143084
- 移除过时的 WhatsApp 会话快照覆盖 #143104。感谢 @vincentkoc。
- 复用其余 xAI secret-reference 测试夹具 #143108
- 整合 proof-policy 身份测试设置 #143112
- 复用诊断安装测试包 #143116。感谢 @vincentkoc。
- 整合提供商身份验证优先级测试 #143117
- 移除重复的 MiniMax M2.7 输入覆盖 #143122。感谢 @vincentkoc。
- 共享 status-rendering 测试夹具 #143124
- 缩短 SQLite 超时测试中的故意等待 #143130。感谢 @vincentkoc。
- 在 Testbox 测试中复用 Git 种子设置 #143154。感谢 @vincentkoc。
- 共享 agent-turn 执行测试默认值 #143166
- 移除冗余的 Mistral cache-cost 算术覆盖 #143172。感谢 @vincentkoc。
- 共享 Memory Wiki 可见性测试回调 #143181
- 减少 Telegram 策略测试启动开销 #143192。感谢 @vincentkoc。
- 共享 mcporter security-audit 测试输入 #143209
- 共享 Codex 迁移请求测试夹具 #143221
- 移除重复的 xAI 流测试 #143222。感谢 @vincentkoc。
- 在代理生命周期测试中复用初始证书 #143247。感谢 @vincentkoc。
- 在 Telegram QA 测试中复用已准备的 CLI 工件 #143253。感谢 @vincentkoc。
- 共享 ACP metadata-update 测试设置 #143261
- 减少 test-worker 准备期间的重复清单搜索 #143271
- 移除未使用的 Doctor 目录测试设置 #143272。感谢 @vincentkoc。
- 在代理测试中复用证书设置 #143298。感谢 @vincentkoc。
- 共享 Codex 会话测试客户端 #143300
- 共享 Docker 超时测试夹具 #143309
- 在更新测试中检查权威重启状态 #143316
- 移除冗余的使用成本覆盖 #143318。感谢 @vincentkoc。
- 减少媒体 QA 启动开销 #143326。感谢 @vincentkoc。
- 共享 Feishu 回复账户测试夹具 #143336
- 共享 Docker package-builder 测试夹具 #143338
- 使用真实工作区测试归档安装 #143339
- 在 DeepSeek 测试中复用共享断言 #143346
- 共享 Meta 和 Xiaomi 测试守卫 #143358
- 共享 Feishu 已获取消息测试夹具 #143362
- 复用 Slack 审批测试配置 #143370
- 移除未使用的频道目录测试夹具 #143373。感谢 @vincentkoc。
- 简化 Chutes 测试响应 #143382
- 在路由测试中共享延迟测试夹具 #143383
- 避免回退测试中的冷插件加载 #143392
- 移除冗余的浏览器标注测试 #143402
- 在 Signal 测试中验证真实入站编排 #143412
- 在 MCP 测试中复用已编译的 SDK 测试夹具 #143415
- 在 JSON-error 测试中复用已准备的 CLI #143427
- 移除重复的 Discord 在线状态覆盖 #143435。感谢 @vincentkoc。
- 共享图像资源测试设置 #143443
- 在 worktree 测试中复用原始 Git 种子 #143469。感谢 @RomneyDa。
- 并发运行隔离的 CLI 清理测试 #143481
- 在更新测试中复用 TypeScript 转换 #143487
- 移除不必要的诊断超时测试等待 #143514。感谢 @RomneyDa。
- 在代理退出测试中复用源转换 #143527
- 简化 exec-host 审批测试夹具 #143529
- 共享 Signal 引用测试输入 #143532
- 精简 shell-completion 测试表 #143533。感谢 @RomneyDa。
- 精简 reply-payload 测试矩阵 #143534。感谢 @RomneyDa。
- 精简 CI 并发测试用例 #143535。感谢 @RomneyDa。
- 精简 Labs 配置测试 #143536。感谢 @RomneyDa。
- 共享 Discord REST 代理测试间谍 #143537
- 共享空插件元数据测试夹具 #143544
- 在 cron 输出测试中复用转换 #143559
- 通过 Gateway 发送验证 Teams 超时处理 #143572。感谢 @RomneyDa。
- 共享 QA mock-provider 决策 #143603
- 加强可选 plugin-tool 环境覆盖 #143613
- 在原生 Gateway 测试中复用转换后的代码 #143628
- 收窄 Anthropic cache-check 加载器类型 #143634
- 移除重复的 Teams 线程测试 #143636
- 复用提供商提示错误流测试夹具 #143637
-
整合 Windows CI 检查并增强断言 #143642
- 在向导测试中复用作用域环境 #143652
- 在通道测试间共享运行时 spy 夹具 #143655
- 复用 Gateway 获取测试转换 #143660
- 移除未使用的格式化器夹具目录 #143662
- 简化 DeepInfra 目录夹具 #143680
- 复用 Android 集群测试控制器设置 #143684
- 在插件测试中复用运行时 spy #143690
- 在侧边栏测试中复用存储夹具 #143697
- 移除过时的 Venice 测试环境覆盖 #143720
- 共享 SQLite 索引漂移测试设置 #143749
- 加速 SQLite 快照测试的字节比较 #143751。感谢 @RomneyDa。
- 简化配置测试环境夹具 #143815
- 移除 Responses 传输测试全局变量 #143850
- 移除模型规划器测试钩子 #143851
- 简化图像生成测试夹具 #143862
- 移除重复的 Signal 访问测试 #143870。感谢 @vincentkoc。
- 移除 models-writer 测试管道 #143874
- 覆盖发现过程中的更新权限丢失 #143877。感谢 @fuller-stack-dev。
- 将类型契约移至编译器拥有的检查 #143888
- 共享侧边栏拖拽数据夹具 #143901
- 移除重复的 Telegram 历史记录覆盖 #143904。感谢 @vincentkoc。
- 简化配置环境夹具 #143925
- 移除重复的 WhatsApp 监听器测试 #143962。感谢 @vincentkoc。
- 共享 Memory Wiki 延迟夹具 #143978
- 移除重复的入站音频覆盖 #143996。感谢 @vincentkoc。
- 通过所属辅助函数测试用量认证 #143997
- 复用自动回复 Promise 夹具 #144004
- 在媒体测试中验证共享 HTTP 行为 #144024
- 移除重复的回复取消覆盖 #144028。感谢 @vincentkoc。
- 简化 Discord 目录夹具 #144033
- 将 UI 行为测试与类列表解耦 #144050
- 移除重复的登录 shell PATH 测试 #144051。感谢 @vincentkoc。
- 复用终端延迟夹具 #144058
- 移除重复的元数据作用域测试 #144072。感谢 @vincentkoc。
- 共享 Slack 审批配置夹具 #144076
- 简化源回复测试输入 #144080
- 复用 ClawHub HTTP 测试辅助函数 #144090
- 移除重复的缺失导出器测试 #144091。感谢 @vincentkoc。
- 整合包源更新测试 #144097
- 移除重复的实时认证测试 #144105。感谢 @vincentkoc。
- 在启动测试中复用已编译源码 #144110
- 复用终端上传和队列夹具 #144116
- 整合 Brave 启动夹具 #144117
- 简化 Firecrawl 凭据夹具 #144122
- 移除重复的 CLI 会话清理覆盖 #144126。感谢 @vincentkoc。
- 简化 Quick Chat 测试输入 #144135
Bug 修复
- 在 ACP 测试截止时间前加载浏览器清理 441f69b2。感谢 @Baumus。
- 在 Claw 导出夹具中要求安装已完成 #120843。感谢 @vincentkoc。
- 通过精确消息时间戳查找 Slack QA 展示 #127300。感谢 @RomneyDa。
- 在托管升级测试中要求已完成的服务证据 #141663
- 为 Doctor 测试状态设置显式权限 #141672
- 在多选择测试后恢复 resize 观察者 #141673
- 使遏制测试与真实进程停止同步 #141681
- 保留入门测试安装失败诊断 #141689。感谢 @vincentkoc 和 @RomneyDa。
- 在密钥引用测试中保留 Doctor 写入的配置 #141768
- 在能力提供程序测试中完善清单夹具 #141855
- 隔离插件工件加载器测试夹具 #141887
- 保留排队 QA 回复上的入站引用 #141905
- 对齐插件安装和移除的 QA 预期 #141964。感谢 @RomneyDa。
- 为沙箱 QA 准备 Docker 镜像 #141965。感谢 @RomneyDa。
- 通过 Gateway 登出移除 QA 凭据 #141974。感谢 @RomneyDa。
- 使 Claude QA 夹具与会话初始化对齐 #141978。感谢 @RomneyDa。
- 为 Slack 草稿 QA 选择紧凑进度 #141980。感谢 @RomneyDa。
- 将 Teams QA 超时指向消息活动 #141985。感谢 @RomneyDa。
- 在插件测试拆卸前排空心跳唤醒 #142036
- 将无密钥模型测试与主机凭据隔离 #142049
- 在已稳定工作后完成 mock-provider 续延 #142060。感谢 @RomneyDa。
- 从探测测试中移除端口重用竞争 #142088。感谢 @RomneyDa。
- 更正浏览器夹具中的核心会话状态 #142097
- 将新的 mock 写入场景与先前完成隔离 #142137
- 将模拟的 Chromium 选择与主机设置隔离 #142150
- 在安装程序测试中使用系统 Bash #142161
- 保持规范集成夹具位于源插件上 #142171
- 在 Gateway 测试中等待音频转录完成 #142178
- 在删除夹具前等待分诊测试进程 #142215
- 在 Telegram 贴纸测试前准备提供程序运行时 #142234
- 使认证和 Workshop QA 与当前运行时行为对齐 #142280
- 在贴纸测试中避免不必要的提供程序发现 #142281
- 在拆卸前完成 Activity 测试导入 #142282
- 等待 Gateway 事件日志测试清理 #142314
- 在首次运行恢复测试中等待启动完成 #142339。感谢 @vyctorbrzezowski。
- 使升级测试注册表辅助函数保持同一版本 #142353。感谢 @RomneyDa。
- 在菜单编辑后刷新 Telegram QA 按钮查找 #142473
- 稳定 Windows Claude CLI 测试夹具 #142520。感谢 @vincentkoc。
- 在实时测试中识别不可用的上游模型 #142561。感谢 @RomneyDa。
- 在验证日志中显示嵌套入门失败 #142645。感谢 @vincentkoc。
- 等待已稳定的附件测试几何 #142728
- 在 Linux 上稳定 Android 图像解码测试 #142752。感谢 @vincentkoc。
- 同步云工作者设置浏览器测试 #142763
- 在测试中等待 Signal 投递完成 #142775。感谢 @vincentkoc。
- 在升级测试中验证同版本候选项 #142811
- 使用所选候选项运行打包 QA 命令 #142925。感谢 @vincentkoc。
-
在 token 测试中关闭重新加载的数据库缓存 #142978
- 将 managed-update 测试与主机系统服务隔离 #143013。感谢 @vincentkoc。
- 在模块重置之间关闭 Gateway 测试数据库 #143045
- 在清理期间关闭 skill-upload 测试数据库 #143071
- 稳定 Gateway 压缩竞态测试同步 #143072
- 准备 Gateway 测试启动并保留 Cron 清理错误 #143102。感谢 @vincentkoc。
- 在一个浏览器帧内测量附件布局 #143103
- 在流测试清理完成前等待套接字关闭 #143133
- 为 systemd 测试夹具允许更多启动时间 #143134。感谢 @vincentkoc。
- 隔离 Gateway 预热测试仓库 #143161
- 在删除文件前关闭配对设备测试数据库 #143168
- 在 UI 测试中清理聊天预览监听器 #143191
- 防止 Telegram 模型回调测试中出现过期连接 #143197
- 隔离 Windows 媒体文件 URL 测试提供者 #143213
- 避免 Matrix 引导测试中的慢启动失败 #143249
- 隔离子代理公告测试 #143251
- 在 tmpfs 上稳定 Doctor 源隔离测试 #143258
- 恢复空转录压缩覆盖 #143317
- 在附件布局测试中允许亚像素舍入 #143333。感谢 @vincentkoc。
- 在清理前关闭 Control UI 测试数据库 #143398
- 在清理前关闭配对测试数据库 #143401
- 在清理前关闭 token-store 测试数据库 #143409
- 在清理前关闭节点配对测试数据库 #143418
- 完成捆绑插件目录测试模拟 #143444。感谢 @RomneyDa。
- 同步模型目录浏览器测试 #143445。感谢 @RomneyDa。
- 在扩展测试中允许 Chrome 标签页索引时间 #143447。感谢 @RomneyDa。
- 识别预期的 MCP 解析器测试诊断 #143450。感谢 @RomneyDa。
- 隔离公告测试依赖 #143465。感谢 @vincentkoc。
- 在 QA 检查中识别 Slack 卡片进度 #143562。感谢 @RomneyDa。
- 更正 Telegram QA 回执和预览预期 #143563。感谢 @RomneyDa。
- 独占运行仓库 CLI 健康场景 #143564。感谢 @RomneyDa。
- 更正包卸载断言 #143565。感谢 @RomneyDa。
- 在 QA 中接受有意内存准备诊断 #143570。感谢 @RomneyDa。
- 将 Matrix QA 进度与命令完成协调 #143573。感谢 @RomneyDa。
- 隔离 CLI 公告检查并等待转录回复 #143576。感谢 @RomneyDa。
- 打包 Telegram QA 证据辅助函数 #143582。感谢 @RomneyDa。
- 隔离 Codex 身份验证刷新集成提供者 #143585
- 在删除夹具前关闭心跳测试数据库 #143606
- 修复 worker 设置浏览器夹具 #143666
- 使 QA Lab OpenAI 默认值与规范模型 ID 对齐 #143674
- 更正 Discord 转录提供者断言 #143689。感谢 @RomneyDa。
- 在 ClawRouter 断言前刷新模型目录 #143692。感谢 @RomneyDa。
- 使超时测试与直接 Claude CLI 执行对齐 #143696。感谢 @RomneyDa。
- 更正 Telegram 模型选择器恢复测试 #143704。感谢 @RomneyDa。
- 在测试中等待更新器进程组清理 #143705
- 稳定并发 ClawHub 目录断言 #143710
- 整合配置环境并隔离 Doctor 夹具 #143762
- 在删除夹具前关闭 CLI 测试数据库 #143782
- 在删除夹具前关闭 Watch HTTP 测试数据库 #143793
- 串行化数据库测试 worker 关闭 #143813
- 在浏览器测试中等待最终历史记录占位符样式 #143824
- 隔离旧版交接夹具 #143875
- 恢复配置排空测试集合 #143913
- 隔离 Doctor 运行时夹具 #143919
- 将硬链接夹具保留在同一文件系统上 #143945
- 在测试清理前排空转录索引 #143964
- 对齐依赖锁定导航测试 #144002
- 稳定 Telegram 替换会话测试 #144049。感谢 @crash2kx。
- 协调更新账本测试关闭 #144054
- 恢复完整导航回归防护 #144075
- 在状态移除前排空会话夹具 #144087
- 隔离仅 npm 的 Featured 测试输入 #144092
- 将 Pi 重命名夹具保留在同一文件系统上 #144096
- 将重置测试与环境心跳隔离 #144108
自动化检查和性能测试
自动化检查会在变更仅影响测试时避免无关工作。性能报告还能更准确地测量 CPU 使用率,帮助维护者区分产品回归和测量错误。
来源和完整变更列表
后续的历史 2026.7.33 评估器固定版本随核算修复一起恢复了其 250% 状态允许值。此处尚未确认使用该固定版本成功完成实时资格验证。不确定性跨越阈值的 CPU 测量仍会被阻止。CodeQL 后续修复了此前托管运行器超时路径;这些扫描变更不是漏洞修复。
改进
- 为 CLI 基准测试添加可选的运行时内存归因 #127746。感谢 @vincentkoc。
- 复用已验证的运行器归档并处理 CI 清单增长 #140680。感谢 @vincentkoc。
- 将 macOS CodeQL 迁移到 GitHub 托管运行器 #141761。感谢 @vincentkoc。
- 在其校准修正之前推进历史评估器 #142058。感谢 @RomneyDa。
- 对于仅测试变更跳过无关的升级检查 #142154
- 对于孤立的单元测试变更跳过无关的 UI E2E 作业 #142350
- 将 TUI 测试类型检查移入命令分片 #142385
- 在 CI 测试规划中复用前置条件决策 #142630
- 在 Linux CI 中复用已验证的 Bun 归档 #142849。感谢 @vincentkoc。
- 在 CI 测试和 lint 中复用 Android 构建时间戳 #143207
错误修复
- 更新评估器以处理后期发现的进程 #141675。感谢 @RomneyDa。
- 为文件系统契约测试预置 ripgrep #141794
- 让 macOS 安全扫描在托管运行器限制内完成 #141851。感谢 @vincentkoc。
- 在记分卡构建之间保留堆设置 #141915。感谢 @RomneyDa。
- 将历史状态 CPU 允许值限定到七月发布 #141935。感谢 @RomneyDa。
- 更新性能评估器 CPU 测量固定版本 #142053。感谢 @RomneyDa。
- 更新 Gateway 启动 CPU 核算 #142085。感谢 @RomneyDa。
- 更新性能评估器启动发现 #142104。感谢 @RomneyDa。
- 对失败的性能工件上传重试一次 #142344。感谢 @RomneyDa。
- 更正历史 2026.7.33 Kova 基准测试固定版本 #142348。感谢 @RomneyDa。
- 在受限 CI 上限制 TypeScript 预检资源 #142472。感谢 @RomneyDa。
- 使用更正后的发布 CPU 校准 #142537。感谢 @RomneyDa。
- 在清单变更中保留测试计时估计 #142719。感谢 @RomneyDa 和 @vincentkoc。
- 拒绝过期或不可用的 CI 计时样本 #143182。感谢 @vincentkoc。
- 在 CI 中单独预算延迟翻译目录 #143219。感谢 @vincentkoc。
- 强制每种语言一个延迟捆绑包 #143297。感谢 @vincentkoc。
- 为扩展的测试块保留计时标识 #143639
- 更正发布验证中的 CPU 测量边界 #143808
- 安装搜索测试前置条件 #143835。感谢 @fuller-stack-dev。
构建和包检查
构建和包检查能更好地识别哪些依赖项和文件属于每个发布包。这减少了维护者准备插件并检查其内容时的误报失败。
来源和完整变更列表
准备过程在需要时使用冻结的源清单;已安装包验证保留其自身的清单检查。这些变更本身并不能证明包已发布或在已安装发布中可用。
改进
- 在 npm lock 生成中使用 pnpm 的 override 解析器 #141862。感谢 @RomneyDa。
- 简化包导入扫描 #142859。感谢 @vincentkoc。
- 简化包依赖路径解析 #143063
Bug 修复
- 识别扩展拥有的包依赖 [#141647](https://github.com/openclaw/openclaw/pull/141647)。感谢 [@RomneyDa](https://github.com/RomneyDa)。
- 在 npm 依赖证据中保留版本比较 [#141800](https://github.com/openclaw/openclaw/pull/141800)。感谢 [@RomneyDa](https://github.com/RomneyDa)。
- 验证已构建插件块的依赖所有权 [#141876](https://github.com/openclaw/openclaw/pull/141876)。感谢 [@RomneyDa](https://github.com/RomneyDa)。
- 在包验证中使用源伴随清单 [#142033](https://github.com/openclaw/openclaw/pull/142033)。感谢 [@RomneyDa](https://github.com/RomneyDa)。
- 处理嵌套的可选插件依赖 [#142126](https://github.com/openclaw/openclaw/pull/142126)
- 初始化 ClawHub 引导打包依赖 [#142191](https://github.com/openclaw/openclaw/pull/142191)
- 在包检查中识别 Bun 内置模块 [#143436](https://github.com/openclaw/openclaw/pull/143436)。感谢 [@RomneyDa](https://github.com/RomneyDa)。
- 在 npm 检查中允许随附的 Markdown 指南 [#143699](https://github.com/openclaw/openclaw/pull/143699)
</details>
发布准备与恢复
发布工具使中断的发布更容易调查和恢复。针对旧版本发布的检查与这些版本包含的功能相匹配,而移动发布作业获得构建准备和故障排除的修复。直接从 Git 读取旧版本发布的检查需要 Git 2.45 或更高版本。
来源与完整变更列表
恢复的调度或收集的发布状态是一种观察结果,而不是通过的验证或发布许可。过期的调度见证可能导致恢复未解决,且不同主机不会全局去重。省略的历史场景并非通过的测试。Bun 安装检查在其探测成功时保留 Bun,仅对识别出的 Bun/node:sqlite 拒绝选择 Node;其他失败仍为错误。请求的诊断成熟度记分卡可能在工作流报告失败或受阻结果之前发布。以下先前发布页面和版本元数据仍为历史记录。
改进
- 在发布发布前准备包工件 #136466。感谢 @vincentkoc。
- 添加后来被运行时选择取代的 Node 冒烟路径 #142034。感谢 @RomneyDa。
- 将已发布的 2026.9.3 添加到 Mac 更新源 #142235
- 使 main 与已发布的 2026.9.3 元数据保持一致 #142240
- 使默认 Telegram 包测试与冻结源能力相匹配 #142378。感谢 @RomneyDa。
- 添加手动 Android 模拟器诊断 #142780。感谢 @vincentkoc。
- 捕获模拟器启动诊断 #142809。感谢 @vincentkoc。
- 在模拟器就绪超时后保留诊断 #142835。感谢 @vincentkoc。
- 完成模拟器冷启动诊断 #142891。感谢 @vincentkoc。
- 在响应丢失后恢复发布验证调度 #142927。感谢 @vincentkoc。
- 将 Android 模拟器工作流迁移到 Ubuntu KVM #142979。感谢 @vincentkoc。
- 在发布验证状态旁显示发布观察结果 #143171。感谢 @vincentkoc。
- 拒绝 beta 标签早于稳定版的发布 #143669
- 从已提交源验证冻结发布目标 #144023。感谢 @vincentkoc。
Bug 修复
- 为历史 Node 检查使用已建立的会话测试 #141640。感谢 @RomneyDa。
- 接受已选择加入的历史同版本更新器结果 #141652。感谢 @RomneyDa。
- 更正发布源检查和升级测试选择 #141746
- 使用其随附场景验证冻结发布 #141774。感谢 @RomneyDa。
- 保留冻结发布 Gateway 测试客户端导入 #141814。感谢 @RomneyDa。
- 将冻结发布测试客户端放置在已安装依赖旁边 #141827。感谢 @RomneyDa。
- 为受信任的原生实时测试框架安装依赖 #141829。感谢 @RomneyDa。
- 通过其规范分支获取发布候选历史 #141840。感谢 @RomneyDa。
- 识别七月文件系统验证契约 #141892。感谢 @RomneyDa。
- 保持历史 Docker 验证场景一致 #141893。感谢 @RomneyDa。
- 添加成熟度结果完整性检查 #141931。感谢 @RomneyDa。
- 修复 Gateway 发布测试容量和场景选择 #141954
- 保持冻结升级测试与匹配的辅助函数一致 #142007。感谢 @RomneyDa。
- 将已授权的不受支持 Docker 通道记录为无操作 #142020。感谢 @RomneyDa。
- 在报告 QA 失败之前发布诊断记分卡 #142040。感谢 @RomneyDa。
- 为预检插件计划使用受信任工具 #142055。感谢 @RomneyDa。
- 省略不受支持的历史损坏插件检查 #142061。感谢 @RomneyDa。
- 限制 ClawHub 祖先验证响应 #142072。感谢 @vincentkoc。
- 为插件预览安装受信任工具依赖 #142103
- 防止发布辅助函数弄脏移动源检查 #142115。感谢 @vincentkoc。
- 将 Docker 审批等待保留在发布队列之外 #142250
- 将变更日志署名保留在已验证的发布历史内 #142261。感谢 @vincentkoc。
- 使 Docker 升级测试保持在较旧的起始版本上 #142273
- 在分别运行 npm 和 Docker 恢复后验证收尾 #142291
- 从符号链接检出恢复 Sparkle 构建编号输出 #142315
- 在移动 beta 授权期间处理大型工具归档 #142360。感谢 @vincentkoc。
- 在安装冒烟检查中恢复 Bun 执行 #142428。感谢 @RomneyDa。
- 向冻结安装器测试提供发布 Node 版本 #142431。感谢 @RomneyDa。
- 随着 main 推进保持移动 beta 授权有效 #142432。感谢 @vincentkoc。
- 修复历史升级检查的辅助函数加载 #142441。感谢 @RomneyDa。
- 对齐冻结 2026.7.33 Docker 验证 #142456。感谢 @RomneyDa。
- 使冻结入门测试与发布辅助函数匹配 #142467。感谢 @RomneyDa。
- 记录已审查的 Codex 测试扫描发现 #142474。感谢 @vincentkoc。
- 设置移动 beta 截图前提条件 #142523。感谢 @vincentkoc。
- 使 ClawHub 测试夹具请求与冻结候选相匹配 #142551。感谢 @RomneyDa。
- 将发布 Node 版本转发到 Rocky 安装器探测 #142562。感谢 @RomneyDa。
- 为 Bun 安装检查选择受支持的运行时 #142563。感谢 @RomneyDa。
- 修复冻结包更新验证夹具 #142573。感谢 @RomneyDa。
- 独立获取发布祖先分支 #142643。感谢 @RomneyDa。
- 从选定源推导冻结发布预期 #142683。感谢 @RomneyDa。
- 在冻结发布测试中保留 Git 选择 #142686。感谢 @RomneyDa。
- 使冻结包 Telegram 测试与受支持场景匹配 #142687。感谢 @RomneyDa。
- 更正冻结脏检出退出预期 #142727。感谢 @RomneyDa。
- 针对冻结源限定 Telegram 进度测试 #142731。感谢 @RomneyDa。
- 为 iOS beta 构建准备 Watch Rust 工具 #142762。感谢 @vincentkoc。
- 隔离 iOS 发布签名密钥 #142846。感谢 @vincentkoc。
- 识别不兼容的发布验证证据 #142906。感谢 @vincentkoc。
-
在 Vercel 复制前检查图像大小限制 #142908。感谢 @vincentkoc。
- 使冻结捆绑包验证客户端与源一致 #142926。感谢 @vincentkoc。
- 在已提交源读取错误时停止冻结检查 #142930。感谢 @vincentkoc。
- 隔离冻结套件兼容性检查 #142935。感谢 @vincentkoc。
- 接受原生 iOS 签名钥匙串文件名 #142968。感谢 @vincentkoc。
- 保留 iOS 签名工具环境 #143301。感谢 @vincentkoc。
- 使省略空输入的验证运行一致 #143421。感谢 @RomneyDa。
- 在候选准备中包含必需插件 #143452。感谢 @RomneyDa。
- 针对候选能力验证 Anthropic 缓存行为 #143508。感谢 @RomneyDa。
- 使 Telegram 发布检查与包源一致 #143510。感谢 @RomneyDa。
- 排除未发布的同版本升级基线 #143567。感谢 @RomneyDa。
- 使用已发布插件作为更正版本升级基线 #143681
- 注册 2026.9.4 插件扫描策略 #143807
- 在 Anthropic 缓存检查中加载较旧候选 #143810。感谢 @RomneyDa。
- 使 Telegram 队列验证与候选能力一致 #143811。感谢 @RomneyDa。
- 验证省略的 Docker 测试别名的契约 #144129。感谢 @vincentkoc。
文档
- 刷新发布摘要和贡献记录 685ae1b0
- 添加 2026.9.4 变更日志章节 dd178db5
- 记录最终发布说明已提交时的资格确认 #141786
- 添加 v2026.9.3 发布文档页面 #142277。感谢 @hannesrudolph。
- 使 v2026.9.3 发布页面框架与其公告一致 #142307。感谢 @hannesrudolph。
- 使发布验证指南与说明准备一致 #142328
- 临时重命名 v2026.9.3 统计标签 #142437。感谢 @hannesrudolph。
- 更正 ClawHub 发布验证说明 #142458
- 更正扩展稳定版验证说明 #142538。感谢 @RomneyDa。
- 恢复 v2026.9.3 统计标签 #142541。感谢 @hannesrudolph。
- 按任务组织发布验证指南 #142774。感谢 @vincentkoc。
- 将发布验证文档拆分为聚焦指南 #143163。感谢 @vincentkoc。
- 对未认证的发布检查使用 HTTP 存活检查 #143709。感谢 @vincentkoc。
- 记录已落地的修复和贡献者署名 #144440。感谢 @vincentkoc。
贡献者工具和文档
贡献者在本地检查期间减少重复设置,并获得更清晰的测试指南。文档工具保留代码示例,并将错误指向正确的行。常规 pnpm 安装现在会拒绝指向另一个检出的依赖文件夹的链接。为每个源代码检出提供自己的依赖项,或显式配置依赖位置。
来源和完整变更列表
当生命周期脚本被禁用时,依赖安装防护会被绕过,并且不会锁定以防止并发路径替换。Unix 开发运行器保留中断信号;分离的工作进程可能仍需清理,Windows 保留其现有处理方式。特定于工具的测量并不能证明模型响应更快或总发布时间更短。生成的翻译记录和成熟度快照并不能证明新增语言、可见的应用变更或全面就绪。
改进
- 在 SDK 变更报告中复用 UTF-8 截断 #141660
- 移除未使用的 QA 脚本测试访问器 #141751
- 在不进行无关运行时构建的情况下运行包契约测试 #142159
- 在压缩合并消息中保留人工署名 #142167
- 添加用于带字幕和缩放 PR 视频且无音频的工具 #142259
- 使用原生上下文并保留别名来刷新选定翻译 #142260
- 仅在开发检查需要时加载编译器 #142338
- 移除未使用的更新分诊结果元数据 #142345。感谢 @vincentkoc。
- 减少文档同步源下载 #142400。感谢 @hannesrudolph。
- 移除过时的人员加载翻译数据 #142420
- 合并重复的架构检查器扫描 #142451
- 复用文档检查并在变基后验证 #142475。感谢 @hannesrudolph。
- 减少较大变更中重复的 lint 启动 #142691
- 同步截图测试夹具翻译标签 #142714
- 整合 QA Lab YAML 验证诊断 #143016。感谢 @vincentkoc。
- 在不具备完整构建前提的情况下路由会话历史 HTTP 测试 #143096。感谢 @vincentkoc。
- 移除未使用的全局文档审计索引 #143164
- 在性能测试中复用数字标志解析 #143237
- 明确 CI 监视器进度和超时输出 #143320
- 避免重复的 SDK 导出遍历 #143393
- 跳过不必要的 SDK 防护解析 #143513。感谢 @RomneyDa。
- 共享任务审计摘要计数 #143682。感谢 @vincentkoc。
- 共享死代码扫描编排 #143745。感谢 @vincentkoc。
- 刷新 Skills 屏幕的翻译记录 #143806
- 刷新快照翻译记录 #143914
- 在文档生成期间复用插件元数据 #144120
Bug 修复
- 保持各项目本地测试 worker 数量一致 [#141716](https://github.com/openclaw/openclaw/pull/141716)
- 防止源码安装修改另一个 checkout 的依赖 [#141719](https://github.com/openclaw/openclaw/pull/141719)
- 为编辑拆分文档页面的拉取请求添加标签 [#142677](https://github.com/openclaw/openclaw/pull/142677)。感谢 [@vincentkoc](https://github.com/vincentkoc)。
- 扩展插件文档标签覆盖范围 [#142735](https://github.com/openclaw/openclaw/pull/142735)。感谢 [@vincentkoc](https://github.com/vincentkoc)。
- 跟踪共享的原生翻译输入 [#142786](https://github.com/openclaw/openclaw/pull/142786)。感谢 [@vincentkoc](https://github.com/vincentkoc)。
- 在审计中区分已声明的 ClawHub 路由和未验证的标题 [#143002](https://github.com/openclaw/openclaw/pull/143002)。感谢 [@vincentkoc](https://github.com/vincentkoc)。
- 在隔离检查中允许已批准的 pnpm 历史固定版本 [#143129](https://github.com/openclaw/openclaw/pull/143129)。感谢 [@vincentkoc](https://github.com/vincentkoc)。
- 在脚本和 root-test 更改后审计未使用的导出 [#143268](https://github.com/openclaw/openclaw/pull/143268)
- 在文档格式化期间保留围栏代码示例 [#143394](https://github.com/openclaw/openclaw/pull/143394)
- 在文档错误中报告原始源行 [#143404](https://github.com/openclaw/openclaw/pull/143404)
- 在持续编辑期间检测过期文档 [#143455](https://github.com/openclaw/openclaw/pull/143455)
- 区分被中断的开发运行器和已完成的停止 [#143676](https://github.com/openclaw/openclaw/pull/143676)。感谢 [@shakkernerd](https://github.com/shakkernerd)。
- 在源错误后恢复 locale 导入 [#143776](https://github.com/openclaw/openclaw/pull/143776)
**文档**
- 按任务组织测试指南 [#141221](https://github.com/openclaw/openclaw/pull/141221)。感谢 [@vincentkoc](https://github.com/vincentkoc)。
- 更新成熟度证据和覆盖率报告 [#141910](https://github.com/openclaw/openclaw/pull/141910)
- 将测试指南拆分为聚焦页面 [#141968](https://github.com/openclaw/openclaw/pull/141968)。感谢 [@vincentkoc](https://github.com/vincentkoc)。
- 验证成熟度文档路由和锚点 [#141977](https://github.com/openclaw/openclaw/pull/141977)。感谢 [@RomneyDa](https://github.com/RomneyDa)。
- 更新成熟度记分卡证据 [#142114](https://github.com/openclaw/openclaw/pull/142114)
- 将 QA 自动化指南拆分为聚焦页面 [#142426](https://github.com/openclaw/openclaw/pull/142426)。感谢 [@vincentkoc](https://github.com/vincentkoc)。
- 将实时测试过滤指南链接到其当前页面 [#142560](https://github.com/openclaw/openclaw/pull/142560)。感谢 [@vincentkoc](https://github.com/vincentkoc)。
- 保持 SDK 别名移除待审核 [#142708](https://github.com/openclaw/openclaw/pull/142708)
- 保持常规仓库输出内联 [#142946](https://github.com/openclaw/openclaw/pull/142946)。感谢 [@vincentkoc](https://github.com/vincentkoc)。
- 按测试任务组织实时测试文档 [#143042](https://github.com/openclaw/openclaw/pull/143042)。感谢 [@vincentkoc](https://github.com/vincentkoc)。
- 将 CI 路由指南拆分为聚焦页面 [#143053](https://github.com/openclaw/openclaw/pull/143053)。感谢 [@vincentkoc](https://github.com/vincentkoc)。
- 更新 CI 和插件验证指南 [#143287](https://github.com/openclaw/openclaw/pull/143287)
- 记录临时防御性工作模型路由 [#143698](https://github.com/openclaw/openclaw/pull/143698)
- 整合贡献者指南和子系统所有权 [#143785](https://github.com/openclaw/openclaw/pull/143785)。感谢 [@obviyus](https://github.com/obviyus) 和 [@vincentkoc](https://github.com/vincentkoc)。
</details>
已回退的更改
对会话标记间距的更改已被撤销。以下列出了这两项更改;现有的紧凑左侧栏保持不变。
来源和完整更改列表
改进
- 记录已回退的会话栏间距调整 #142667。感谢 @Patrick-Erichsen。
Bug 修复
- 回退已取消的会话栏间距调整 #142684。感谢 @Patrick-Erichsen。
本页原文 Markdown:在 AtomGit 查看·内容源自开源项目 cl/openclaw