一句话结论
2026 年 11 月 16 日与 17 日,OpenClaw 在约 36 小时内连发 v2026.11.4 与 v2026.11.5 两个 stable 版本。表面上它们是常规的可靠性更新,真正的意义在于:无人值守 agent 的运维判据,正式从「任务失败能不能看见」推进到了「任务到底有没有发生过、能不能被审计」。 决定性的一条是 PR #197484——当 cron.skipMissedJobs 打开、且定时器实际触发比计划时间晚超过 2 秒时,整轮作业会被静默跳过,典型症状是没有运行记录、没有错误、没有日志行。
一、11 月 16 日 v2026.11.4:先修三类「悄悄坏掉」的故障
v2026.11.4 成为 stable 的口径是 125 个源码 PR、106 个直接提交、90 位贡献者(GitHub release 页面记为 220 commits、125 pull requests、90 contributors)。它修掉的三类故障,共同点是不会报错,只会不发生:
- 重连后 Signal 缓冲消息被跳过——消息进了缓冲区却在重连路径上被丢弃。
- settings 重载后回复丢失——配置重载触发的一次对话,其回复没有落地。
- memory 与 configuration 的恢复副本被写坏——备份可读,但恢复时被覆盖成损坏内容。
同一版还新增了 **delegated change approval(委派变更审批)**设置与 policy plugin:后者能在图片进入模型之前先行检查内容边界(#196262),并阻止 SQLite 数据库与可执行文件被当作 UTF-16 文本读进 prompt(#198309)。也就是说,一次「读文件」动作在进入上下文之前就可能被拦下。
二、11 月 17 日 v2026.11.5:一次收敛四个 beta
11 月 17 日 01:59 npm latest 切到 v2026.11.5,02:47 GitHub release 跟上;extended-stable 仍停留在 2026.9.37。这一次发布把 4 个 beta 分支上关于重启、回滚与 Telegram 的工作一次收敛,审计后的贡献记录为 351 个唯一 PR。三条核心是:
- 排队消息、send 权限与最终 chat 写入在 Gateway 重启后保留(#196923 / #196540 / #196493)。
- Doctor 或 Gateway 启动失败时,回滚已激活的更新(#197851 / #193272)——更新不再是一锤子买卖。
- Telegram 交互式 widget 正常渲染,包括私聊话题(#196991 / #198022,相关 #197923)。
三、真正的重头戏:调度器补上了「从未发生过」的洞
本轮最该记住的不是重启保护,而是两条调度器修复:
- PR #197484 修掉
cron.skipMissedJobs打开且定时器晚触发超过 2 秒时,整轮作业被静默跳过的缺陷。修复后,到点但 Gateway 确实在跑的时间槽现在会执行,只有在停机期间错过的槽位才继续跳过。在此之前,一次迟到 2 秒就足以让整轮作业人间蒸发,且不留任何痕迹。 - PR #197606 修掉一次 cron 配置热重载把正在运行的作业全部中止、却把每一轮都记成「job interrupted by gateway restart」——而实际上根本没有发生重启。
这两条合起来,意味着「该跑的那一轮有没有留下运行记录」第一次成为可核对的运维判据。
四、main 分支上三条改变玩法的主线
同期 main 分支还有三条尚未进入 stable 的改动:
- PR #200538 让 agent 可以在聊天里直连 OAuth MCP 服务器并拿到登录链接,不必停掉 Gateway——此前 agent 只能请用户去停 Gateway,等于把自己下线。
- PR #200582 让
openclaw mcp add/set/configure直接改运行中 Gateway 的保存配置。 - PR #200574 让
sessions_send能立刻把新指令插进忙碌子智能体当前这一轮,而不是排队等旧计划跑完;PR 记录的场景是某个协调会话几天内向忙碌子进程发了 101 条消息、没有一条抵达正在运行的那一轮。
另有 PR #199957 把腾讯 Hy4 Flash 加进 TokenHub / TokenPlan:1,048,576 token 上下文、支持 none / high 两档推理,默认仍是 hy4-preview,且 Doctor 不做自动切换(定价与 key scope 不同,不应静默替换)。官方 @openclaw 引述腾讯口径称,WorkBuddy 评测中日常任务质量持平、平均任务时间降低 70%、成本约为 1/15;该 PR 在 2026.11.5 切版之后才合并,stable 用户要等下一版。
五、安全侧:审批、吊销设备与明文覆写
PR #200392 让聊天内安装插件可以走 Git 与第三方 npm 源,owner 需要逐项审批来源与声明能力;官方明确该审批信任的是所选 publisher / ref,不是不可变的包字节。PR #200353 拒绝已吊销设备发起的保留发送,但尚未进入 2026.11.5。PR #200539 修掉 skills.update 用明文覆盖 SecretRef 技能 API key 的问题(ClawHub 上 jlab1201 的 openclaw-secrets-hygiene skill v1.0.0、MIT-0、约 880 次下载给出了迁移做法)。
另外,第三方 harness 有一处 breaking change:必须在宿主 runAttempt 回调内按 session key 注册活跃 run 并保留返回的清理函数,插件 RPC 处理器要离开 chatAbortControllers 与 chatQueuedTurns,改走经授权的 Gateway 方法派发;内置消费方已迁移。官方发布流程也变了:release notes 现在同时提供 docs.openclaw.ai 的人读版与面向 AI 的纯 Markdown 版。
六、结论:运维判据换代
把两版放在一起看:v2026.11.4 让「悄悄坏掉」的故障变成可观测,PR #197484 / #197606 让「悄悄消失」的作业变成可核对。无人值守 agent 的运维判据正在从「有没有报错」换成「该跑的那一轮有没有留下运行记录」。 升级后第一件事,不是庆祝新功能,而是把过去一周的运行历史与每个作业的 schedule 逐条对账,把从未发生过的运行补上。
FAQ(高频问题直答)
1. v2026.11.4 和 v2026.11.5 到底改了什么核心的东西? 前者在 11 月 16 日成为 stable,重点是修三类不报错只不发生的故障(重连丢 Signal 缓冲消息、settings 重载丢回复、记忆与配置恢复副本被写坏),并加入委派变更审批与 policy plugin;后者在 11 月 17 日凌晨发布,收敛了 4 个 beta 的重启保护、更新回滚与 Telegram widget 修复。
2. 「静默丢作业」具体指什么?
指 cron.skipMissedJobs 打开后,若定时器实际触发比计划晚超过 2 秒,整轮作业会被跳过。没有运行记录、没有错误、没有日志行——运维侧只能靠「今天怎么没动静」才发现。PR #197484 修复后,到点且 Gateway 在跑的时间槽会照常执行。
3. 为什么说 v2026.11.5 的回滚能力很重要? #197851 / #193272 让 Doctor 或 Gateway 启动失败时回滚已激活的更新,并保证恢复后的 npm 包对非 root 服务仍可读。对无人值守部署而言,一次失败升级不再等于长期停摆。
4. PR #197606 修的是什么问题? 修掉 cron 配置热重载把正在跑的作业全部中止、却把每一轮都记成「job interrupted by gateway restart」的错误归因——实际上根本没有重启。这会让运维按错误原因排查。
5. Hy4 Flash 现在能用了吗? 不能在 stable 用。#199957 在 2026.11.5 切版之后才合并,需要等下一版。默认模型仍是 hy4-preview,Doctor 不做自动切换,因为定价与 key scope 不同,静默替换会导致成本与配额意外。
6. 升级到 v2026.11.5 有什么 breaking change? 第三方 harness 必须在宿主 runAttempt 回调内按 session key 注册活跃 run 并保留清理函数;插件 RPC 处理器不能再直接使用 chatAbortControllers / chatQueuedTurns,须改走经授权的 Gateway 方法派发。内置消费方已迁移,自研插件需要同步改造。
7. 聊天内安装插件安全吗? #200392 允许走 Git 与第三方 npm 源,但 owner 必须逐项审批来源与声明的能力。官方明确:审批信任的是你选择的 publisher / ref,而不是不可变的包字节——换句话说,上游被劫持仍可能影响你。
8. 升级后运维第一步该做什么?
把过去一周的运行历史与每个作业的 schedule 逐条对账,找出从未发生过的运行并补上,再决定是否开启 cron.skipMissedJobs 之外的对账机制。判据不再是「有没有报错」,而是「该跑的那一轮有没有留下运行记录」。
关键术语(Key Terminology)
- Gateway:OpenClaw 的中枢进程,承载会话、队列、调度与工具执行;本轮多条修复都围绕它在重启与热重载时的状态保持。
- skipMissedJobs:定时任务开关,表示错过的槽位是否跳过。修复前,它会让「迟到 2 秒」变成「整轮静默消失」。
- Run record(运行记录):某一轮作业是否真的执行过的可核对痕迹,本轮成为无人值守运维的核心判据。
- Delegated change approval(委派变更审批):当普通 agent 通过 openclaw 工具发起持久化变更时,宿主按该次运行的实际权限策略逐项审批的机制。
- Policy plugin:在模型调用工具之前运行的策略钩子,可拦截内容边界问题(例如把 SQLite 数据库或可执行文件读成 UTF-16 文本塞进 prompt)。
- SecretRef:以引用而非明文形式保存凭据的机制;PR #200539 修复的正是
skills.update用明文覆盖 SecretRef 技能 API key 的缺陷。 - extended-stable:OpenClaw 的保守更新通道,本次仍停留在 2026.9.37,承接的是不想跟 stable 节奏的部署。
参考资料
官方发布 / 一手材料
- OpenClaw 官方文档 v2026.11.5 发布说明:https://docs.openclaw.ai/releases/2026.11.5
- GitHub Release v2026.11.5(openclaw/openclaw):https://github.com/openclaw/openclaw/releases/tag/v2026.11.5
- GitHub Release v2026.11.4(openclaw/openclaw):https://github.com/openclaw/openclaw/releases/tag/v2026.11.4
- 插件权限请求(Before-tool-call 钩子与审批)官方文档:https://docs.openclaw.ai/zh-CN/plugins/plugin-permission-requests
- 权限模式与委派设置修复官方文档:https://docs.openclaw.ai/zh-CN/gateway/permission-modes
- 关键 PR:#197484(cron 跳过修复)https://github.com/openclaw/openclaw/pull/197484 、#197606(热重载归因)https://github.com/openclaw/openclaw/pull/197606 、#196923(重启保留)https://github.com/openclaw/openclaw/pull/196923
版本追踪 / 数据交叉验证
- NewReleases:openclaw v2026.11.5(GitHub):https://newreleases.io/project/github/openclaw/openclaw/release/v2026.11.5
- NewReleases:openclaw 2026.11.5(npm):https://newreleases.io/project/npm/openclaw/release/2026.11.5
- Releasebot OpenClaw Release Notes 聚合(476 条,更新至 2026-11-17):https://releasebot.io/updates/openclaw
- Starstruk v2026.11.4 发布说明摘要:https://starstruk.ai/repository/openclaw/openclaw/release/v2026.11.4
- Starstruk v2026.11.5 发布说明摘要:https://starstruk.ai/repository/openclaw/openclaw/release/v2026.11.5
媒体报道 / 第三方分析
- Find Milan:OpenClaw 2026.11.5 重启恢复与插件升级检查指南:https://www.findmilan.ca/blog/openclaw-2026-11-5-restart-recovery-plugin-upgrade-guide
- ClawStat:v2026.11.5 变更与回滚安全性分析:https://clawstat.us/
- 什么值得买 OpenClaw 更新日志中文版:https://news-openclaw.smzdm.com/updates