OpenClaw 2026.11.3 拆解:解决「密钥乱跑」和「假成功」
11 月 8 日刚发完体量庞大的 2026.11.2(115 个 PR),仅仅两天后的 11 月 10 日,OpenClaw 又甩出了 2026.11.3。这一版很小,整个区间只有 34 个 PR,发布说明开头一句话定了性:这是一个「以可靠性和安全为核心的维护版本,仍然没有任何新配置项、也没有新功能」(no new configuration options or features)。
一、OpenClaw 是什么
新读者先补课,老读者可略过。
OpenClaw 是一个开源、本地优先(local-first)、可自托管的个人 AI Agent 运行时。它的核心是一个常驻在你自己机器上的 Gateway(网关):对上,它是一层不绑定厂商的模型抽象,OpenAI、Anthropic、Google、火山方舟、本地 llama.cpp 都能即插即用;对下,它接管多智能体、记忆库(向量检索 + 全文索引)、几十个消息渠道、MCP 插件体系、浏览器和定时任务。最关键的是那句老话——数据在你手里,密钥在你机器上,模型随你换,代码全开放。
二、这一版的 Highlights:七件事,全在修「边界」
官方列了七条重点。
1. 私有子任务的结果,不再漏进聊天流(#188490)
这是本版我最在意的一条。多智能体架构里,父任务会派生子代理去干脏活累活,子代理的产出本来应该内部消化。但此前这些「私有完成结果」可能被卷进流式聊天回复里——意味着你在 IM 里本该只收到一句干净结论,结果后台子任务的内部内容也被外发了。现在它被牢牢挡在聊天流之外。
2. 父任务取消子任务后,能干净地交接(#178893,关联 #178565)
这是个典型的并发坑:父任务取消一个子任务、转头把活儿交给替代方案,结果那个已经被取消的子任务留下一张「完成回执(completion receipt)」,像块石头堵在交接路上,整个流程僵住。现在这张回执不再阻塞交接。
3. 工具失败了,必须喊出来,不许再假装成功(#182458,关联 #99645)
这条值得加粗。此前一个面向用户的轮次里,如果某个工具调用失败、又没人接住这个失败,系统可能静默地把这一轮标记为「成功」——你以为事办完了,其实根本没办。现在这类「无人应答的工具失败」会被明确上报。
软件可以失败,但不能撒谎,这是我非常认同的工程伦理。
4. 卡死的供应商认证,到点就杀(#189144)
模型供应商认证一旦挂住,以前可能无限期等下去。现在运行截止时间一到就终止,而且取消动作会真正穿透整个认证流程,不会出现「上面喊停、下面还在傻等」。
5. 沙箱里的图片预览,就算开了「完全访问」也不许越界(#176203)
这条很妙:需要沙箱保护的图片预览,被强制限定在允许的文件夹内,即使用户处在 Full Access 模式也一样,同时保留管理员显式授权的图片。换句话说,安全底线不因为你开了高权限模式就自动失守。
6. 工作区连接先验证书,再发数据(#125646、#190002)
两处加固:当传入空指纹时,保住你之前保存的节点证书固定(pin),不被空值覆盖;在任何凭证或数据发出之前,先验证 workspace-transfer 证书。这是远程节点、多机协作场景下防中间人、防误发的关键。
7. 网关启动更快,遇到超长标点不再卡顿(#192217、#184433)
一边削减启动时模块文件的加载开销,一边修掉 abort-command 检测撞上长串标点时的停顿。属于日常「更跟手」的体感优化。
七条看下来你会发现,没有一条是「锦上添花」,全是「边界收口」——任务的边界、权限的边界、凭证的边界、失败的边界。
三、对中国用户,这一版的好处到底在哪
这一版没有像 11.2 那样直接点名飞书,但它修的东西恰恰是国内深度用户每天都在踩的底层暗礁。我挑最实在的讲。
第一,本地明文存多把 key 的人,这版是为你修的
不少人跟我一样,一台机器本地跑着 OpenClaw,明文配着火山方舟、Firecrawl 搜索、embedding、各类插件的一堆密钥,本地自托管,图的就是个方便。明文存储你能接受,但真正可怕的是运行时密钥乱窜:A 插件的 key 被 B 插件看到、缓存结果不按凭证隔离、报错信息把你的 key 原样回显、子进程顺手继承了根本不属于它的网关密钥。这一版的大半 Fixes 都在堵这些窟窿——越是本地明文部署,这种进程级隔离就越值钱。
第二,多 Agent 外发内容更干净,内部信息不外泄
国内玩家很喜欢开多个角色 agent 跑后台。私有子任务结果不再进聊天流(#188490)这条,直接保证了你从飞书、IM 收到的,只是该给你看的结论,而不是后台子代理的私密中间产物。
第三,定时任务不会再「假成功」糊弄你
用 cron 跑日报、监控、自动巡检的人都懂那种崩溃——日志显示成功,实际某个工具早挂了。工具失败显式上报(#182458)之后,「办成没办成」终于有了诚实的反馈,你不用再对着一个绿色的 success 将信将疑。
第四,海外供应商卡认证、网络抖一下,不再拖垮全局
国内访问 Anthropic、OpenAI 这类海外端点,认证挂起、连接抖动是家常便饭。现在认证到点自动取消(#189144),cron 存储排队失败也不会让整个网关退出(#175678),单点故障不再殃及池鱼。
第五,Claude 额度真耗尽时,不再傻重试烧预算(#176186)
以前「额度用尽」这种错误可能被误判成临时限流,触发无意义的重试,白白消耗重试预算。现在能准确识别「彻底耗尽」,该停就停,省钱省时间。
第六,升级更不怕变砖
亲历过 openclaw update 卡死的人应该心有戚戚。这版继续治这个病:包存在性检查超时时能安全恢复、替换前强制要求新鲜有效的目录身份、并且始终保留回滚到原始包的能力(#181906)。哪怕更新中途出岔子,你也退得回去。
四、New、Enhanced、Fixed:摊开了逐条讲
New features:依旧是零,这次连新配置项都没有
官方在 Changes 区块写:「No new configuration options or features.」 这次比 11.2 还彻底——11.2 好歹有一条「诊断包瘦身」的行为变更,11.3 连一个新开关、一个新参数都没给。
Enhanced:官方不单列,但这几条本质是「能力加固」
跟 11.2 一样,官方把所有条目都归在 Highlights 和 Fixes 下,没有独立的 Enhanced 标签。但从使用者体感出发,下面这些更接近「增强」而非单纯修 bug:
多智能体的并发健壮性上了一个台阶:私有结果隔离(#188490)加上父子任务交接不阻塞(#178893),这两条合起来,让复杂的多 agent 编排更可预测。
可观测性的诚实度增强:工具失败显式化(#182458)、认证读取失败不再被含糊当成「没填凭证」(#173970),你能看到的真相变多了。
性能与响应增强:启动模块加载减负、长标点 abort 检测不卡(#192217、#184433)。
Fixed defects:13 组修复,逐条带 PR 号
这是干货区,我按官方分组完整列出,并补上每条的现实影响。
1. 凭证隔离(#178444、#177974、#189423):被复用和缓存的插件结果,严格限定在各自连接凭证的作用域内;其他插件的传输 hook 也被钉在供应商自己的 origin 上,不许跨域探头。
2. 搜索与记忆凭证归位(#190706、#184966):Firecrawl 的搜索、抓取 key 只跟随其 scoped endpoint,embedding 凭证只跟随它的目标目的地,各回各家。
3. 凭证脱敏(#190618、#178745):配置读取时对内联环境凭证做脱敏;Exa 返回的错误信息里,反射出来的搜索凭证也会被抹掉。报错日志不再是密钥泄漏口。
4. 子进程环境隔离(#179198、#179415):受管的 Signal 守护进程、随包附带的语言服务器,不再继承与它们无关的网关密钥。最小权限原则落到了子进程这一层。
5. 认证错误处理(#173970、#181597):凭证「读取失败」和「压根没配凭证」是两码事,现在会区分并显式暴露;同时拒绝那种「显式选了一个属于不兼容供应商的认证配置」的错误搭配。
6. 渠道安全(#174552、#186243):Twitch IRC 的入站内容不再写进解析器错误日志;当多个 Tlon 审批同时挂起时,强制要求显式的 request ID,避免张冠李戴。
7. 定时任务(#175678、#168985):cron 存储排队失败被妥善处理,不再触发网关整体退出;当一个任务从一次性转为周期性时,正确清理掉残留的 one-shot 清理逻辑。
8. 更新流程(#177792、#187998):基于 profile 的更新能认出自己上的那把维护锁,不会自己拦自己;当更新账本(ledger)写入被延迟时,取消状态也能被保住。
9. 更新恢复(#181906):初次包存在性检查超时后进入安全恢复路径,替换前必须拿到一个新鲜有效的目录身份,且全程保留回滚到原始包的后路。
10. Anthropic 用量上限(#176186,关联 #176179):准确识别「额度耗尽」的复数型 usage-limit 错误,不再浪费针对瞬时限流才准备的重试预算。
11. 终端会话(#172431):/reset soft 现在被正确转发给网关处理,而不是粗暴地硬重置整个会话,软重置该有的上下文保留得以保住。
12. Git 恢复(#176006):Git 修复过程中,对结果不确定的命令保留「失败」状态,绝不把一个未经确认的操作当成成功——又是一条「不许撒谎」的修复。
13. 记忆供应商选择(#186310):现在能接受大小写混合写法的 none 和 auto 配置值,不再因为大小写这种小事报错。
补充一句发布流水线状态:本版 ClawHub 插件发布标注为「无常规 OIDC 候选 / 无需 bootstrap」,Android APK 仍在走原生资格与发布任务监控,Telegram beta E2E 本次未提供。但 npm 主包已正常发布并通过完整性校验,release SHA 为 847611d,带 sha512 完整性哈希,不影响升级。
五、安装与升级:纯安全补丁,建议直接升
环境要求:Node 24 分支需 24.16.0 以上,或 26 分支 26.1.0 以上,推荐直接 Node 26;macOS、Linux、Windows 均支持(Windows 建议原生 Hub 或 WSL2)。
由于这一版零新配置、零数据迁移、零破坏性变更,升级风险非常低,属于「闭眼升」那一类。
全新安装:
npm install -g openclaw
常规升级,优先走内置更新器:
openclaw update
openclaw --version
openclaw doctor --fix
如果你的机器跟我一样,openclaw update 会在备份 worker 阶段挂起,直接用 npm 手动升级兜底,绕开出问题的更新编排、只跑包自带脚本:
npm i -g openclaw@2026.11.3 --allow-scripts=openclaw
openclaw --version
openclaw doctor --fix
看到版本号 2026.11.3(对应提交 847611d)就完成了。
写在最后
从 11.2 到 11.3,只隔两天,PR 从 115 缩到 34,看着像是个「小补丁」,但它瞄准的全是真正成熟的软件才会在意的东西:密钥会不会在进程之间乱跑、子任务的隐私会不会漏到公屏、失败会不会被粉饰成成功、卡住的认证会不会无限占用资源。
这些东西用户平时看不见,可一旦出事,就是密钥泄漏、任务白跑、网关瘫痪。OpenClaw 愿意在没有任何新功能可宣传的情况下,专门发一个版本去填这些坑——这或许正是它能被巨头反复「致敬」,却依然让人愿意把整个工作流托付给它的原因。