TL;DR - 一个零新功能的补丁,做了把「我说成功了」换成「我能证明成功了」这件事

2026 年 11 月 5 日,OpenClaw 发布 v2026.11.1。官方 release notes 第一句就写明:“This patch release adds no new features.”——这是一个不加新功能的纯补丁版本,规模却有 83 个 pull request、91 次直接提交、67 位贡献者(pull request 数已包含通过回溯引入的上游工作,且不重复计算回溯包装提交,直接提交含发布适配)。

它修掉的核心不是能力,而是可信度:已接收的消息被拒、Doctor 检查失败却报成功、Gateway 配置写入卡死。对已经把 Agent 塞进生产链路的企业用户来说,这一版的信号很明确——可观测性与失败可见性不再是加分项,而是准入条件。

一、版本本身:不加功能,只修「假成功」

先把规模摆清楚。83 个 PR、91 次直接提交、67 位贡献者,官方在 release notes 里明确解释了计数口径,这种「主动交代统计方法」的做法本身也是可信度信号。补丁覆盖的模块横跨安装与引导、Web UI、更新与维护、消息通道、记忆、技能、原生 App、模型与供应商、自动化与调度、浏览器与计算机使用、插件与集成、安全与隐私等 11 个板块。

按官方归纳,补丁针对的就是三类信任故障:

  1. 已接收的消息被拒(accepted messages being refused)
  2. 失败的 Doctor 检查被报告成成功(failed Doctor inspections reported as successful)
  3. Gateway 配置写入卡死(Gateway configuration writes getting stuck)

同一批改动里还有一条对国内团队影响直接的修复:飞书(Fuishu)在工具调用之间丢失流式文本、动作卡片格式发错,以及 iMessage 在 PostgreSQL 支撑的状态下启动失败(同时保留既有 SQLite 恢复位点)。

二、第一类假成功:已接收的消息被拒

这是运维体感最直接的一类故障——用户明明看到消息发到了机器人,Agent 却回答”我收到重启提示""消息被拒绝”。

  • Telegram:已接收的消息在处理期间有时会收到假的重启拒绝,或者丢失兜底回复。对应 PR #179200、#179385,并经发布回溯 #190034 落地;问题由 #178554 报告,修复者为 @steipete。
  • Telegram 队列:排队的回复会在上一轮对话结束后失败。对应 #189457,贡献者 @vincentkoc。
  • Discord:已接收的消息在等待处理期间被直接拒绝。对应 #179704。
  • Webhook:同类问题一并覆盖在 #189457 之内。

这一组修复的共同点是:过去 Agent 的”拒绝”和”已接收”在通道层没有严格区分,于是用户拿到的是自相矛盾的反馈。“我拒绝了一条你确定我收到的消息”和”系统告诉我成功、其实什么都没发生”,是同一类信任损耗。

三、第二类假成功:Doctor 检查失败,却报成功

这是本轮最值得企业用户单独划重点的一条。

修复前,当检查过程被阻断、最终配置无效、或者所需迁移被延后时,Doctor 依然会报告成功。修复后:

  • Doctor 在这些情况下返回非零退出码;
  • 使用 doctor --json 的脚本必须处理新的退出状态;
  • 无人值守的 Doctor 只报告缺失插件,不再自动安装,除非显式提供 --fix、--repair 或 --yes。

对应 PR #187192 与 #191523,贡献者包括 @steipete、@JordanNewell、@brandonulrich。

这条改动的分量比它的篇幅重得多。“体检报告说没问题”是运维体系里最危险的一句话——它会把”检查没跑完""配置不可用""迁移被推迟”三件事,统一伪装成绿色。改成非零退出码之后,CI 里的定时体检才真正具备拦截能力;而”不自动装插件”则把安装动作的授权权明确还给了人,避免无人值守环境在没有审批的情况下改变生产依赖。

