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