OpenClaw 24h 更新快报(2026-11-23):自更新链路、准入鉴权、模型接入

内容管家 新闻 AI领域评论0字数 2962阅读9分52秒阅读模式
OpenClaw 24h 更新快报(2026-11-23):自更新链路、准入鉴权、模型接入

OpenClaw 24h 更新快报(2026-11-23):自更新链路、准入鉴权、模型接入

过去 24 小时,openclaw/openclaw 合并了 165 个 PR,重心落在两条底层链路。自更新机制被整体改写:Git 安装与包安装都不再原地替换运行中的代码,而是先在旁侧备好新版本,由常驻 launcher 切换并保留回滚能力。Gateway 的鉴权也统一成「只在请求开始时校验一次」,运行中的请求不再因为中途的权限变更被 401/403 打断。此外,「没配模型却默认调用 OpenAI」这个老行为被移除。

一、自更新链路改写:不再原地替换运行中的代码

过去 Git 安装的更新是在运行中的 Gateway 底下原地替换代码,并通过一个托管服务交接助手完成切换。新版本起不来时,恢复动作依赖这个助手和已经装在机器上的旧更新器,一旦失败就可能把 Gateway 留在 update-recovery-pending 状态无法启动。PR #203194 把这条路径换成「prepared release + 常驻 launcher」:更新请求先做准入、目标解析和 preflight(Node 版本、必需工具、磁盘空间,容器内安装直接拒绝),然后用 git worktree 在运行版本旁边构建新版本,运行中的 checkout 完全不动;新代码以离线方式针对当前配置与状态跑一遍 openclaw update check-release,把有问题的插件或配置面报出来,但不做状态迁移;随后发布为 pending trial 并重启 Gateway,launcher 在下一个子进程启动时切换 release 链接,新 Gateway 健康就提交这次 trial,不健康就回滚并拉起上一个版本。插件维护改由已发布 release 执行,插件出问题只记为一个 plugins 步骤和一条 next action,不会让整次更新失败。

包安装此前是另一套逻辑:npm、pnpm、Bun 的全局更新直接替换 node_modules 下正在被服务的包,坏候选或重启失败就会把 Gateway 停住。PR #203497 让包安装也走同一条 release 路径:包在 node_modules 之外打包并解包,生产依赖再装进去,服务中的 Gateway 在准备期间保持在线;加 --no-restart 会把 trial 留到下一次启动再激活,同样带回滚保护。这次改动净删了约 8000 行测试与支撑代码,说明旧的在位替换执行器确实已经退场。代价是几个边界暂时保守:update.run 协议还没有携带 channel、accept-capabilities 和调用方 checkout 身份的字段,带 --reapply-local-overrides 的调用会被显式拒绝而不是静默丢失本地改动。

新链路也带来一串回归修复,恰好说明旧假设有多深。容器里的安装曾被 preflight 直接拒绝(提示该安装属于容器镜像),官方镜像甚至因为 Dockerfile 没有复制新的 release-launcher-forward.mjs 而跑不起任何 openclaw 命令;PR #203735 把容器环境判断从 preflight 移除,改由 install-owner 标记声明 owner 为 container-image,让官方镜像明确提示「拉新镜像重建容器」,同时修好镜像启动。PR #203769 处理了没有 systemd user bus 的宿主(容器、WSL、手动启动的 Gateway):转换逻辑不再先要求「effective」的服务读取,而是先问有没有已安装的服务定义,避免在没有 systemd 会话时卡住。PR #203588 则是 Windows 侧的老问题:重装时 System.IO.File.Replace 收到的是 PowerShell 传下来的空字符串而不是真正的 null,脚本在最后一步抛出路径非法的异常并留下旧命令包装,改用 NullString 包装后才算真正修好。

二、准入鉴权只查一次:让已开始的请求跑完

这一轮最大的系统级改动,是把 Gateway 的鉴权从「多次复核」改成「一次准入」。旧实现里,HTTP 路由在请求准入时取一份权限快照,之后在路由内部用 assertCurrent()、revalidate() 反复和这份快照比对;设备令牌路由会重新验证令牌,插件 cookie 路由会重读 cookie 授权。后果是一次无关的设置保存或角色调整,就可能让一个已经开始的请求中途收到 401/403。PR #203590 删掉了整条快照绑定机制,规则变成:请求开始时校验一次,已经开始的请求让它跑完,撤销、移除和 reload 对下一个请求生效。生产代码净减约 460 行,保留的是 Stop 与断连中断,以及数据围栏(会话生命周期、代次、媒体替换准备态等)。

同样的规则被推到其他入口。PR #203488 把会话变更守卫里的角色、scope、profile、操作者、设备撤销、共享认证代次等二次复核一并移除,改为只做一次准入。PR #203572 处理 exec 审批:worker 在提交授权时已经校验过当前策略行,提交前的启动守卫又读了一遍策略视图,导致策略在「批准到启动」之间被收紧时命令被拒;现在提交即生效,后续命令适用新策略,已启动的启动动作照常完成。PR #203487 修掉的是运行中 agent 工具调用报「agent tool caller authority is no longer active」的问题:权限撤销或重载发生在调用期间时,调用会失败并丢掉已经开始的工作,现在已准入的调用可以正常结束。后续的 PR #203760 和 PR #203664 又把剩下两处多余的 receipt 权限读取删掉。