配套的 Doctor 修复还有一长串:保留空的或继承来的群组白名单(#174787)、拒绝导入含畸形 UTF-8 的被篡改旧文本(#180861)、保留无效的旧心跳小时值并指出应修正的取值(#186305)、从过长会话归档路径中恢复而不删除原始会话文件(#187443)、用全新 Doctor 处理 2026.10.7 至 2026.10.9 的迁移失败(#189713)。

四、第三类假成功:Gateway 配置写入卡死,以及密钥不再被覆盖

Gateway 配置写入卡死的修复对应提交 77a79f6 与 d79f192(适配 PR #192701,贡献者 @RomneyDa):Gateway 设置变更在等待生效时卡住不再发生,通道重启也变得更可靠。同一版本还为托管 Gateway 服务启动提供了更具体的就绪状态消息——例如服务保持停止状态、或健康检查超时时,现在会明确说明原因(PR #190034)。

安全侧的修复更值得逐条读:

  • Mac 上保存 Gateway 支撑的 Browser 或 Tailscale 设置失败时,不再用脱敏占位符覆盖已存凭据;
  • 在已连接的 Mac 应用中关闭 Tailscale 暴露,不再删除 Gateway 认证设置(注意官方明确说明:已经丢失的凭据不会自动恢复);
  • 相关 PR 为 #187734、#187664,修复 #187600、#187597,贡献者 @anmol0b。

另外,安装器创建的目录与符合条件的 Linux 服务状态目录改为私有权限(提交 a77900f);从根目录启动的服务在 POSIX 系统上找不到可用 Node 运行时的问题也被修复(#178112)。

五、会话韧性:被中断之后,不再从头开始

除了三类假成功,这一版还集中修了一批”上下文断裂”问题:

  • 超大 turn 保留有用历史,并可在反复压缩中保住当前请求(#191146、#181966、#186380,修 #191133、#181945);
  • 停止首个 Claude CLI turn 不再让下一条消息从头开始——Claude CLI 会话在原生会话已保存时停止第一轮后失去连续性的问题被修复;
  • Codex 保留兼容的线程历史,可在瞬时重试后恢复答案而不重跑已完成的工具;找不到原始 Codex 线程时会明确报错,而不是静默从头开始;
  • 被 /steer 消费掉的消息不再一直挂在 pending 状态(提交 9c3915e);
  • 模型选择器在预算小于模型上限时,同时显示”有效上下文预算”(提交 ecbc229);
  • Control UI 某个可见标签页在 Gateway 连接静默失联后可自动重连(提交 c852d21)。

记忆模块同样被优化:降低读取与索引大型会话历史和归档所需的工作内存,并支持在相邻大消息间导航;如果导出过程中会话记录发生变化,OpenClaw 会回退到一致的快照。

六、安全侧:这一版真正收紧的 6 处

补丁里安全与隐私板块的条目,密度高于一般补丁:

  1. Discord 附件与贴纸下载不再继承宽泛的浏览器内网访问权限(若 CDN 解析到私有地址,需自行加入 browser.ssrfPolicy.allowedHostnames);
  2. ClawHub 归档下载与重定向被限制在配置的 registry 与 codeload 源内,私有源不再被跟随;
  3. ClickClack 跨源重定向到私有 HTTP 地址被阻断;
  4. 秘密出口代理不再信任仅依赖 esign ECC G3 根证书的信任链(需重启 Gateway 生效);
  5. 流式回复暴露分块或嵌套内部推理块的问题被修复;
  6. 无效的日志脱敏设置不再隐藏配置告警或中断 Doctor 恢复。

对做私有化部署的团队,第 1—3 条尤其重要:内网可达不等于应当可达,这三条把”浏览器/下载器可以打到哪里”这件事从隐式假设变成了显式策略。

七、同一时间窗的两条产品线:Multiplayer 与 2026.11.5-beta.1

v2026.11.1 之外,官方在 11 月 4—5 日还补上了此前缺失的产品故事。

Multiplayer(多人共享同一 Agent)于 11 月 5 日由 OpenClaw 博客公布,并在旧金山 GitHub Universe 活动上做了现场演示:两台笔记本电脑连接同一个 OpenClaw Agent,大屏渲染旧金山 Fort Mason 的实时 3D 场景;参观者在第一台电脑上输入”Add the Statue of Liberty”,输入过程实时出现在第二台电脑上,随后在第二台电脑输入”Make that three times bigger”,自由女神像随即放大三倍。官方称整个演示无需解释指的是哪个对象,也不需要复制此前提示词或让 Agent 重建他人的工作。

Multiplayer 定位是消除”Agent 孤岛”:工程、产品、市场、销售、QA、DevOps 各用各的 Agent、各自的模型和上下文,协作时要口头转述提示词,导致上下文丢失、指令变形与修改冲突。机制上,Multiplayer 通过共享队列协调请求,用户能看到 Agent 是否忙碌,避免盲目提交冲突指令。官方称已在内部使用,约 50 多人参与同一共享环境协作;该功能免费、开源,采用 MIT 许可证,不绑定模型(可自带 OpenAI、Qwen、Claude 或本地模型),可在自己机器、VPS 或其他环境运行、修改与扩展。报道同时提到 OpenClaw 已有 8.3 万个 fork。

2026.11.5-beta.1 则是功能线上的新列车,规模约 10,222 个 PR,主要内容有:

  • Knowledge Scribes:把知识捕捉与可复用的 scribe 工作流做成跨 Agent、跨会话、跨 Control UI 的一等公民(#185583、#185637、#185974、#186270、#186455、#187659,贡献者 @jalehman);
  • PostgreSQL 数据面:新增 PostgreSQL 支撑的状态、迁移工具链与既有部署的兼容覆盖(#173968、#174080、#174085、#174183、#174242、#174374、#174387、#174399、#174623,由 @steipete 主笔);
  • Control UI:移动端与桌面端的导航、布局与交互细节整体重构(#176356、#176466、#176505、#176540、#176557、#176653);
  • 从对话直接发起 PR:端到端的 PR 提交、审查与发布;
  • 扩展云端与设备端执行。

需要注意的是版本通道:npm 的 latest 仍是 2026.11.1,beta 版本走独立的 beta 通道。生产环境此刻应该停留在 2026.11.1 并观察 beta 收敛,而不是提前切 beta。

八、风险面:2026.11.1 上仍未收敛的 issue

补丁修掉历史问题,不等于当前版本没有遗留问题。第三方追踪站点 ClawStat 在 2026.11.1 上标注的未收敛项包括:

  • #193928:消息丢失;
  • #193590:大状态卡顿;
  • #193997、#194101:其他未决问题;
  • #193441、#193684、#194016、#194035、#193734:一批更新失败报告。

其官方口径是:下一个 stable 版本(排在 2026.11.5-beta.1 之后)才带上 #193928、#193997、#194101 的修复。这直接构成了一条运维建议——升级到 2026.11.1 解决的是”假成功”,但消息丢失与更新失败这两类问题,仍需等下一个 stable。凡是消息丢失会造成业务损失的通道,现阶段应保留人工巡检或双通道冗余。

九、对企业用户的判断:可观测性从「加分项」变成「准入条件」

把这一版的改动放在一起看,主线非常清楚:小龙虾的竞争焦点正从「功能数量」转向「信任可见度」。

第一阶段是把「我说成功了」变成「我能证明成功了」:非零退出码、可核验的 Doctor 报告、不再假绿的检查结果、不再假拒绝的通道回复。第二阶段是把上下文从会话内存搬进可复用的数据层:PostgreSQL 数据面、Knowledge Scribes、Multiplayer 的共享上下文。

对企业用户,这两件事是同一件事的两个面。**如果 Agent 在生产链路上,系统就必须能回答三个问题:它刚才做的是不是真做了?它失败的时候是不是真的告诉我失败了?它做的这些,别人能不能接着往下走?**v2026.11.1 回答了前两个,2026.11.5-beta.1 回答了第三个。

对做企业级 Agent 落地的团队,可以直接落地的动作有三条:一是把 doctor --json 的退出码接进 CI,失败即拦截,不要只看输出文本;二是清理无人值守环境里对 Doctor 自动安装插件的依赖,改成显式 --fix 审批流;三是在升级到 2026.11.1 后,专门复测 Telegram、Discord、Webhook 与飞书四条通道的”已接收消息”路径,确认兜底回复与流式文本不再丢失。

FAQ(高频问题直答)

Q1:v2026.11.1 有新功能吗?为什么一个补丁要动 83 个 PR? A:官方明确写了”adds no new features”,它是纯补丁。但”无新功能”不等于”小改动”:83 个 pull request、91 次直接提交、67 位贡献者,原因是这一版修的是分布很广的底层信任故障——通道投递、Doctor 判定、配置写入、会话恢复、凭据保护、内存索引,每一条都在多个模块留下耦合。官方还交代了计数口径:PR 数已包含回溯引入的上游工作且不重复计算包装提交,直接提交含发布适配。

Q2:Doctor 开始返回非零退出码,我的自动化脚本怎么办? A:必须处理。官方原文是”Scripts using doctor --json should handle the new exit status”。过去靠解析 JSON 输出判断成败的脚本,现在应该改为以退出码为准,否则检查失败会被脚本当成成功。同时注意一个行为变化:无人值守的 Doctor 现在只报告缺失插件、不再自动安装,除非加 --fix、--repair 或 --yes。这意味着定时体检从此是”只读体检”,修复动作需要显式授权。

Q3:“已接收的消息被拒”具体影响哪些通道? A:Telegram(处理期间收到假的重启拒绝、或丢失兜底回复,PR #179200、#179385,回溯 #190034,问题报告 #178554)、Telegram 队列(上一轮结束后排队回复失败,PR #189457)、Discord(等待处理期间拒绝已接收消息,PR #179704)、Webhook(同类,含在 #189457 内)。修复贡献者包括 @steipete、@LiuwqGit、@jalehman、@vincentkoc。

Q4:关闭 Tailscale 暴露后,Gateway 认证还会保留吗? A:会。这正是 v2026.11.1 修掉的问题之一:此前在 Mac 应用里关闭 Tailscale 暴露会删除 Gateway 认证设置(#187734、#187664,修 #187600、#187597,贡献者 @anmol0b)。修复后关闭暴露不再删除认证设置,但官方明确说明:已经丢失的凭据不会自动恢复,需要重新配置。

Q5:会话被中断后丢上下文的问题修好了吗? A:修好了主要场景。超大 turn 会保留有用历史,并可在反复压缩中保住当前请求(#191146、#181966、#186380);停止首个 Claude CLI turn 不再让下一条消息从头开始;Codex 保留兼容线程历史,瞬时重试后可恢复答案而不重跑已完成的工具,找不到原始线程时明确报错而非静默重来。记忆模块也降低了读取大型历史所需的工作内存,并在读取期间内容变化时回退到一致快照。

Q6:Multiplayer 是什么?企业现在就该用吗? A:Multiplayer 是让多个人共享同一个 Agent 与同一份上下文的能力,11 月 5 日由官方博客公布,在旧金山 GitHub Universe 现场演示;免费、MIT 开源、不绑定模型,可自带 OpenAI、Qwen、Claude 或本地模型,机制上用共享队列协调请求、可见 Agent 是否忙碌。官方称内部已有约 50 多人协作使用。但它目前不在 2026.11.1 这个 stable 里,生产环境建议先观察,再评估接入流程与权限模型。

Q7:现在应该升级到 2026.11.1,还是等 beta 收敛? A:停在 2026.11.1。npm 的 latest 标签当前指向 2026.11.1,2026.11.5-beta.1 走 beta 通道。同时要注意 2026.11.1 本身仍有未收敛项:消息丢失 #193928、大状态卡顿 #193590、#193997、#194101,以及一批更新失败报告(#193441、#193684、#194016、#194035、#193734);官方口径是下一个 stable(排在 beta 之后)才带上其中三项修复。

Q8:这些信息可靠吗? A:核心事实做了多源交叉验证:官方 release notes(docs.openclaw.ai/releases/2026.11.1)与官方 Markdown 变更日志、GitHub 上的 PR 与 commit 链接、npm 包发布页、新版本追踪站点(NewReleases、Gradually AI、Releasebot)、中文社区更新日志站,以及腾讯新闻转载的凤凰网科技报道,关键数字与 PR 编号一致。但需要说明两点:一是引用-issue 编号(#193928 等)来自第三方分析站点 ClawStat 的观察,而非官方声明;二是 Multiplayer 的”50 多人内部使用""8.3 万 fork”来自官方博客与媒体报道口径,属自述数据。

关键术语(Key Terminology)

  • 假成功(False Success):系统报告”完成/成功”,但实际动作未发生或结果无效。本文把消息假拒绝、Doctor 假绿灯、配置写入卡死归为同一类信任故障。
  • Doctor:openclaw doctor 命令,负责体检配置、插件与状态迁移。v2026.11.1 起,它在被阻断、配置无效或迁移延后时返回非零退出码。
  • 非零退出码(Non-zero Exit Code):命令行程序用退出码表达成功或失败的传统机制,是脚本可依赖的机器可读信号——本次改动正是把它变成 Doctor 的正式失败通道。
  • 回溯(Backport):把已合并到主线的修复挑拣到旧版本分支再发布的做法;官方说明本次 83 个 PR 的计数已包含回溯引入的上游工作。
  • Gateway 配置写入卡死:修改设置后一直等待生效、无法完成写入的现象,属”配置改了但系统没认”的典型故障。
  • Multiplayer:让多个人共享同一个 Agent、同一工作区与同一上下文的能力,2026 年 11 月 5 日公布,MIT 许可、不绑定模型。
  • Knowledge Scribes:2026.11.5-beta.1 引入的知识捕获与可复用 scribe 工作流,跨 Agent、会话与 Control UI。
  • PostgreSQL 数据面:把 OpenClaw 的状态存储迁到 PostgreSQL 的方向,配套迁移工具链与既有部署兼容覆盖,让上下文从会话内存进入可复用数据层。

参考资料

官方一手

版本追踪与二次报道(多源交叉验证)

Multiplayer 相关