v2026.8.1: 更新与维护
用户有时在更新 OpenClaw 后可能会遇到不稳定的情况。支持的更新路径 现在会在替换安装之前对其进行检查,并阻止不安全的候选版本,同时让之前的 CLI 保持可运行。在 Control UI 中,更新会识别目标、请求确认,并保持进度和最终结果可见。
维护工具现在提供了更清晰的恢复路径。配置错误会指向需要关注的设置,Doctor 专注于问题及下一步操作,新备份会对照受保护的恢复路径进行检查,破坏性清理在所有权不明确时会停止,受支持的重新启动会给被跟踪的工作留出时间,使其在交接前完成。
安装 OpenClaw 更新
在 Control UI 中启动的 Gateway 更新现在会识别目标、要求确认、显示更新和重新启动的进度,并报告最终结果。在符合条件的已签名 Mac 应用上,该流程会先更新应用,然后仅更新应用托管的本地 Gateway;浏览器安装和用户托管的安装则保持仅 Gateway 的更新路径。
受支持的 CLI 更新 会在替换前检查 Node 兼容性、包管理器生命周期规则,以及安装是由 npm、pnpm 还是 Bun 所有。不安全的候选版本会中止更新,同时让之前的 CLI 保持可运行;一次精确的 openclaw update --dry-run 可预览更新路径,而不会更改配置、交接、清理或重新启动状态。
在 Linux 上,代码更新可以保留管理员拥有的服务定义,而不是尝试重写它;不安全或无法检查的服务交接仍然会以可见的方式失败。如果插件替换请求新的能力,OpenClaw 会在替换等待审核期间保留已知可用的插件;openclaw update --accept-capabilities 或 openclaw update repair --accept-capabilities 仅批准该次调用的暂存工件,而 --yes 不会。
有一条升级路径仍然需要手动修复。如果你使用的是 OpenClaw 2026.7.1 和 pnpm 11,请运行一次 pnpm add -g openclaw@latest。OpenClaw 不会为你升级 Node。
来源和完整变更列表
改进
- 添加持久更新卡片和应用优先的 macOS 更新 #104171
- 协调 macOS 应用与托管运行时更新 #107634
- 为 Linux 配套应用添加签名更新 #108770
- 添加安全的扩展稳定版 Docker 频道 #112494
- 允许在支持 node:sqlite 的 Bun 构建上实验性使用 OpenClaw #114256
- 添加定时更新活动和 Updates 设置页面 #120506
- 在安装和重新启动前确认 Control UI 更新 #121234
- 每周刷新移动的 Docker 镜像标签 #123348
- 通过无 blob 克隆加速 Bash Git 安装程序 #123835
- 在 Control UI 中添加类型化更新恢复 #125098
- 弃用 2026.4 之前的兼容路径 #104650
- 使用 SemVer 标准化更新和插件版本排序 #105944
- 让 Linux 开发构建可以选择安装频道 #109242
- 为源码检出 Gateway 服务器添加安全更新路径 #112557
- 为新安装推荐并配置 Node 26 #114399
- 将 Synthetic 迁移为官方外部提供商插件 #116720
- 将 Xiaomi 提供商迁移为官方外部插件 #116861
- 加速开发频道源码更新 #117246
- improve(update): 在注册表之前使用本地 pnpm 包 #130902
- improve(update): 在预检期间复用未更改的依赖工作 #130903
- chore: 将工具和源码安装迁移到 pnpm 12 #131043
- 为 macOS 和 Windows 测试构建添加单独的更新频道 #109244
- 统一插件安装并弃用旧版工作树记录 #114749
- 复用 macOS Gateway 可执行文件搜索路径 #116323
缺陷修复
- 使更新卡片可访问并正确路由 macOS 更新 #104316
- 在不受支持的 Node 版本上保留可用的安装 #106994
- 在升级期间保留 Codex 插件策略 #107285
- 明确 Mac 应用和 Gateway 更新操作 #107793
- 在更新期间保留 pnpm 11 和 Bun 的所有权 #107802
- 在更新期间修复过时的托管 Gateway Node 运行时 #108668
- 在安装期间保留无关的 Node 编译缓存 #113837
- 保持更新试运行真正只读 #114803
- 阻止 macOS 应用替换重试风暴 #114975
- 拒绝符号链接的构建输出根目录 #116705
- 在升级后修复过时的插件宿主包 #118304
- 将扩展稳定版安装保留在其更新频道上 #118518
- 将定向官方插件更新保留在核心频道上 #119799
- 保持 node 宿主在 Gateway 协议 v3 和 v4 之间的兼容性 #119981
- 显示权威的开发检出更新状态 #120769
- 完成大批量稳定版升级而不出现清理停滞 #124651
- 在安装和更新期间明确包生命周期信任 #124727
- 让 npm 安装程序重试保持在请求的频道上 #124778
- 防止 Gateway 轮询停滞和不必要的隐藏标签页刷新 #124891
- 使安装、更新和卸载结果具有事务性 #125992
- fix(update): 保持代码更新在密封服务定义下正常工作 #131021
- fix(plugins): 在升级等待同意期间保持 Gateway 可用 #131290
- fix(update): 保留显式插件能力同意 #131301
- 在 Windows 安装程序中重试一次失败的 npm 安装 8dd204e
- 停止超时的更新程序进程树 #103406
- 从已验证的运行时快照更新托管的 macOS Gateway #104946
- 在核心更新后保留 ClawHub 插件 #105405
- 让 Android 连接到 Gateway 协议 v3 #106205
- 让 Apple node 会话连接到协议 v3 网关 #106294
- 拒绝带有损坏 npm 的 PATH Node 运行时 #107825
- 让 Windows 安装对过时的短 TEMP 路径具有弹性 #108050
- 在 pnpm 和 Bun 更新期间保留可用的安装 #108090
- 让 npm 12 全局更新安全完成 #108100
- 保留官方插件配置并强化 npm 元数据安装 #108336
- 防止 shell 安装程序在停滞的下载上挂起 #108619
- 重新启动受信任的 macOS 应用替换 #108991
- 在核心更新后的交接损坏时安全失败 #109989
- 在更新后 Control UI 样式失败时恢复 #110523
- 为固定版本的 npm 插件报告较新的版本 #111169
- 验证托管更新并将 Skill Workshop 保持在移动屏幕内 #112987
- 在构建后保持源码检出更新干净 #113094
- 在插件安装后修复旧版频道配置 #113317
- 在升级期间修复旧版插件配置 #113324
- 拒绝不完整的 Git 安装程序检出 #113809
- 防止包清理删除必需的运行时模块 #113821
- 将托管 Gateway 更新保留在所属配置文件中 #113901
- 完成 ClawHub 插件清理并解除立即重试的阻塞 #114090
- 展示手动 Linux 更新检查结果 #114312
- 将批量官方插件更新保留在已安装的 beta 频道上 #115083
- 在全新 CLI 中完成包和 git 源码切换 #115292
- 在变更之前拒绝无效的插件安装 #115427
- 让 macOS Dev 源码安装完成冷构建 #116072
- 使用可用的 TypeBox 版本恢复安装 #116333
- 在更新后保留已配置频道的插件访问 #116540
- 在 Git 更新失败后恢复可运行的构建 #117294
- 拒绝未知的定向插件更新 #117333
- 拒绝循环插件市场别名 #117440
- 防止更新试运行更改本地状态 #118856
- 如实报告 Windows 迁移检查失败 #120033
- 修复跨操作系统发布检查与旧版节点元数据 #120442
- 确保固定版本的 dev 更新活动在重启后继续运行 #121328
- 保持自动更新倒计时稳定 #121504
- 如实显示 Gateway 更新进度与结果 #121686
- 避免更新期间重复安装插件 #122161
- 防止过期状态进入更新后的收尾阶段 #122309
- 阻止捆绑插件的启动收敛循环 #122871
- 在保留式重装后恢复插件 CLI 访问 #123043
- 升级后安装外部化的已配置插件 #123399
- 拒绝不可用的本地前缀安装 #123716
- 确保 Codex 插件与 OpenClaw 稳定版升级保持匹配 #124209
- 在自动 dev 更新之间强制执行统一的冷却期 #124626
- 统一安装、启动和 worker 中的 Node 版本检查 #124812
- 防止失败的 Git 克隆污染安装目录 #124872
- 在安装开始前拒绝无效的 Windows 安装程序选项 #124882
- 恢复 npm 11.13 至 11.15 上的安装与更新 #125452
- 在较慢的 Git 拉取后调度 dev 更新 #125705
- 在受管 Gateway 交接前验证目标配置 #126270
- fix(doctor): 在启动迁移前修复插件宿主链接 #126830
- 仅在必需检查通过后报告 Unix 安装程序成功 #126871
- fix: 在 beta Gateway 上安装官方插件时会安装稳定版 #127791
- fix(update): 使用准备好的 Gateway 安装身份 #128187
- fix(update): 拒绝不完整的 Control UI 包 #128825
- fix(update): 将受管交接绑定到精确目标 #128868
- fix(plugins): 使市场安装具备事务性 #129266
- fix(update): 将自定义 Bun 全局更新保留在原始安装中 #129589
- fix(release): 规范化软件包 tarball 模式并验证非 root 安装 #130335
- 修复链接 hook 与嵌套包发现 #130813
- fix(installer): 避免在固定版本安装期间检出错误的 Git 引用 #130907
- fix: 当 Web UI 仍在提供旧构建时,Git 更新可能报告成功 #130957
- fix(update): LaunchAgent 刷新不再自我标识为 Gateway #131013
- fix(update): 在软件包重启期间保持插件收敛 #131062
- fix: 完成刷新失败时,交互式更新可能使 Gateway 保持停止状态 #131393
- fix(update): 切换到 dev 时避免声明构建超时 #131746
- fix(update): dev 升级会耗尽小型 POSIX 临时文件系统 #132085
- fix(doctor): 在外部插件安装后修复频道配置 #132446
- fix(installer): 恢复按提交固定的源码安装 #132458
- fix(installer): 防止源码引导程序重写 pnpm 元数据 #132608
- fix: 防止在脏回滚构建后重启 #132813
- fix(doctor): 在稳定版升级期间保留健康修复 #132934
- 在清理前验证按 profile 作用域的 macOS 更新程序任务 #97264
- 在失败后清理 CLI 安装程序的临时文件 #103725
- 在命令完成后移除安装程序的临时文件 #104049
- 恢复 7 月发布保护与当前 main 分支验证 #107462
- 在 Mac 应用单独更新后隐藏更新指南 #108034
- 当 registry 响应体停滞时限制更新检查 #108606
- 防止停滞的 Windows 安装程序下载永久挂起 #108791
- 在执行前限制沙箱安装程序下载 #108805
- 拆分插件更新并保留回退安装策略 #108877
- 处理实时更新程序锁创建竞态并稳定工具测试 #109877
- 在安装期间验证 ACPX 原生适配器包 #111682
- 为协议不匹配添加一键刷新 #111772
- 对无法比较的 Git 历史隐藏更新分歧 #111946
- 正确报告 Windows 源码 UI 构建失败 #112053
- 在源码检出中保持版本化插件安装以 registry 为后端 #112829
- 在更新状态中识别 Bun 文本锁文件 #114416
- 为 Twitch 包使用受管运行时依赖 #115147
- 在 Control UI 中标记 beta 更新 #115518
- 在定向插件更新中遵循已配置的频道 #115604
- 恢复旧版 Docker apt 包回退 #116466
- 在暂存式全局更新中接受 npm 范围与标签 #116585
- 当本地更改阻止更新时返回失败 #117452
- 正确检测无锁文件的全局 Bun 安装 #118143
- 允许在不可变 Nix 模式下进行插件更新预览 #118431
- 在源码构建期间选择正确的 root-help 捆绑包 #119590
- 正确处理消失的更新程序进程组 #119614
- 在插件修复期间保留启动版本 #120085
- 在更新后淘汰捆绑插件的过期受管影子 #121261
- 在交接检查失败后保持 dev 自动更新运行 #121664
- 让更新后的插件在验证前迁移旧版配置 #122199
- 恢复对分离 HEAD 的 Dev 检出的更新跟踪 #122415
- 在目录更改后保持相对路径 CLI 安装正常工作 #122626
- 从构建缓存中移除过期的 Plugin SDK 声明 #122837
- fix(update): 将存储的 dev 频道路由到 git 更新流程 [AI 辅助] #123083
- 从版本管理的启动器更新时找到正确的检出 #123197
- 如实报告 Linux 构建工具安装失败 #123817
- 在 Control UI 中拒绝空白的必填更新字段 #124264
- 为分离的开发安装报告准确的更新状态 #124611
- 不再将有效的依赖安装报告为过期 #124627
- 识别具有延迟 PATH 刷新的成功 Windows 安装 #124678
- 将更新程序迁移推迟到更新即将进行时 #125124
- 停止辅助程序时保留已提交的插件更新 #125150
- 仅在插件更新提交后报告 #125739
- 当包用户请求
--tag main时快速失败 #125949 - 重建不完整的受管更新缓存命中项 #125954
- 保持默认插件槽位隐式 #126442
- fix(plugins): 插件更新将版本降级报告为成功更新 #127874
- fix(cli): 已安装的 hook 包无法通过 npm 包名更新 #128281
- fix(installer): 在另一个检出内遵循显式 git 目标 #128407
- fix(install): 在 npm 验证失败时保留 Git 命令 #128502
- fix(plugins): 当 Git 插件的包版本未更改时报告更新 #128841
- fix(update): 当最终 HEAD 验证探测出错时使 git 更新程序失败 #129036
- fix(cli): 在 Bun 1.4 下无警告过滤器启动 #129142
- fix(docker): 修订版镜像报告其完整版本 #129178
- fix(update): 在更新状态中保留 registry 失败信息 #130931
- fix(cli): 在更新状态上拒绝不支持的继承 --dry-run #132195
-
fix: 重启后的 Gateway 启动期间 git 更新失败 #132879
-
fix: 移除重复的安装收尾延迟 #133190
文档
配置错误与服务修复
错误的配置现在会以有用的提示信息停止运行,而不会悄悄用其他设置启动 OpenClaw。打包构建、CLI 检查、服务预检和 Gateway 启动会显示文件、行号、完整设置路径、可用的允许值,以及所收到内容的脱敏版本;格式错误的顶层标量文件会安全失败(fail closed),而不是加载默认值。
如果你要升级的配置仍包含已退役的键,请在 2026 年 9 月 18 日之前运行 openclaw doctor --fix。Doctor 会在新旧键冲突时保留规范值,并移除不再起作用的设置;不过,明确退役的调优值会恢复为内置默认值。
受支持的 Gateway 服务修复会保留已安装的状态目录、配置路径、端口、受管环境和符合条件的基于文件的凭据,而不会静默地重新指向该服务。如需有意更改这些目标,必须运行 openclaw gateway install --force;在 Linux 上,服务命令还会拒绝冲突的用户单元和系统单元,并显示哪个单元拥有该 Gateway。
来源与完整变更列表
改进
- 为隔离的多租户托管添加 Fleet 单元 #104527
- 强化 Fleet 单元创建与操作员指南 #104814
- 为 Fleet 单元添加备份、限制、出口控制和诊断 #104828
- 精简并标准化配置面 #111142
- 移除仅用于调优且具有稳定内置默认值的配置旋钮 #111382
- 整合 OpenClaw 配置与旧版迁移 #111527
- 在网关之间切换 macOS 仪表盘 #113965
- 将代理并发扩展至主机 CPU 规模 #114047
- 将 macOS 网关设置移入仪表盘 #115999
- 添加实验性的 Cloudflare Containers 部署模板 #122768
- 添加受管的 macOS 提权主机工作流 #123569
- feat(daemon): 支持 Bun 1.4 受管服务 #129593
- 添加由 supervisor 持有的 Fleet 单元日志流 #104669
- 让配置验证错误更易于定位 #106526
- 退役冗余的配置设置 #113174
- 退役过时的诊断配置结构 #113946
- 在 Mac 菜单中添加多网关控制 #114038
- 在 Mac 侧边栏页脚中显示活动 Gateway #114059
- 减少重复的 macOS 配置轮询工作 #115886
- 移除不受支持的环境变量覆盖 #105970
- 精简原生 macOS Gateway 选择器 #115977
- 刷新当前网关设置的原生翻译 #118356
Bug 修复
- 停止过时设备配对的累积,并统一 Nodes 清单 #102810
- 在打包构建中恢复详细的配置错误 #104026
- 修复 Windows 网关启动器对 CJK 配置文件路径的支持 #107751
- 在省略压缩模式时恢复回复 #114759
- 防止网关修复重新指向受管服务 #115935
- 让配置补丁仅删除请求的数组条目 #116463
- 在捆绑渠道中接受文档所述的 configWrites 设置 #117206
- 在服务更新期间保留基于文件的网关凭据 #120458
- 在重新安装失败期间保持 macOS Gateway 受监管 #120699
- 在升级后停止误报服务过时警告 #120702
- 让配置验证错误具备可操作性 #124763
- 在首个配置文件存在之前应用文档所述的默认值 #125110
- feat(gateway): 在启动时自动应用安全的 doctor 配置迁移 #132135
- 从网关服务密钥中恢复 macOS 仪表盘认证 #101375
- 确保继承值不被写入配置 #102231
- 在登录启动后保持 macOS 应用运行 #102465
- 停止已取消的 Gateway 配置读取 #104093
- 拒绝 OC Path 中过大的多字节 JSONC #104140
- 让 macOS LaunchAgent plist 可被 launchd 读取 #104228
- 遵循代理目录的文件系统大小写规则 #105402
- 在配置合并中保留嵌套默认值 #105953
- 在瞬时故障后重试配置快照 #106105
- 在配置加载失败后恢复环境变量 #106181
- 在 OC Path 插入期间保留 JSONC 格式 #106858
- 将 Fleet 日志固定到已验证的容器代次,并修复恢复指南 #106918
- 保持显式 Gateway 回环绑定的规范性 #107731
- 让被抑制的网关保持静默,并让 Web 终端保持可交互 #108871
- 修复 Windows 启动器对非 ASCII 配置文件路径的支持 #108967
- 拒绝括号段之后的歧义配置路径 #109580
- 当已运行的 Gateway 需要重启修复时发出警告 #110583
- 在配置向导探测期间忽略空白的网关凭据 #113096
- 在升级后保留 Control UI 问题访问 #113153
- 修复 iOS 上忘记已配对网关的问题 #114083
- 为包含的配置写入保留确切的所有权 #114251
- 拒绝歧义配置补丁并纠正认证断开 #115579
- 在 Doctor 清理期间保留配置包含 #115723
- 防止 Doctor 写入不支持的扩展渠道配置 #116025
- 阻止冲突的 systemd 网关安装 #116162
- 让网关启动恢复崩溃循环的 systemd 服务 #116178
- 防止通配符配对路由导致 Gateway 升级崩溃 #116610
- 保留配置试运行错误并拒绝空批次 #116833
- fix(bootstrap): 在启动 TLS 环境中将空白的 NODE_EXTRA_CA_CERTS 视为未设置 #117317
- 在生成的 systemd 单元中保留引号和反斜杠 #117375
- 在 Gateway 重新安装期间保留自定义 CA 信任 #117944
- 保留外部的 macOS 远程 Gateway 配置编辑 #118046
- 迁移冗余的原生 Codex 服务层级 #118738
- 在 macOS 状态中显示远程 Gateway 认证失败 #118841
- 让 macOS 网关恢复在无标签的系统 plist 下也能正常工作 #119091
- 在 systemd Gateway 重启时应用受管的 dotenv 更改 #119441
- 让 Linux systemd 单元清理报告失败,并重新加载已移除的旧版单元 #120027
- 生成有效的广域 DNS 配置 #121392
- 要求受管服务使用经过验证的 Node #122070
- fix(infra): 防止在主目录波浪号扩展中发生 $-pattern 注入 #122991
- 在更新失败时保留有效的 CoreDNS 区域 #123928
- 拒绝格式错误的标量配置文件,而不是加载默认值 #124945
- 区分缺失的环境引用与字面占位符 #125455
- fix(doctor): 在容器环境中跳过主机服务管理 #125796
- 显示原生重连、Gateway 链接和通知的结果 #125909
- fix(macos): 防止无效的 Gateway 端口导致远程连接崩溃 #128260
- fix(systemd): 报告被 drop-in 替换的服务命令 #128604
- fix(systemd): 遵循生效的 drop-in 配置 #129170
- fix(doctor): 保留受管的容器服务 #129527
- fix(daemon): 防止 macOS 节点启动因继承的编译缓存而挂起 #130097
- fix(daemon): 保留结构化命令终止结果 #130634
- fix: 当中断状态无法授权清理时保留 systemd 单元 #131080
- fix(cli): 在通道认证期间保留用户编写的配置 #131117
- fix(channels): 在设置期间保留用户编写的配置 #131235
- fix(config): 保留按索引和整表进行的 agent 编辑 #131369
- fix(channels): 从生成的元数据中单一来源化捆绑的通道模式 #131564
- fix(config): 应用批次时忽略已丢弃的 SecretRefs #131656
- fix(daemon): 当工作目录不可读时,node 安装将受支持的 Node 运行时误报为不受支持 #131998
- 将引导客户端连接到自签名 WSS 网关 #80204
- 安全解决冲突的 Linux 网关服务 #91221
- 为特定 Gateway 绑定保留安全的本地仪表盘访问 #98479
- fix(irc): 移除未使用的 mentionPatterns 配置 (#119356) 0612928
- 在配置提示中保留完整的 Unicode 字符 #102512
- 在无效配置快照后恢复环境 #103786
- 正确渲染 identity-avatar 数组索引 #104935
- 拒绝已弃用的无操作配置键 #106031
- 在配置写入剥离 JSON5 注释前发出警告 #107604
- 将 APNs 中继超时解析为十进制值 #107883
- 忽略空白的 Synology Chat 账户令牌 #108922
- 忽略空白的 Google Chat 服务账户环境值 #108948
- 限制旧版 macOS launchd 清理 #109116
- 使用生效的守护进程端口标志 #109294
- 忽略空白的 Synology Chat 环境回退值 #109495
- 在受速率限制的 Gateway 认证错误中包含重试时机 #109630
- 在截断的配置验证错误中保留表情符号 #109664
- 安全拒绝无效的 Gateway TCP 端口 #109875
- 忽略空白的 APNs 中继超时覆盖值 #110677
- 在设置期间拒绝不可用的 Tlon URL #111099
- 修复 doctor 中的活动配置文件和配置位置 #111555
- 在重新验证后保持捆绑的 provider 覆盖层有效 #112334
- 拒绝并安全迁移 sandbox 浏览器的 network none 设置 #115250
- 防止 macOS DNS 设置在 Homebrew 探测时挂起 #115782
- 在 macOS 仪表盘中隐藏重复的 SSH 网关 #115963
- 在配置提示中接受文档 URL #116063
- 在 Gateway 认证后恢复 macOS 仪表盘 #116080
- 拒绝配置路径中的尾部转义字符 #116738
- 修正 Linux systemd 服务环境解析 #117484
- 恢复全新的开发网关启动 #118003
- fix(cli): 拒绝 config set/batch/patch 值中的 Infinity/NaN #120156
- 允许 macOS 网关修复跳过不可读的外部守护进程 #120481
- fix(config): 在生成的配置模式中保留核心 channels 的键 #120736
- 拒绝空白的配置区块过滤器 #121145
- 避免对未更改的配置给出重启提示 #122953
- 让 config.patch 失败时说明可行的下一步操作 #124127
- fix(dns): 在偏移和翻转期间保持广域 SOA 序列号单调递增 #124144
- 在 Doctor 中显示旧版配置复制失败 #124948
- 当写入后重新读取配置降级时发出警告 #125075
- 将本地 CLI 认证错误指向本地网关凭据 #125488
- 让 config unset 在路径缺失时失败 #125958
- fix(cli): 让 config get 区分拼写错误与未设置的键 #127369
- fix(cli): 告知操作员竞争性的 config set 未更改任何内容 #127554
- fix(config): 诊断不可写的配置目录,而不是泄露 EACCES #127703
- fix(config): 诊断权限时通过符号链接匹配配置目录 #127734
- fix(macos): 转义所有登录 LaunchAgent plist 路径 #128378
- fix(config): 当配置缺失时完成运行时覆盖 #128600
- fix(daemon): 检测生效的 systemd 服务覆盖 #128705
- fix(doctor): 将已弃用的 bindings match.peer.kind dm 迁移为 direct #130553
- fix(config): 写入时省略未编写 agent 的父级 #131413
- fix(daemon): 解释不安全的服务发布失败原因 #132279
- fix(doctor): 当服务修复被拒绝时保留配置 #132375
- fix(state): 在规范修复后标记未设置的应用版本 #133225
- 恢复跨平台 SSH 网关探测 #93030
- 移除不支持的 diagnostics OTel gRPC 配置 #93087
文档
- 添加 Daytona 云沙箱托管指南 [#116411](https://github.com/openclaw/openclaw/pull/116411)
- 替换文档中已退役的配置键 [#121330](https://github.com/openclaw/openclaw/pull/121330)
- 保持文档中的配置示例与 schema 对齐 [#121336](https://github.com/openclaw/openclaw/pull/121336)
- 完善 Cloudflare 部署操作指南 [#122932](https://github.com/openclaw/openclaw/pull/122932)
- 修正不安全且无法正常工作的托管指南 [#122971](https://github.com/openclaw/openclaw/pull/122971)
- 澄清缺失的 `config unset` 目标行为 [#126036](https://github.com/openclaw/openclaw/pull/126036)
- 澄清 Fleet 的当前范围(不使用 MVP 框架表述)[b573a3b](https://github.com/openclaw/openclaw/commit/b573a3b)
- 使配置文档与已退役的键及当前默认值对齐 [#113956](https://github.com/openclaw/openclaw/pull/113956)
- 修复自定义 Control UI 主目录示例 [#114594](https://github.com/openclaw/openclaw/pull/114594)
- 修正时区配置指南 [#116102](https://github.com/openclaw/openclaw/pull/116102)
- 修正文档中已退役的 Gateway 重载设置 [#116975](https://github.com/openclaw/openclaw/pull/116975)
- 添加稳定的私有 Gateway URL 指南 [#118340](https://github.com/openclaw/openclaw/pull/118340)
- 记录 Cloudflare Tunnel 和 Access 部署 [#126029](https://github.com/openclaw/openclaw/pull/126029)
- docs: 使 Linux 主机调优与托管的 systemd 策略保持一致 [AI 辅助] [#128752](https://github.com/openclaw/openclaw/pull/128752)
- docs(gateway): 澄清独立的 HTTP 端点开关 [#130690](https://github.com/openclaw/openclaw/pull/130690)
</details>
OpenClaw 重启与运行中的工作
在受支持的快照或定向重启之前,Gateway 的挂起和恢复可以暂停新的普通工作、报告阻塞项,并排空 OpenClaw 已跟踪的代理运行、交付、计划任务、队列、会话和后台命令。配置重载失败时保留之前的一致状态,快速配置写入会保留待处理的重启意图而不会将其丢弃。
重启后,健康检查、代理列表和核心控件在可选的目录、插件和迁移工作完成之前即可使用。该工作被推迟而非移除,因此首次显式目录请求仍可能需要更长时间。
等待覆盖 OpenClaw 跟踪的工作。新的通道或外部入口流量、现有插件连接、未注册的后台工作以及传入消息的持久化接收均不在此范围内,外部监管的安装必须接管交接并自行完成重启。
来源与完整变更列表
改进
- 为主机快照添加协作式 Gateway 挂起 #103618
- 加速同版本构建的 Gateway 重启 #105099
- 加速 Gateway 冷启动和首次代理轮次 #105801
- 加速全新且插件密集的 Gateway 启动 #106195
- 支持外部监管的 Gateway 重启 #109162
- 保护 Gateway 生命周期命令免受意外中断 #110323
- 推迟非活动插件运行时以加快 Gateway 和代理启动 #119733
- 允许在 Gateway 终端打开时继续执行更新 #121601
- 启动全新 Gateway 时消除遗留迁移延迟 #121639
- 添加可用的 Gateway 挂起和恢复命令 #122100
- 添加与通道无关的 Gateway 启动探针 #122477
- feat(gateway): 添加可续期的协作式挂起排空 #130003
- 减少就绪前的 Gateway 启动工作 #105913
- 使 Gateway 重启恢复由 SQLite 持有且可安全重放 #110014
- 通过无状态插件路径更快启动全新 Gateway #115578
- 在 Gateway 重启恢复期间跳过非活动会话存储 #117498
- 在模型准备之前标记已放弃的会话 #117544
- 在 Gateway 启动期间跳过空的按代理会话数据库 #117589
- 降低 Gateway 重启后的冷首轮延迟 #120809
- 推迟非启动所需的 Gateway 导入 #121780
- 减少重复的 Gateway 日志记录和交付工作 #126147
- 将 Gateway 启动时的模型目录规划范围限定为已配置的模型 #127117
- perf(gateway): 为定向连接建立索引 #128198
- improve(gateway): 将 macOS 系统 CA 预热与启动重叠执行 #128422
- improve(gateway): 降低热会话维护延迟 #128513
- 移除过时的 macOS Gateway 启动探测 #121439
- 减少重复的重启恢复扫描 #125712
- perf(gateway): 减少会话事件交付的文件系统工作 #132439
- improve(gateway): 减少空闲工作进程的启动内存占用 #133176
Bug 修复
- 在重启后可靠地重新启动 macOS Gateway #104637
- 使 Gateway 热重载具备事务性 #105289
- 防止 Gateway 永久卡在排空模式 #107339
- 在终止前验证 Windows Gateway 监听器所有权 #108023
- 增强对网络错误、会话 ID 和扩展加载的健壮性 #110196
- 防止 macOS 重载重启使 Gateway 陷入停滞 #110213
- 防止 macOS Gateway 在 TLS 设置期间启动冻结 #111473
- 为凭据迁移预检 Gateway 重启 #114715
- 完成失败的 Gateway HTTP 响应,避免客户端挂起 #116874
- 防止 macOS Gateway 重启使 LaunchAgent 陷入停滞 #116875
- 允许早期 Gateway 探测在后台启动工作之前运行 #117083
- 使大历史记录的 Gateway 在重启后保持响应 #117108
- 使大历史记录的 Gateway 在重启后保持响应 #117118
- 防止心跳设置阻塞 Gateway 启动 #117992
- 在 Gateway 关闭和重启时清除过期的运行时状态 #118271
- 防止停滞的实时更新导致 Gateway 离线 #119116
- 阻止智能体名册请求阻塞 Gateway 启动 #119208
- 防止队列丢弃策略更改后出现 Gateway 停滞 #119331
- 避免聊天元数据延迟其他 Gateway 请求 #119369
- 阻止就绪后的会话目录工作使 Gateway 停滞 #119377
- 在上下文缓存预热期间保持 Gateway 请求响应 #119562
- 减少多智能体轮次后的 Gateway 停滞 #120075
- 当重启状态无效时保持 Gateway 可访问 #120966
- 在并发轮次期间保持 Gateway 控制响应 #123608
- 防止受监管的重启迁移实时 Gateway 状态 #123920
- 显示 Gateway 启动进度并强化生命周期清理 #124309
- 防止大型退役智能体注册表卡住 Gateway #124516
- 在持续轮次下保持 Gateway 就绪响应 #124528
- 停止 macOS 空闲节点设置时的 CPU 循环 #124599
- 在直接停止前排空所有活动的 Gateway 工作 #126024
- 避免升级后出现 Tailscale 重启循环 #126069
- 保留受管理的 Tailscale Funnel 的访问和清理功能 #126519
- fix(gateway): 修复认证绕过缓存和配置重载中插件元数据生命周期的过期问题 #127664
- perf(gateway): 修复并发会话下每会话热路径导致的事件循环队头阻塞 #129135
- fix(gateway): 在重负载下保持已加载对话的响应性 #130071
- fix: 在重复的 Gateway 重启之间恢复活动会话 #131527
- fix(gateway): 在事件循环停滞期间保留活动轮次 #131966
- fix(codex): 在最终轮次通知停滞时强制有界结算 #132413
- fix(gateway): 阻止较新数据库模式的重复重启循环 #132916
- 在受控 Gateway 退出前释放启动迁移租约 #103157
- 在 Gateway 重启期间保持会话挂起安全 #103211
- 从停滞的连接中恢复无界 Gateway 请求 #103407
- 防止在受管理的软件包更新期间 Gateway 重新生成 #103537
- 检测传输断开后挂起的频道运行 #103793
- 保持重命名检出目录的 macOS Gateway 继续运行 #103972
- 将插件 HTTP 工作纳入 Gateway 挂起就绪检查 #104112
- 在挂起准入范围内保持重连交付恢复 #104143
- 在挂起或重启前等待后台命令完成 #104172
- 在重启期间强制停止停滞的受管理 Mac 应用进程 #104268
- 在 Gateway 重载和关闭期间协调频道恢复 #104811
- 使 Gateway 挂起等待已接受的节点工作 #105134
- 修复受管理 Gateway 端口漂移和 Crestodian 清理错误 #105153
- 在其活动端口上重启不受管理的 Gateway #105241
- 防止启动迁移期间误报重启失败 #105544
- 在横幅动画期间启动 Gateway #105774
- 在 Gateway 关闭前完成会话结束钩子 #105848
- 将上下文缓存预热推迟到 Gateway 就绪之后 #106117
- 保持全新 Gateway 启动快速且迁移安全 #106282
- 热应用工作树清理限制的更改 #106525
- 在 Gateway 生命周期之间清除重启和挂起状态 #106691
- 在 macOS Gateway 重启期间遵循仅附加模式 #107402
- 防止 Gateway 重启期间出现重叠的 Signal 守护进程 #107409
- 停止 Bonjour 自探测重试循环 #107710
- 当不需要 Gateway 工作时跳过 macOS 更新后时间窗口 #108146
- 限制 Gateway WebSocket 打开等待时间 #108348
- 限制并分阶段处理 Gateway TLS 证书生成 #109139
- 防止外部监管的 Gateway 重启超时 #109273
- 在观察者错误恢复后保持配置热重载有效 #109682
- 当 Web 提供方的 SecretRef 失败时保持 Gateway 运行 #109687
- 在信号错误后继续清理过期的 Gateway #109702
- 避免误报 macOS Gateway 重启失败 #109955
- 将缺失的媒体凭据隔离到受影响的模型 #110042
- 当启动迁移拒绝就绪时干净地退出 #110207
- 在合并的配置写入中保留重启意图 #110397
- 审计跨平台的受管理 Gateway 服务启动 #110497
- 在观察者恢复后重新加载外部配置编辑 #111049
- 当 Windows ComSpec 为空时回退到 cmd.exe #111260
- 热重载来自包含的配置文件的更改 #111511
- 在信任初始化期间保持 macOS Gateway 启动响应 #111533
- 在 Linux 更新期间修复继承的跨用户 D-Bus 设置 #111534
- 对于仅涉及 PATH 的通知,保持健康的 macOS Gateway 运行 #112381
- 防止 Gateway 在无法访问的固定地址上崩溃 #113905
- 保留 Linux Gateway 控件的点击顺序 #114291
- 在本地化的 Windows 上可靠地停止空闲的计划任务 #114434
- 防止已完成的嵌入式运行增大 Gateway 内存占用 #114767
- 在 cron 失败后保持 Gateway 拆除继续执行 #114848
- 在临时套接字设置失败后重新连接 Gateway 节点 #115539
- 防止配置大量模型时出现启动超时 #116039
- 在重连后重置 Gateway 事件顺序 #116043
- 对重复的 macOS Gateway 连接失败进行退避 #116114
- 防止过期的 macOS 远程 Gateway 隧道重启 #116172
- 为 WebSocket 升级返回有效的速率限制响应 #116557
- 避免在 Tailscale Serve 后误报 Gateway 端口占用 #116579
- 保持自定义端口 Docker 容器健康 #116639
- 将独立的 MCP App 工作纳入 Gateway 排空 #116727
- 验证守护进程启动和安装结果 #116815
- 取消已断开的 Gateway 请求并保留响应错误处理 #116835
- 允许实时更新后 Gateway 就绪变慢 #117032
-
允许 Gateway 重启期间 macOS 监听器扫描变慢 #117036
-
在关闭和重启期间取消过期的 Gateway 工作 #117242
- 将不可用的 Gateway 路由排除在 Control UI 回退之外 #117436
- 让代理批准的 Gateway 重启安全可靠 #117530
- 防止频道看门狗故障导致 Gateway 崩溃 #117652
- 热重载自动压缩设置 #118010
- 让瞬时发送器和音频探针故障自行恢复 #118245
- 在没有配置文件时保留插件元数据 #119421
- 在上下文预热期间保持 Gateway RPC 响应 #119607
- 让设备配对轮询不进入 Gateway 启动流程 #119936
- 限制频道引导内存并保留工作区锁所有权 #120939
- 让受管更新始终绑定到其原始检出 #121288
- 在 Gateway 关闭期间排空 ACP 代理进程 #121359
- 在 launchd 引导错误后验证 macOS Gateway #121747
- 修复部署探针和 Render 首次启动 #122963
- 避免因 systemd 探针错误而误报 Gateway 重启失败 #123069
- 防止 Gateway 重启期间出现重叠的受管更新 #123116
- 保持 macOS 模型更改和节点关闭有序执行 #123529
- 及时完成已取消的 macOS 节点工作进程请求 #124151
- 通过预准备的 Gateway 挂起实现精确的目标重启 #124157
- fix(gateway): Apple 节点命令在重新连接后恢复 #124195
- 在重启期间保持 Gateway 就绪状态真实 #124514
- 在就地更新期间保持 Gateway 关闭可靠 #124582
- 重启已禁用且已安装的 systemd 服务 #124786
- 防止 Gateway 重启期间误报插件迁移失败 #124924
- 让 Gateway 控制到达 schema 领先的进程 #125133
- 在 Gateway 热重载后刷新钩子目标策略 #125490
- 回收 Linux 僵尸进程持有的锁 #125658
- 在 Gateway 延迟退出后完成受管更新 #125759
- 在事件循环停滞期间强制执行 Gateway 关闭期限 #125863
- fix: 当端口繁忙且无法识别所有者时,Gateway 停止会抛出异常 #126085
- 恢复基于目录的模型覆盖的 Gateway 启动 #126123
- 中止失败的 Gateway 部分 HTTP 响应 #126130
- 停止重试不支持的 Gateway 协议版本 #126600
- fix(sessions): 避免大量空代理存储导致启动停滞 #126685
- 在配置重新加载失败期间保持 Gateway 存活探针健康 #126736
- 防止提供程序身份验证重新预热导致 Gateway 在重启期间退出 #126855
- 在 Gateway 启动失败时清理 Bonjour #127062
- fix: /restart 反复重启 Gateway 而不是只重启一次 #127179
- fix(daemon): 停止或重启 Mac 节点时保留 Gateway #127707
- fix(update): 保持受管交接为后继所有者 #128212
- fix(update): 避免在 systemd 服务仍在停止时回滚 #129007
- fix: 流式回复在每个增量时重新扫描整个累积缓冲区以测试 8 字符静默回复令牌 #129130
- fix(ios): 弃用过时的前台 Gateway 健康探针 #129194
- fix: 避免在重新加载时重建未更改的代理运行时 #129257
- fix(gateway): 在确认写入之前等待配置热应用 #129321
- fix(macos): 失败的服务命令错误地报告成功 #129615
- fix(macos): 当节点主机工作进程无法启动时保持节点频道存活和可见 #129925
- fix(sessions): 独立于归档状态隔离重启恢复墓碑 #130196
- fix(portals): 事件流在第一个事件之前停滞 #130727
- fix: 频道配置更新不再等待自身 #131180
- fix: 打开的终端阻止协作发布更新 #131314
- fix: Gateway 关闭无法取消延迟的上下文引擎维护 #131394
- fix(gateway): 在监视器交接期间保持配置写入待处理 #131515
- fix(gateway): 在重新加载替换期间保留配置回执 #131545
- fix: 没有心跳计划的代理永远不会运行重启延续 #131888
- fix: 仪表板资源保留延迟 Gateway 重启 #131930
- fix(daemon): 在 Startup 条目移除后保留恢复能力 #132056
- fix: 完成的重启恢复不再阻塞会话 #132121
- fix(gateway): 重启时排空受监管的进程 #132566
- fix(codex): 在重新连接前回收孤立的应用程序服务器 #132610
- fix(codex): 收割器可能杀死回收 PID 的进程并跳过清理直到下次使用 #132745
- fix(gateway): 避免配对工作进程导致关闭停滞 #132877
- fix(state): 在不兼容的 schema 升级后停止 Gateway #133081
- fix: 显示 Gateway 重启进度而不是工具失败 #133119
- fix(gateway): 在重新加载期间保留原生运行时选择 #133195
- 当身份验证配置文件有过期的密钥引用时保持 Gateway 在线 #77213
- 允许在 LaunchAgent 拥有端口时重启 macOS Gateway #89096
- 防止重复的 macOS Gateway 管理器 #97285
- fix(windows): 验证 Startup 回退启动和可读脚本 (#116570) e05dae2
- fix(state): 容忍消失的 SQLite 边车 (#125451) f5eea31
- 防止插件元数据漂移阻塞 Gateway 重启 f7b372a
- 加速清理大型聊天消息 #102971
- 在更新交接失败时保持 Gateway 运行 #103278
- 在 launchd 拆除过程中保持 macOS Gateway 更新安全 #105022
- 阻止停滞的 Mattermost 握手阻塞重新连接 #105553
- 避免实时更新后的 Codex 关闭警告 #106418
- 在 Gateway 停止时取消延迟的提供程序错误工作 #108451
- 在强制启动期间限制端口检查辅助函数 #108706
- 防止并发受管更新使 Gateway 离线 #108925
- 限制 macOS 元数据探针 #109241
- 在信令期间忽略已消失的 Gateway 目标 #109590
- 当非 Gateway 进程拥有 Gateway 端口时返回失败 #110310
- fix(gateway): 保留不同的 Unicode 启动回复 #110641
- 停止没有服务管理器的前台 Gateway #111378
- 拒绝格式错误的 Gateway 升级请求 #115038
- 在监听器退出后保持强制 Gateway 启动继续工作 #115568
- 当插件停滞时保持 Gateway 关闭继续执行 #115619
- 防止过大的发现超时过早结束 Gateway 启动 #117204
- 在 Gateway 重启恢复期间跳过已删除的代理存储 #118023
- 为非 HTML Gateway 探针返回真实状态 #118048
- 修复经过身份验证的 Docker Gateway 健康命令 #118996
- 为 Gateway HEAD 响应添加 Content-Length #120210
- 恢复 Gateway 客户端的重启预检兼容性 #121757
- 在未完成的启动期间报告 Gateway 排空状态 #123204
- 在 Gateway 重启期间抑制误报的聊天元数据警告 #123433
- 对不存在的 Gateway 和 Node 服务的启动或重启请求返回失败 #124711
- 报告现有的 Tailscale 路由所有权冲突 #126449
-
fix(macos): 在仅附加模式下保留外部拥有的 Gateway #128134
- fix(gateway): 澄清跳过延迟的回复排空行为 #128178
- fix(reef): 避免好友协调期间出现关闭延迟 #129016
- fix(gateway): 在目标端口冲突时保留门户重试页面 #129075
- fix(http): 停止等待已断开的请求 #129588
- fix(gateway): HTTP 响应完成后停止分发 #129619
- fix(macos): 在 Mac 节点启动失败时显示恢复方法 #129874
- fix(macos): 在 Gateway 服务失败时显示恢复步骤 #129943
- fix(gateway): 在挂起恢复提示中保留目标上下文 #129956
- fix(gateway): 在 HTTP 路由失败后返回完整错误 #130383
- fix(gateway): 抑制来自正在关闭的客户端传输的 hello 消息 #132448
- fix: 正在运行的 Gateway 可能会报告一个它从未加载的 checkout 提交 #132854
- fix(codex): 让关闭诊断保持尽力而为 #132953
- 在启动协调期间跳过处于终态的一次性 ACP 会话 #86711
- 在启动竞态后恢复 Tailscale Serve 主机名 #91553
- 在重建期间保持源 gateway 运行 #99972
文档
故障排除、系统健康与日志
Doctor 现在花费更少的时间罗列健康清单,而用更多的时间展示哪里出了问题以及下一步该怎么做。对于可恢复的交互式启动失败,可以提供一次已确认的 doctor --fix 尝试;对于不可恢复的配置,则保持原样,并给出检查、编辑或将其移开的精确说明。单独的 openclaw doctor --json 是只读的建议性检查;当你需要默认运行中省略的建议性检查时,请使用 openclaw doctor --lint --all。
Logs 现在可以在短读取中填满有界的尾部窗口,在文件边界保留 Unicode,区分行截断、字节截断与日志滚动,并在存储不可用时报告错误,而不是返回空洞的成功。当可选健康详情失败时,Status 会保留其基础报告,因此缺失的信息仍保持未知,而不会被显示为健康。
在管理员 Control UI 中,Ask OpenClaw 可以将重要的健康状态转化为诊断问题,并在你浏览界面时保持系统护理对话停靠;同时 System 叠加层会显示调度器压力、CPU、内存、事件循环延迟和可选磁盘活动的短期历史。这些控件需要管理员或操作员权限,在引导期间或对只读范围的客户端不会显示。
来源与完整变更列表
改进
- 在每个 About 屏幕中显示确切的构建标识 #103595
- 为 OpenClaw 系统护理添加点击诊断健康提示 #110708
- 为 Ask OpenClaw 添加系统变更历史 #111286
- 添加带有快捷操作的状态感知管家欢迎页 #111615
- 为 Android 添加专门的 OpenClaw 设置聊天 #112788
- 在 Control UI 中添加可停靠的 Ask OpenClaw 伴聊窗口 #115123
- 在整个 Doctor 运行过程中复用插件元数据 #119482
- 添加可操作的 QQBot 设置错误 #119780
- 在 Doctor 和 status 中显示遥测导出器的健康状态 #119816
- 无需加载每个插件运行时即可开始 Doctor 迁移检查 #120678
- 将 Doctor 安全条件保留为单一发现项 #124666
- 让 Ask OpenClaw 持久化且可全局访问 #125107
- 将 Ask OpenClaw 移至侧边栏底部 #125486
- 添加实时 Gateway 繁忙度诊断 #125591
- feat(ui): 在系统繁忙度叠加层中添加实时 CPU/内存/延迟迷你图 #127650
- feat(cli): 为脱敏的代理调试交接添加 openclaw 分诊 #128756
- 添加一目了然的 gateway 资源仪表 #102714
- 将 ClickClack 代理回合与 ClawRouter 审计关联起来 #103476
- 让 gateway 和通道日志更清晰、更少重复 #104174
- 添加脱敏的 Gateway 启动结果摘要 #104183
- 让常规 doctor 输出更简短并聚焦问题 #106968
- 整合操作员诊断与迁移保护措施 #109211
- 在无效配置阻止启动后提供引导式修复 #110533
- 为 Ask OpenClaw 提供常规聊天体验 #110934
- 通过 Gateway WebSocket 请求延续上游追踪 #113189
- 配置 OpenTelemetry 指标名称前缀 #116687
- 统一核心、插件和 Control UI 中的错误消息 #117818
- 跟踪持续的 Gateway 事件循环性能下降 #118193
- 公开安全的 live-updater 恢复诊断 #119096
- 在支持的通道上将 status 渲染为原生富表格 #120167
- 加快捆绑插件 doctor-contract 的加载 #120698
- 在健康检查中显示被阻塞的入站通道 #123234
- 在 status JSON 中包含 Gateway 构建标识 #123917
- 在交互式 doctor 运行期间显示迁移进度 #124692
- 报告托管更新的最终化耗时 #126107
- fix(ui): 让登录恢复命令可复制 #128047
- feat(ui): 在诊断叠加层中显示磁盘空间 #128552
- improve: 加快大型历史记录升级和 Doctor 检查 #133068
- improve: 加快对大型会话历史的 Doctor 检查 #133100
- improve: 加快转录迁移和 Doctor 扫描 #133127
- 在回合失败中包含脱敏的 worker stderr b69e047
- 为 worker 停滞错误添加确认状态 f264f45
- 让默认 Doctor lint 在自动化中更安静 #100361
- 停止将已被取代的配置重载报告为错误 #106165
- 共享重叠的 macOS Tailscale 状态刷新 #116321
- 将 CLI 启动阶段添加到诊断时间线 #117702
- 让启动迁移恢复指南与安装方式无关 #119406
- 记录计划更新活动的生命周期事件 #120669
- 报告 state-v9 注册表迁移决策 #124862
- improve(gateway): 减少健康快照会话的工作量 #127744
- perf(logging): 复用日志级别阈值 #128061
- fix(agents): 记录代理在自动压缩后重新读取的内容 #128148
- perf(status): 批量输出文本报告 #128168
- improve: 每次状态扫描仅解析一次配置 #129494
- perf(status): 跳过隐藏会话详情的投影 #133014
- 在节点执行审批不可用时添加可操作的恢复步骤 #91280
Bug 修复
- 在 Doctor 修复期间保留不可恢复的配置 #109362
- 防止 macOS 应用探测挂起 #115938
- 记录频道账户生命周期状态 #117300
- 防止诊断生命周期跨度重复和泄漏 #119791
- 进程内重启后保持 OpenTelemetry 导出 #120131
- 核心升级后保持已发布的官方插件加载 #124086
- 保留未知的 Gateway 服务状态 #125734
- fix(sessions): 迁移长历史记录而不会耗尽堆内存 #131276
- 防止 Gateway 在持续负载下出现内存不足崩溃循环 #96250
- 当打开的聊天暴露 Gateway 或 cron 控制时发出警告 #100965
- 按遥测信号路由共享的 OTLP 端点 #101655
- 在安全审计期间限制 mcporter 注册表读取 #101772
- 在截断的 HTTP 响应片段中保留字符 #103136
- 保持状态诊断只读 #103252
- 保持截断的支持诊断 Unicode 安全 #103580
- 恢复 clawlog 默认值并清除选项错误 #104059
- 在短读中保留完整日志尾部 #105066
- 在会话尾部跟随读取中保留 Unicode #108151
- 在 Doctor 中正确报告每个状态模式迁移 #108947
- 限制 Node 运行时能力探测 #109127
- 限制守护进程 Node 二进制查找 #109239
- 在深度安全审计中扫描 SKILL.md 指令 #109363
- 在短转录读取中保留诊断上下文 #109401
- 在短 Git 元数据读取后保留检出提交标识 #109419
- 在深度安全审计期间限制 SKILL.md 读取 #110589
- 修复提供方删除后过时的模型引用 #110648
- 当会话维护被锁定时保留 Doctor 配置修复 #111280
- 限制 Mattermost 探测 DNS 和代理预检 #111314
- 在 Doctor 中检查每个已配置的代理 #111758
- Doctor 检查每个代理的工作区建议 #111840
- 传播实际导出的 OpenTelemetry span 上下文 #112283
- 为命名配置文件分离 Gateway 日志 #112777
- 在安全诊断中报告可用的代理配置路径 #113603
- 检测 macOS 上仅 CLI 的 Tailscale #114179
- 使系统代理恢复指导可在浏览器和应用界面中使用 #114633
- 在运行时超时之前持久化安全的 Doctor 迁移 #114703
- 将文件日志从 Gateway 请求路径中移出 #114769
- 根据 V8 限制缩放堆压力阈值 #115153
- 将提供方私有思考排除在遥测之外 #115261
- 减少健康诊断噪音和刷新抖动 #115602
- 在多端口状态收集期间批量检查 macOS 监听器 #115813
- 从 macOS 隧道就绪检查中移除子进程轮询 #115846
- 防止 macOS 远程 Gateway 发现挂起 #115852
- 将后续代理工作保留在同一个 OpenTelemetry 跟踪树中 #116246
- fix(channels): 将零负载 turn 警告归因于频道,并停止虚假的静默丢弃警报 #116486
- 在并发 Gateway 健康刷新期间保留实时探测 #116681
- 使状态和提供方诊断报告真实故障 #116776
- 在每个平台上报告真实的服务移除故障 #116819
- 保持日志收集只读 #116869
- 在状态工具中显示无响应入口和忙碌频道的健康情况 #117236
- 使发布验证与当前运行时契约保持一致 #117494
- 将调试诊断与手动 RPC 结果分离 #117546
- 将 Gateway 状态限制在活动环境内 #119015
- 避免原始诊断写入失败导致代理运行结束 #119400
- 在关闭期间保留 OpenTelemetry 诊断 #119705
- 遵循按信号的 OTLP 协议设置 #119708
- 在回滚期间保留真实的 OTEL 启动错误 #119747
- 让 OTEL_SDK_DISABLED 完全禁用 OpenClaw 遥测 #119961
- 解释未经验证的 Windows SecretRef 路径安全性 #120211
- 为 Gateway 连接失败提供一致的恢复指导 #120505
- 加快 Doctor 检查并恢复 Discord 修复 #120882
- 在 Doctor 中恢复选定的外部插件状态迁移 #120908
- 在升级期间保留外部插件会话所有权 #121082
- 保留旧版插件运行时 Doctor 导入 #121220
- fix(diagnostics): 消息持续到达时,停滞的通道未被报告 #121380
- 解析本地化的 Windows 进程名称以获取端口提示 #122126
- 使诊断 ZIP 替换具备原子性和私密性 #122130
- 在迁移写入失败后停止 Doctor #123045
- 在日志尾部报告中显示行数限制截断 #123358
- 在报告格式错误的配置后让 Doctor 退出 #123430
- fix(gateway): 保留 worker 隧道退出诊断 #123611
- 解释升级后过时的 Gateway 文件 #123842
- 停止在文件日志中产生重复的根记录 #123936
- 将正常停止的服务报告为已停止 #123961
- 在 Doctor 中显示遥测导出器探测失败 #123971
- 在 WebSocket 连接失败期间解释过时的 Gateway 安装 #123998
- 保持 Doctor 静态检查不迁移共享状态 #124110
- 保持 Control UI 日志尾部与正确的文件关联 #124369
- 为无法序列化的 Gateway 响应返回类型化错误 #124375
- 仅报告已写入磁盘的 Doctor 修复 #124462
- 根据运行时内存限制调整 Gateway RSS 诊断 #124914
- 诊断无法托管节点的 Gateway #125132
- 在状态命令中显示实时 Gateway 降级 #125888
- 当数据丰富失败时保持状态报告可用 #126072
- 在状态输出中显示可操作的遥测失败信息 #126092
- 报告不可用的日志存储而不是空日志 #126481
- 为无法解析的配置提供运维人员恢复路径 #126757
- 记录 Discord 投票和贴纸外发活动 #126791
- 澄清空频道状态和 Gateway 连接失败 #126984
- 在结构化 Doctor 静态检查中报告降级的 Gateway 机密信息 #126998
- fix(cli): 拒绝冲突的只读 Doctor 模式 #128142
- fix(telemetry): 仅报告公开已知的插件身份 #128603
- fix(ui): 区分待处理和失败的空状态 #128746
- fix: 当频道探测停滞时保持详细健康信息可用 #128915
- fix(telemetry): 抑制自动化环境的报告 #129155
- fix(doctor): 为已安装的 Codex 插件运行健康检查 #129276
- fix(agents): 使终端 CLI 故障可诊断 #129481
- fix(status): 在概览中保留服务检查错误 #130365
- fix(cli): 在跟踪日志时遵从所选端口 #130513
- fix(doctor): 显示不可读的旧版插件状态,而不是静默跳过迁移 #130956
-
fix(doctor): 在规范的登记表结构上修复代理工作区和心跳值 #130959
-
fix(canvas): 仅在迁移完成后弃用遗留文档根目录 #131038
- fix: gateway status 规范化运行时检查错误 #131495
- fix(logging): 报告被丢弃的文件日志记录 #132672
- fix(cli): 在受限主机上降低 gateway status 的内存占用 #132784
- fix(doctor): 升级后恢复生成的模型元数据 #132835
- fix(status): 按规范所有者对共享会话存储进行分组 #133038
- fix(cli): 通过管道输出时保持 Doctor JSON 报告完整 #133259
- fix(status): 自愈状态惰性加载器故障并遏制渲染错误 #94806
- 确保截断的诊断信息和元数据在遇到 emoji 时仍有效 0ac8933
- 在 Swabble 状态检查中遵循自定义配置路径 251f54b
- 从一次性本地 agent 运行中导出 OpenTelemetry #100845
- 限制会话维护警告去重的内存占用 #101643
- 确保重启诊断中的 emoji 完好无损 #101934
- 确保截断的 Doctor 错误符合 UTF-16 安全 #102066
- 保持截断的 Discord 网关关闭诊断可读 #102246
- 确保频道日志预览符合 UTF-16 安全 #102407
- 在有效 UTF-8 边界上保留代理捕获预览 #102409
- 确保截断的网关配置路径中的 emoji 完好无损 #102513
- 确保 Discord 部署错误截断对 emoji 安全 #102525
- 确保截断的日志消息是有效的 Unicode #102560
- 确保网关 WebSocket 日志预览是有效的 Unicode #102561
- 保持清理超时警告可读 #102565
- 确保诊断日志在遇到 emoji 时依然有效 #102570
- 确保 QQBot 调试预览在遇到 emoji 时依然有效 #102572
- 确保 Prometheus 诊断错误日志符合 Unicode 安全 #102591
- 确保网关命令元数据截断符合 Unicode 安全 #102816
- 减少 MCP 环回模式警告噪音 #103171
- 阻止干净的 Doctor 检查建议不必要的修复 #103233
- 在空白行之后报告正确的 JSONL 会话行 #103645
- 确保导出的诊断 JSON 符合 Unicode 安全 #103646
- 确保重启日志尾部符合 Unicode 安全 #103757
- 确保截断的超时 URL 是有效的 Unicode #104301
- 减少良性的 macOS 启动 Socket 警告 #104610
- 确保 worker 引导错误文本符合 UTF-16 安全 #104619
- 在 worker SSH 隧道诊断中保留有效字符 #104621
- 将良性的网关启动关闭竞态降级 #104625
- 避免干净的 Mac 应用启动关闭触发错误的网关警告 #104655
- 消除成功 macOS 更新期间的虚假警告 #104813
- 确保频道令牌提示在遇到 emoji 时依然有效 #104850
- 会话迁移报告保留完整的 Unicode 字符 #104851
- 在精简的网关 WebSocket 日志 ID 中保留 Unicode #105001
- 将受管理的网关重启日志限定在当前检出(checkout)范围内 #105030
- 在 Windows 字节限制下保留 UTF-8 SSH 身份输出 #105274
- 重新启用自动跟随时,将日志返回到最新条目 #105809
- 当重启状态持久化失败时发出警告 #106385
- 记录读取 HTTP 错误详细信息时的失败 #106393
- 限制端口检查进程信息补充的并发度 #107121
- 确保云 worker 故障详细信息符合 UTF-16 安全 #107718
- 清除已解决的 TaskFlow 和 OAuth Doctor 警告 #108123
- 确保受限 CLI 输出的诊断信息符合 UTF-8 安全 #108355
- 记录非阻塞网关重启钩子失败 #108847
- 确保短文件读取后 QQBot 日志导出完整 #108955
- 限制长期存在的配置警告缓存 #109000
- 防止 macOS Doctor 在 launchctl 探针上挂起 #109115
- 阻止 Doctor 在停滞的 GitHub issue 创建上挂起 #109253
- 在 Doctor 迁移 issue 报告中保留 Unicode #109592
- 限制停滞的网关进程探针 #109731
- 在启动时报告已被占用的浏览器控制端口 #109994
- 在 APNs 响应诊断中保留 UTF-8 #110483
- 忽略空白的 OTLP 协议环境变量覆盖 #110674
- 阻止停滞的 Linux journal 查询挂起日志 #111215
- 确保 xdg-open 失败消息符合 UTF-16 安全 #111323
- 将已停止的频道显示为已断开连接 #112518
- Doctor 在 Linux 上保留活动网关会话锁 #112855
- 在 Doctor 中阐明不可用的系统 Node 版本 #114325
- 在 node status 中保留 Windows PATH 分隔符 #114505
- 防止主动引导留下虚假的排队工作诊断 #114780
- 在 openclaw doctor 中恢复工作区建议 #115512
- 在健康输出中显示网关探测时长 #115520
- 在 status 和 doctor 中显示已停止的频道 #116781
- 替换针对停滞回复的虚假网关过载通知 #116959
- 修正打包安装中 Control UI 的资源检查 #117003
- 在修复不完整后保留未解决的 Doctor 发现项 #117448
- 拒绝冲突的 Doctor lint 选择器 #117495
- 遵守显式的 status 命令超时设置 #117519
- 当选择器部分重叠时保留可运行的 Doctor 检查 #117543
- 在离线 status 输出中保留频道过滤器 #117570
- 限制 gateway status 对服务管理器的读取 #117636
- 呈现可操作的会话历史迁移冲突 #117656
- 在网关日志中显示完整的持久化消息 #117666
- 在常规日志中呈现脱敏后的 WhatsApp 媒体下载失败信息 #117717
- 让恰好达到上限的搜索不再报告截断 #117747
- 让 channels status 显示所有频道 #118124
- 统一网关方法注册并隐去终端故障信息 #118232
- 在会话导出中标记被截断的格式错误行列表 #119230
- 停止将过时的诊断阶段标记为近期 #119625
- 在单独的行中显示无效配置详细信息 #119871
- 在 HEAD 请求中报告 Prometheus 指标长度 #120212
- 强制执行严格的诊断查询整数 #120446
- 准确报告 Windows 端口可用性的不确定状态 #120845
- 在 Doctor 中报告不完整的遗留缓存扫描 #122585
- 让
doctor --json运行只读部署预检 #122662 - 将恢复的 compaction 运行报告为已完成 #122974
- 准确报告 Signal RPC 探针故障 #123001
- fix(logs): 报告被截断的频道日志尾部 #123699
- 在 stdout 上将 Doctor 机器故障以 JSON 形式返回 #123752
- fix(doctor): 当状态目录叶不存在时跟随 macOS 云符号链接 #124299
- 阻止虚假的 agent 名册安全警告 #124398
- 在网关审计中如实报告已中止的未确认引导操作 #124409
- 将设备批准引导至当前配对请求 #124637
- 当会话历史磁盘清理失败时发出警告 #124681
- 在 Doctor 迁移通知中显示配置路径 #124719
-
提供可操作的受管理网关恢复方案 #124783
-
解释尽力而为的配置回退 #125010
- 当群组房间共享主会话时发出警告 #125054
- 报告失败的远程 Gateway 健康检查 #125203
- 将被拒绝的 Doctor 配置修复报告为不完整 #125282
- 让 Doctor 在磁盘严重耗尽时触发错误门禁 #125644
- 限制 macOS Gateway 状态探针 #126394
- 显示 Gateway 重启和更新探针失败 #126645
- 让 macOS clawlog JSON 输出可解析且失败安全 #126651
- 保留包装错误原因中的结构化细节 #126654
- 停止对成功的 Discord 描述截断发出警告 #126824
- 拒绝无效的 gateway 状态超时 #126977
- 防止 Gateway 健康检查产生过期成功状态 #127174
- 修复(status):暴露无效配置而不是报告系统为健康状态 #127402
- 修复(channels):停止为排队回复产生虚假的无负载警告 #127667
- 修复(logging):保留不完整的尾部记录 #127810
- 修复(ui):刷新时显示通道探针进度 #127903
- 修复(doctor):在权限重新授权期间显示已禁用的自动化 #127998
- 修复(health):次要账户故障被错误地显示为健康 #129088
- 修复(macos):在设置中暴露通道账户故障 #129400
- 修复(status):将 doctor 提示限定在活动配置文件和容器范围内 #129418
- 修复(gateway):限定崩溃循环中通道恢复提示的范围 #129697
- 修复(ios):优先显示活动 gateway 错误而非连接名称 #129709
- 修复(cli):停止 doctor JSON 模式静默过滤健康检查 #129919
- 修复(config):结构化非交互式预检警告 #129954
- 修复(daemon):恢复提示指向错误的配置文件或容器 #130216
- 修复:在文本日志中保留 Gateway 错误原因 #130645
- 重构(models):简化选择器和思考投影 #130694
- 修复(status):在深度健康检查中将健康通道显示为 OK #130794
- 修复(cli):在 status 叶子命令上遵循 gateway --port #130847
- 修复(otel):保留收集器查询值中的尾部斜杠 #130934
- 在 Gateway 日志中正确分类 Node 进程警告 #131333
- 修复(doctor):恢复对被忽略的代理设置的警告 #131443
- 修复(doctor):保留大型媒体迁移时间戳 #132099
- 修复(cli):准确预览被抑制的遥测请求 #132222
- 修复(doctor):将模式升级与媒体修复分开报告 #132314
- 修复(imessage):避免 Doctor 中不必要的启动工作 #132435
- 修复(logs):仅当日志文件实际缩小时报告轮转 #74252
- 在 Gateway 启动期间跳过缺失的 lsof 警告 #76364
- 避免对 shell 包装的 LaunchAgents 产生虚假的 gateway 警告 #81778
- 修复 Doctor 沙箱修复符号链接 OpenClaw 启动器的问题 #90942
- 避免 status 命令中的重复通道扫描 #95263
文档
命令行输出和 Shell 补全
脚本使用的命令现在具有更可预测的机器接口。这些 JSON 和 JSONL 命令会将终端重置字节排除在 stdout 之外,并在调用失败时返回一致的结构化错误,因此自动化不再需要对它们进行特殊处理。
Shell 补全 的安装和刷新会在跨 Bash、Zsh、Fish 和 PowerShell 原子发布配置文件和缓存的同时,保留无关的配置文件内容和权限。远程 Gateway 回合和常见的只读命令也会跳过它们不需要的启动工作,而本地探针和人类可读输出则保留更全面的验证;输错的命令现在会指向拒绝它们的命令树、附近的命令以及正确的帮助文档。
可预测的机器输出契约涵盖了已命名的命令路径。人工诊断信息仍可能出现在 stderr 上,成功的降级结果仍因命令而异,原始生命周期错误的脱敏尚未全面实现。
来源与完整变更列表
**改进** - 加速基于 Gateway 的 CLI 代理回合 [#117705](https://github.com/openclaw/openclaw/pull/117705) - 为 CLI 报告命令添加一致的 JSON 输出 [#117928](https://github.com/openclaw/openclaw/pull/117928) - 加速常用只读 CLI 命令 [#117932](https://github.com/openclaw/openclaw/pull/117932) - 降低基于 Gateway 的 CLI 命令的启动开销 [#115294](https://github.com/openclaw/openclaw/pull/115294) - 统一各分发路径上的 CLI 配置守卫行为 [#117880](https://github.com/openclaw/openclaw/pull/117880) - 加速冷启动只读 CLI 命令 [#117957](https://github.com/openclaw/openclaw/pull/117957) - 加速冷启动 CLI 状态与插件读取 [#118460](https://github.com/openclaw/openclaw/pull/118460) - 加速自适应的 ASCII 表格渲染 [#127221](https://github.com/openclaw/openclaw/pull/127221) - improve(cli): 加速 config help 启动 [#128113](https://github.com/openclaw/openclaw/pull/128113) - perf(startup): 通过显式模块格式短路 dist 内部 ESM 解析 [#128541](https://github.com/openclaw/openclaw/pull/128541) - perf(startup): 测量默认解析路径并门控调试捕获导入 [#131181](https://github.com/openclaw/openclaw/pull/131181) - improve(cli): 削减常规 gateway 状态启动内存 [#133114](https://github.com/openclaw/openclaw/pull/133114) - 改进 TUI 选择器中的模糊匹配 [#107576](https://github.com/openclaw/openclaw/pull/107576) - 降低常规状态命令的内存占用 [#116668](https://github.com/openclaw/openclaw/pull/116668) - 避免 CLI 帮助加载未激活的 provider 运行时 [#121997](https://github.com/openclaw/openclaw/pull/121997) - 加速 `openclaw audit` 启动 [#124595](https://github.com/openclaw/openclaw/pull/124595) - improve(tui): 加速未变更转录的重绘 [#127767](https://github.com/openclaw/openclaw/pull/127767) **Bug 修复** - 保持 JSON 控制台日志在各 CLI 路由中结构化 [#113654](https://github.com/openclaw/openclaw/pull/113654) - 使 CLI 命令、补全和 JSON 输出可靠 [#116033](https://github.com/openclaw/openclaw/pull/116033) - 保留 CLI 选项值和机器可读输出 [#116389](https://github.com/openclaw/openclaw/pull/116389) - 保留 shell 配置文件及补全选项值 [#116906](https://github.com/openclaw/openclaw/pull/116906) - 恢复本地 TUI 和嵌入式代理的快速启动 [#117396](https://github.com/openclaw/openclaw/pull/117396) - 当补全安装失败时保留 shell 配置文件 [#117987](https://github.com/openclaw/openclaw/pull/117987) - 在嵌入式本地 TUI 回合间复用已准备的运行时 [#120051](https://github.com/openclaw/openclaw/pull/120051) - 在静默活动后保持终端聊天历史可见 [#121337](https://github.com/openclaw/openclaw/pull/121337) - 标准化 CLI JSON 失败输出 [#124849](https://github.com/openclaw/openclaw/pull/124849) - 使日志和钩子 CLI 错误干净地退出终端 [#105863](https://github.com/openclaw/openclaw/pull/105863) - 为缺失的输入文件显示清晰的 CLI 错误 [#105874](https://github.com/openclaw/openclaw/pull/105874) - 将 macOS CLI PATH 发现移出主 actor [#106089](https://github.com/openclaw/openclaw/pull/106089) - 保留 CLI 子命令中的字面 `--update` 值 [#106144](https://github.com/openclaw/openclaw/pull/106144) - 使 Git Bash 核心工具在 Windows 上可用 [#108136](https://github.com/openclaw/openclaw/pull/108136) - 在 TUI 本地 shell 输出中保留 emoji [#108268](https://github.com/openclaw/openclaw/pull/108268) - 防止 Fish 补全截断名为 `-l` 的文件 [#109324](https://github.com/openclaw/openclaw/pull/109324) - 阻止重复的 TUI 搜索保留过期的正则表达式 [#109451](https://github.com/openclaw/openclaw/pull/109451) - 将 CLI JSON 结果写入 stdout [#109808](https://github.com/openclaw/openclaw/pull/109808) - 使一次性 macOS CLI 命令及时退出 [#110341](https://github.com/openclaw/openclaw/pull/110341) - 使 TUI 退出后干净地结束 [#110595](https://github.com/openclaw/openclaw/pull/110595) - 在 Gateway 拆卸挂起后保证 TUI 退出 [#111015](https://github.com/openclaw/openclaw/pull/111015) - 阻止命令组帮助在输出后挂起 [#111433](https://github.com/openclaw/openclaw/pull/111433) - 使 CLI 失败和信号返回真实状态 [#112210](https://github.com/openclaw/openclaw/pull/112210) - 为一次性命令恢复 macOS Keychain CA 信任 [#113112](https://github.com/openclaw/openclaw/pull/113112) - 在核心后恢复期间保持更新 JSON 有效 [#113298](https://github.com/openclaw/openclaw/pull/113298) - 识别安装在登录配置文件中的 Bash 补全 [#113790](https://github.com/openclaw/openclaw/pull/113790) - 拒绝空的更新超时参数 [#114700](https://github.com/openclaw/openclaw/pull/114700) - 安装缓存的 shell 补全而无需加载插件 [#114761](https://github.com/openclaw/openclaw/pull/114761) - 在 CLI 选项之后恢复 PowerShell 补全 [#114950](https://github.com/openclaw/openclaw/pull/114950) - 加速机器可读的 Gateway 健康探测 [#115244](https://github.com/openclaw/openclaw/pull/115244) - 保持 CLI 帮助、更新预览和插件锁定正确 [#115464](https://github.com/openclaw/openclaw/pull/115464) - 接受嵌套命令后的继承 CLI 标志 [#116587](https://github.com/openclaw/openclaw/pull/116587) - 在 TUI 后端关闭失败后释放终端 [#116609](https://github.com/openclaw/openclaw/pull/116609) - fix(cli): 恢复准确的操作员诊断和安全输入处理 [#116652](https://github.com/openclaw/openclaw/pull/116652) - 显示补全修复失败并停止失败的验证进度 [#116825](https://github.com/openclaw/openclaw/pull/116825) - 尊重 shell 自有的补全配置文件位置 [#117002](https://github.com/openclaw/openclaw/pull/117002) - 保持 Unicode 终端表格列对齐 [#117062](https://github.com/openclaw/openclaw/pull/117062) - 在关闭期间取消缓冲的 TUI 输入 [#117331](https://github.com/openclaw/openclaw/pull/117331) - 在致命退出时保留机器可读的 CLI 输出 [#117487](https://github.com/openclaw/openclaw/pull/117487) - 保持 JSON 通道状态启动为冷启动 [#117751](https://github.com/openclaw/openclaw/pull/117751) - 在终端 UI 中保留连续的 Backspace [#117989](https://github.com/openclaw/openclaw/pull/117989) - 当刷新失败时保留 shell 补全缓存 [#118715](https://github.com/openclaw/openclaw/pull/118715) - 在 TUI 中显示后台进程失败的原因 [#120724](https://github.com/openclaw/openclaw/pull/120724) - 从系统 CLI 机器输出命令返回结构化错误 [#123614](https://github.com/openclaw/openclaw/pull/123614) - 当较宽列可换行时保持 CLI 表格标识符完整 [#123934](https://github.com/openclaw/openclaw/pull/123934) - 在 CLI JSON 输出中脱敏已捕获的错误 [#124075](https://github.com/openclaw/openclaw/pull/124075) - 从 Gateway 和 CLI 失败中移除内部类名 [#124329](https://github.com/openclaw/openclaw/pull/124329) - 从已验证的 Gateway RPC 错误中移除 JavaScript 类名 [#124563](https://github.com/openclaw/openclaw/pull/124563) - 改进 CLI 错误和状态表格 [#124581](https://github.com/openclaw/openclaw/pull/124581) - 即使在请求帮助时也报告未知的嵌套命令 [#124707](https://github.com/openclaw/openclaw/pull/124707) - 保持常规 CLI 错误简洁 [#124887](https://github.com/openclaw/openclaw/pull/124887) - 为拼写错误的 CLI 命令显示可操作的指导 [#124892](https://github.com/openclaw/openclaw/pull/124892) - 在 CLI 中一致地呈现缺失的 Gateway 凭据 [#125007](https://github.com/openclaw/openclaw/pull/125007) - 在身份验证期间干净地退出本地 TUI [#126476](https://github.com/openclaw/openclaw/pull/126476) - fix(tui): 退出时停止本地 shell 子进程 [#127652](https://github.com/openclaw/openclaw/pull/127652) - fix(cli): 当必需值占用 `--json` 时显示人类可读错误 [#128557](https://github.com/openclaw/openclaw/pull/128557) - fix(install): `--json` 为动态值保留有效的 NDJSON [#128682](https://github.com/openclaw/openclaw/pull/128682) - fix(tui): 将句末标点排除在终端超链接目标之外 [#128727](https://github.com/openclaw/openclaw/pull/128727) - fix(cli): 解释空的 capability 列表 [#128852](https://github.com/openclaw/openclaw/pull/128852) - fix(cli): 当机器可读命令解析失败时返回 JSON 错误 [#128861](https://github.com/openclaw/openclaw/pull/128861) - fix(cli): 呈现 Gateway 验证 JSON 失败 [#129043](https://github.com/openclaw/openclaw/pull/129043) - fix(cli): 嵌套命令帮助在加载路由命令时停滞 [#129112](https://github.com/openclaw/openclaw/pull/129112) - fix(cli): 保留结构化的核心发送失败 [#129728](https://github.com/openclaw/openclaw/pull/129728) - fix(channels): 在 JSON 清单中保留已配置的账户 [#130738](https://github.com/openclaw/openclaw/pull/130738) - fix(cli): 在懒加载命令帮助中显示真实选项 [#130951](https://github.com/openclaw/openclaw/pull/130951) - fix(install): 在 macOS JSON 输出中保留 Unicode [#131244](https://github.com/openclaw/openclaw/pull/131244) - fix(cli): 保留 checkout 之外的源代码解析 [#131479](https://github.com/openclaw/openclaw/pull/131479) - fix: 在 CLI JSON 中包含已存储的会话颜色 [#132982](https://github.com/openclaw/openclaw/pull/132982) - fix(cli): 保持 setup 和 agent 帮助启动懒加载 [#133272](https://github.com/openclaw/openclaw/pull/133272) - fix: 使会话表格与 Unicode 键和长模型名称对齐 [#133283](https://github.com/openclaw/openclaw/pull/133283) - 为每次构建刷新缓存的 CLI 帮助 [63f497a](https://github.com/openclaw/openclaw/commit/63f497a) - 从终端输出中剥离 C1 OSC 元数据 [#103672](https://github.com/openclaw/openclaw/pull/103672) - 在换行的表格单元格中保留终端链接和样式 [#103717](https://github.com/openclaw/openclaw/pull/103717) - 将空的任务 JSON 过滤器报告为不存在 [#103981](https://github.com/openclaw/openclaw/pull/103981) - 当 TUI 换行长文本时保持 emoji 完整 [#104024](https://github.com/openclaw/openclaw/pull/104024) - 从 `openclaw path set` 报告准确的 UTF-8 字节数 [#104496](https://github.com/openclaw/openclaw/pull/104496) - 澄清格式错误的 gateway 调用参数 [#105217](https://github.com/openclaw/openclaw/pull/105217) - 为格式错误的文档搜索响应显示清晰的错误 [#108364](https://github.com/openclaw/openclaw/pull/108364) - 从面向机器的 CLI 输出中发出绝对配置路径 [#109361](https://github.com/openclaw/openclaw/pull/109361) - 按一次 Enter 提交确切的 TUI 命令参数 [#109809](https://github.com/openclaw/openclaw/pull/109809) - 在调试级别保持 config schema JSON 可解析 [#110496](https://github.com/openclaw/openclaw/pull/110496) - 在显示的主目录路径中保留字面美元符号模式 [#111398](https://github.com/openclaw/openclaw/pull/111398) - 允许在存在无关无效配置时进行文档搜索 [#111803](https://github.com/openclaw/openclaw/pull/111803) - 恢复 macOS 一次性命令的公共 TLS 信任 [#112868](https://github.com/openclaw/openclaw/pull/112868) - 恢复 Bash 中的短选项补全 [#113811](https://github.com/openclaw/openclaw/pull/113811) - 恢复 TUI 中的 Ctrl+D 向前删除 [#113872](https://github.com/openclaw/openclaw/pull/113872) - 明确全新安装时 exec 审批的默认值 [#114417](https://github.com/openclaw/openclaw/pull/114417) - 保持配置文件路径查询快速且只读 [#114660](https://github.com/openclaw/openclaw/pull/114660) - 防止只读配置命令写入状态 [#114847](https://github.com/openclaw/openclaw/pull/114847) - 将 Fish 补全限定到当前活动命令 [#115180](https://github.com/openclaw/openclaw/pull/115180) - 避免在常规 CLI 启动期间执行无效的 SQLite 修复 [#115193](https://github.com/openclaw/openclaw/pull/115193) - 在全局 CLI 选项之后恢复 Fish 补全 [#115222](https://github.com/openclaw/openclaw/pull/115222) - 保持 JSON CLI 的 stdout 在进程退出前有效 [#115315](https://github.com/openclaw/openclaw/pull/115315) - 避免 JSON 命令的 stdout 包含退出时诊断信息 [#115327](https://github.com/openclaw/openclaw/pull/115327) - 保持 Bash、Fish 和 PowerShell 中的 shell 补全一致 [#115332](https://github.com/openclaw/openclaw/pull/115332) - 报告正在运行的 CLI 构建中嵌入的 commit [#115544](https://github.com/openclaw/openclaw/pull/115544) - 保持 Gateway 凭据失败在 JSON 中可解析 [#116597](https://github.com/openclaw/openclaw/pull/116597) - 在 JSON 日志下保持配置文件输出为原始内容 [#116968](https://github.com/openclaw/openclaw/pull/116968) - 在 JSON 模式下返回 Canvas 控制结果 [#117297](https://github.com/openclaw/openclaw/pull/117297) - fix(tui): Gateway 停止时取消历史记录重试 [#117318](https://github.com/openclaw/openclaw/pull/117318) - 使用父选项保留 Gateway 启动策略 [#117675](https://github.com/openclaw/openclaw/pull/117675) - 提前拒绝过大的 Gateway TUI 历史记录限制 [#117773](https://github.com/openclaw/openclaw/pull/117773) - 按顺序且仅一次报告失败的 TUI shell 命令 [#118452](https://github.com/openclaw/openclaw/pull/118452) - 从一个共享注册表中列出受支持的 TUI 命令 [#118515](https://github.com/openclaw/openclaw/pull/118515) - 在健康 JSON 中保留 Gateway 请求错误 [#118645](https://github.com/openclaw/openclaw/pull/118645) - 使 Gateway RPC 调用遵循自定义本地端口 [#119046](https://github.com/openclaw/openclaw/pull/119046) - 将配对 QR 码保持在标准终端宽度内 [#120827](https://github.com/openclaw/openclaw/pull/120827) - 保留 Windows CLI 中名为 node.exe 的参数 [#121064](https://github.com/openclaw/openclaw/pull/121064) - 清理旧版包入口点的版本输出 [#121690](https://github.com/openclaw/openclaw/pull/121690) - 避免为被拒绝的 CLI 命令创建 profile [#122970](https://github.com/openclaw/openclaw/pull/122970) - 当流排空停滞时限制一次性 CLI 退出 [#123134](https://github.com/openclaw/openclaw/pull/123134) - 从 Directory CLI 命令发出结构化 JSON 错误 [#123390](https://github.com/openclaw/openclaw/pull/123390) - 返回结构化的 Gmail 设置错误 [#123646](https://github.com/openclaw/openclaw/pull/123646) - 建议有效的迁移预览命令 [#124149](https://github.com/openclaw/openclaw/pull/124149) - 为未知子命令显示相关帮助 [#124544](https://github.com/openclaw/openclaw/pull/124544) - 为拼写错误的嵌套 CLI 命令显示准确错误 [#124661](https://github.com/openclaw/openclaw/pull/124661) - 显示每个 TUI 重连失败原因 [#124700](https://github.com/openclaw/openclaw/pull/124700) - 解释空的目录查找结果 [#124753](https://github.com/openclaw/openclaw/pull/124753) - 当 agent 创建无法提示时明确失败 [#124940](https://github.com/openclaw/openclaw/pull/124940) - 将 Windows shell 补全默认设置为 PowerShell [#125211](https://github.com/openclaw/openclaw/pull/125211) - 停止在错误消息中重复原因文本 [#125687](https://github.com/openclaw/openclaw/pull/125687) - 在订阅会话事件之前阻止 TUI 发送 [#125928](https://github.com/openclaw/openclaw/pull/125928) - 当文档搜索失败时返回机器可读的 JSON [#126331](https://github.com/openclaw/openclaw/pull/126331) - 在生命周期子命令之前接受 daemon JSON 输出 [#126447](https://github.com/openclaw/openclaw/pull/126447) - 对用量和稳定性查询遵循自定义 Gateway 端口 [#126832](https://github.com/openclaw/openclaw/pull/126832) - 对 QR 选项验证失败返回 JSON [#126884](https://github.com/openclaw/openclaw/pull/126884) - 对 sandbox CLI 失败返回规范 JSON [#126915](https://github.com/openclaw/openclaw/pull/126915) - 对缺失的 task 和 flow 查找返回可解析 JSON [#127080](https://github.com/openclaw/openclaw/pull/127080) - fix(cli): 对无效状态超时返回 JSON [#127721](https://github.com/openclaw/openclaw/pull/127721) - fix(cli): 对 task 验证失败返回 JSON [#127750](https://github.com/openclaw/openclaw/pull/127750) - fix(tui): 遵循 system-agent 历史记录限制 [#127993](https://github.com/openclaw/openclaw/pull/127993) - fix(cli): 对 channel 能力失败返回 JSON [#128155](https://github.com/openclaw/openclaw/pull/128155) - fix(cli): 渲染 agent 绑定 JSON 失败 [#128484](https://github.com/openclaw/openclaw/pull/128484) - fix(cli): 渲染 agents add JSON 失败 [#128517](https://github.com/openclaw/openclaw/pull/128517) - fix(cli): 渲染 agent 身份 JSON 失败 [#128590](https://github.com/openclaw/openclaw/pull/128590) - fix(cli): 将遥测 JSON 写入 stdout [#129003](https://github.com/openclaw/openclaw/pull/129003) - fix(tui): 保留斜杠命令别名补全 [#129039](https://github.com/openclaw/openclaw/pull/129039) - fix(cli): 失败的一次性命令错误地以成功状态退出 [#129066](https://github.com/openclaw/openclaw/pull/129066) - fix(cli): 渲染 Gateway 健康 JSON 失败 [#129106](https://github.com/openclaw/openclaw/pull/129106) - fix(plugins): 在 stderr 上报告更新失败 [#129189](https://github.com/openclaw/openclaw/pull/129189) - fix(cli): 遵循 reaction 列表限制 [#129308](https://github.com/openclaw/openclaw/pull/129308) - fix: 报告无人值守补全安装结果 [#129320](https://github.com/openclaw/openclaw/pull/129320) - fix(cli): 在根帮助中遵循容器选择 [#130403](https://github.com/openclaw/openclaw/pull/130403) - fix(tui): 显示 agent 作用域的会话示例 [#130519](https://github.com/openclaw/openclaw/pull/130519) - fix(tasks): 跳过已完成的已删除 agent 存储 [#130554](https://github.com/openclaw/openclaw/pull/130554) - fix(update): 保持修复 JSON 的 stdout 可解析 [#131411](https://github.com/openclaw/openclaw/pull/131411) - fix(cli): 将失败的本地 agent 轮次报告为不成功 [#132155](https://github.com/openclaw/openclaw/pull/132155) - fix(cli): 在 agent JSON 失败中保留 Gateway run ID [#133006](https://github.com/openclaw/openclaw/pull/133006) - fix(cli): 在缓存帮助之前遵循 profile 选择 [#133148](https://github.com/openclaw/openclaw/pull/133148) - fix: 保持 CLI 表格行与 CRLF 值对齐 [#133249](https://github.com/openclaw/openclaw/pull/133249) **文档** - 在 CLI 示例中显示绝对配置路径 [#114595](https://github.com/openclaw/openclaw/pull/114595) - 文档:修正目录 JSON 失败封装 [#124989](https://github.com/openclaw/openclaw/pull/124989) - 记录由 ZDOTDIR 选择的 Zsh 补全配置 [#125247](https://github.com/openclaw/openclaw/pull/125247)备份、恢复、重置和卸载
重置和卸载 现在会拒绝删除数据,直到 Gateway 服务被拆除,并且 OpenClaw 能够确认没有其他进程拥有该状态。如果拆除或所有权检查失败,状态将保持原样,而仅状态卸载会保留已配置的工作区。
新的完整备份会保留已配置的代理状态根目录和安全的相对链接,避免将正在进行的归档工作误判为停滞,并通过相同的受保护流程恢复默认或自定义布局。受管理的 dev/ 检出和本地源码编辑仍需要单独备份,而包含绝对路径生成的 plugin-skills/ 链接的旧归档仍会被拒绝。
已知存在漏洞的 Node 和 SQLite 组合现在会在状态打开前停止,并提供指导,说明需要升级的是嵌入式 Node 运行时还是共享系统 SQLite 库。
来源和完整变更列表
改进
- 添加支持新鲜度跟踪的定时、版本化 Git 备份 #122485
- 为完整备份添加先验证的暂存恢复 #122750
- perf(sqlite):在当前状态下跳过架构写锁 #126825
- 移除冗余的健康数据库完整性扫描 #115005
- perf(state):在缓存事务中避免重复的所有权读取 #128161
错误修复
- fix(sqlite):拒绝易受 WAL 损坏影响的运行时 #106065
- 在配置恢复前验证精确备份 #117100
- 在恢复前迁移并验证配置备份 #120475
- 防止在共享状态检查期间 Windows 启动停滞 #122518
- 使新建的默认配置备份可恢复 #123504
- 在发布备份前拒绝无法恢复的符号链接 #123672
- 在触及实时状态前拒绝重复的 Gateway 启动 #124653
- fix(backup):保留包含受管理的运行时符号链接的完整备份 #124821
- 在实时状态被拥有时拒绝重置或卸载 #125253
- fix(backup):保留已配置的代理状态根目录 #129773
- 保持 Gateway 模型探测无状态 #103651
- 当私有状态 chmod 报告 EROFS 时,恢复 WSL2 上的 Gateway 启动 #108258
- 防止远程目录升级后 Gateway 中断 #113875
- 当 Gateway 移除失败时保留用户数据 #113887
- 防止已卸载的 npm 插件重新出现 #113902
- 将 Gateway 清理提示限定在检测到的额外服务范围内 #115559
- 防止虚假的备份停滞和稀疏验证失败 #122213
- 防止读取大文件期间出现虚假备份超时 #122235
- 从备份中排除瞬态状态临时文件 #122250
- 让 Windows 安全门控在 PowerShell 冷启动时保持可用 #123633
- 卸载时移除隔离的 npm 插件项目 #123973
- 将 npm 插件清理限制在拥有的根目录内 #124608
- 使备份创建输出错误可操作 #124894
- 启动时修复旧的位置移动表 #125583
- 防止部分或存在竞争的 Fleet 备份归档丢失 #126942
- fix(backup):将外部受管理技能符号链接目标声明为备份资产 #132973
- 显示配置备份清理失败 #105307
- 修正使用共享库的 Node 构建的 SQLite 安全指导 #107771
- 根据链接的 SQLite 构建定制系统 Node SQLite 警告 #107990
- 澄清安全的 SQLite 维护行 #108382
- 限制 macOS 进程启动时间探测 #109064
- 报告代理删除清理失败,而不是静默成功 #110560
- 保持旧版工作区证明行可读 #113686
- 在 npm 覆盖错误后清理受管理的插件对等依赖 #116675
- 报告真实的备份 tar 尝试次数 #119197
- 阻止失败的备份声称已完成 #124135
- 解释无效的备份和配置文件输入 #124510
- fix(plugins):在对等依赖规划前规范化受管理的 npm 覆盖 #124532
- 以 JSON 报告离线代理删除失败 #125715
- fix(backup):拒绝格式错误的 git log 限制 #127875
- fix(backup):恢复已验证的归档相对硬链接 #131199
- 使基于路径的代理捕获清理原子化 #98852
文档
- 记录已验证的备份和回滚工作流 [#108159](https://github.com/openclaw/openclaw/pull/108159)
- 添加完整的操作员备份指南 [#122196](https://github.com/openclaw/openclaw/pull/122196)
- 记录手动完整归档恢复流程 [#86971](https://github.com/openclaw/openclaw/pull/86971)
- 记录备份易失性路径排除项 [#99007](https://github.com/openclaw/openclaw/pull/99007)
</details>
本页原文 Markdown:在 AtomGit 查看·内容源自开源项目 cl/openclaw