对使用者的实际影响是:撤销某个设备或收紧某个角色的权限,不再会让正在跑的长任务半路失败,权限变化从下一个请求开始生效;需要立刻中断时 Stop 仍然可用,冲突写入也仍然会被会话代次检查挡住。这是一次「更少误杀」的取舍,代价是撤销不再具备即时打断长请求的能力。

三、模型与 Provider 接入:不再替你选模型

新装好的 OpenClaw 曾经有个隐蔽行为:没有配置任何模型时,resolveDefaultModelForAgent 会用编译期内置的 openai/gpt-6-astra 补上,于是 Models 页显示「无法加载 openai 的模型」、工具模型显示 Auto 加上 openai/gpt-6-luna,而聊天请求其实已经发往 OpenAI——用户既没选过 OpenAI,也没登录过。PR #203271(P1,XL)把这个默认值删掉:没有模型配置时,聊天会直接回一句「No model is configured」,/model 命令仍然可用,models status 和启动日志也如实报告未配置。为了不打断存量用户,Doctor 会在升级自 2026.11.6 及更早版本时把原本实际在跑的模型写回 agents.defaults.model.primary,新版本写出的配置则一律不动。

登录体验同时被统一。过去每个 provider 插件、Control UI 向导、聊天 /login 和 CLI 各自决定失败原因和措辞,同样一次失败在不同界面说法不一,还经常让图形界面用户去跑命令行。PR #203394 让失败携带类型化的原因,由一个 owner 推导恢复动作:可恢复的错误(拒绝授权、粘贴了错误地址、粘贴了登录页)保留当前尝试并就地说明原因;终止性错误(验证码过期、被拒、网络失败)给出重新开始签到的入口;粘贴框默认展开;OpenAI Codex 登录统一为先走 device code,端点不可用时自动回落浏览器登录;Control UI 与聊天里不再出现命令行指令。直接结果是登录失败路径上的生产代码比 main 少了 305 行。

模型页本身也被重做。PR #203485 把页面主角从「AI setup」卡片换成 provider 目录:热门 provider(OpenAI、Anthropic、Google、Copilot、OpenRouter、xAI、Meta)排在前面,每行写清连接方式并只保留一个 Connect 按钮,其余 provider 可搜索或展开;新用户不再先看到七个禁用状态的默认模型控件,也不再出现 acp-opencode 这类用户根本没配过的 provider 报错。配置侧则由 PR #203358 补上最后一个缺口:同一个模型在目录里可能同时有 OpenClaw 和 Codex 两种 harness,主模型与备用模型现在都能在下拉里选 harness,改一个不会牵连另一个。此外 036c7d5 修掉了删除账号后模型刷新流程卡住不结束的问题。

四、Agent 会话与自动化:后台结果不再冒充助手发言

有一个值得单独说的 bug:当自动化或子代理把结果发进聊天时,OpenClaw 把它记成一条 assistant 消息,模型看到的是「自己刚刚说的内容」,于是某个每小时的自动化跑了一段时间后,下一次回复自己续写出了二十多条不存在的「未来报告」,带着虚构的 PR 号和提交。PR #203649 把这类结果改写为带固定标签的用户输入(OpenClaw background result,它是一条记录而不是新请求),聊天里显示不变,但模型看到的是「外部送来的记录」而不是自己说过的话;标签不含时间戳或运行 ID,因此每行的请求前缀保持稳定,不会打爆 prompt 缓存。升级后,已存有后台结果的会话首次请求会有一次缓存未命中。

同类问题也出现在 GitHub 发布回执上:上一轮的发布确认在追问开始前到达时,聊天会因为「持久化的用户轮次在重放准入前发生变化」而失败,用户必须重发一遍。PR #203621 让重放跳过主机标记的待定结果,回执照常可见,追问能拿到一次正常回复。

自动化调度侧则加上了对上游限流的退让。PR #197395 规定:当超过八个自动化与 hook 代理会话共享预算时,某个 provider 返回限流或过载,就暂停该 provider 的额外工作位,把资源留给其他 provider 和命令类任务;被挂起的执行保留回执与已完成的条件检查,安静一分钟后重新排队。与此同时,c0e3bc0 直接在 cron 的保存入口拒绝跨会话的自动化工作区,避免任务被写进不属于它的会话。

五、首次上手体验:少问一句是一句

新用户连接第一个 AI 时,界面原本还要追问「是否显示 Claude Code / Codex 的历史会话」,紧接着又弹出导入记忆的对话框——只想先跑起来的人被要求先处理自己的历史。PR #202601 把这两处都拿掉:连接 AI 不再牵涉会话副本或记忆,相关能力保留在 Settings 的会话来源、侧边栏目录菜单和记忆导入入口里,随时可去、也随时可取消。

本地扫描慢也不该挡住主要动作。PR #202622 让 Control UI 与 macOS 引导页在扫描本机 AI 客户端的同时就能填 API key 或走浏览器登录,实测从进页面到可用由 10.03 秒降到 0.15 秒,迟到返回的候选也不会清空已填内容。PR #202614 停掉了 macOS 上「在这台 Mac 上运行」也会触发的本地网络搜索弹窗——它来自 Bonjour 发现,而本机端口检查并不需要网络权限。PR #203379 把 provider 的登录入口也挪到了插件设置页,不必再绕到 Models 去找。

这一轮的主线是让更新不再有断点、让权限不再半路翻脸、让模型归属回到用户手里,其余大量改动都是围绕这三件事做收尾与回归修复。

常用链接

 
内容管家

发表评论