
OpenClaw 24h 更新快报(2026-11-22):自升级回滚、Code Mode 出 Labs、子代理唤醒
过去 24 小时,OpenClaw 的主线几乎被同一件事占据:把「自动更新」从能跑通变成敢依赖。Windows 更新回滚会留下被禁用的计划任务,macOS 打包版在欢迎页认不出自带的 SQLite,Code Mode 与 Templates 正式脱离 Labs,子代理结果唤醒则因一次线上事故改成逐条交付。
自升级链路:回滚会留坑,in-place 替换会炸收尾
这一轮密度最高的改动围绕同一件事:OpenClaw 更新自己时,会不会把用户留在半坏状态上。落地的是一条 P0、四条 P1 加若干补丁,共同指向同一个现实——多数用户跑的是 Git 安装或手动 npm 安装,而不是由 systemd/launchd 托管的标准服务。
Windows 上最严重的一条是 PR #203264。当一次更新失败并触发回滚时,恢复旧备份会撞上 SERVICE_DEFINITION_UNKNOWN: Scheduled Task changed.,计划任务被留在 Disabled 状态,Gateway 就此下线,直到有人手动执行 schtasks /Change /TN "OpenClaw Gateway" /ENABLE 再 openclaw gateway start。根因并不复杂:Task Scheduler 导出的 XML 省略了 Settings.Enabled=true,并把显式的 Enabled=false 节点按 schema 顺序写在 StopIfGoingOnBatteries 之后,而回滚校验在重新插入 Enabled=false 时把它放在了 Settings 的开头,于是备份版本与实时版本永远算不到同一个哈希,安装回执的字符串比较也带着同样的位置依赖。修复后比较不再依赖 Settings.Enabled 的位置,回滚会同时把计划任务重新启用并把 Gateway 拉起来。需要注意的是生效边界:这个修复靠「被更新的那个安装器」执行回滚检查,所以只有先升级到带修复的版本再继续更新,用户才能真正受益。
另一条 Windows 问题出在 Git 安装的包装脚本上。PR #203247 指出,install.ps1 用 PowerShell 双引号字符串拼路径时,"dist\\entry.js" 里的两个反斜杠会原样保留,更新器拿这行和 C:\repo\dist\entry.js 做精确比较,自然永远不相等,于是每次 Git 更新都跳过重写包装器,openclaw 命令继续跑旧构建、旧更新器。等到下一次 state schema 版本号上调,这个旧构建会拒绝包括 openclaw update 在内的所有命令,macOS 和 Linux 不受影响。修复后更新器改为大小写不敏感的规范化路径比较,安装器写单反斜杠,装机器的正则也接受已经写成双反斜杠的旧包装器。
更根本的一类问题是「更新替换了文件,而 Gateway 还在跑」。PR #203241 把这一类收尾失败彻底收口:Gateway 关闭时首次加载的几个模块可能已经被新包覆盖,于是 Node 抛 ERR_MODULE_NOT_FOUND,清理做不完,进程要挂到看门狗硬杀为止——实测约 325 秒。修复后同一条路径约 1 秒内干净退出,重启意图、内存索引清理、进程回收和最后的日志刷写都能正常完成,并补了一个守卫防止这类迟加载悄悄回流。对已经在 2026.11.5 或 2026.11.6 上运行的 Gateway 无效,因为它们内存里仍是旧代码,要等下一次原地替换才会吃到修复。
与之配套的 PR #203185 处理的是「会话要不要恢复」这个用户真正关心的结果:从 2026.11.5 起,重启标记的持久化和子代理结算被推迟到关闭那一刻才加载,包被原地换掉后这些文件已经消失,Gateway 因此不记录任何恢复标记,崩溃时正在工作的会话在重启后不会被接续。修复让旧 Gateway 仍能记录待恢复会话并结算在跑的子代理。
服务托管场景则卡在另一个判断上。PR #203152 处理的是 systemd 启动的 Node 版本低于运行时要求、OpenClaw 改用自带 ~/.openclaw/tools/cli-node 拉起 Gateway 的情形:此时服务主进程是启动器,真正服务的 Gateway 是它的子进程,而 maintenance drain 要求两者 PID 相等,于是每次更新都以 managed-service-stop-failed 失败,尽管 Gateway 本身完全健康。相关 issue 里有个极端例子:约 330 次失败运行,每次约 10 分钟验证,还各留下约 1.9 GiB 的状态快照,而 Gateway 一直正常对外服务。
为了让失败模式不再循环,PR #203236 给自动更新加了退避:同一失败重复出现时,重试间隔从 1 小时拉长到 2、4、8、16 小时,之后每天一次;出现新版本、一次成功更新或手动执行 openclaw update 都会重置退避。PR #203170 则把危险动作提前:需要迁移数据库时,如果有个更新器不托管的 Gateway(前台 openclaw gateway run、自定义 OPENCLAW_HOME 或外部 supervisor)还占着数据库,更新会在替换任何文件之前就停下,消息里直接点名是哪个数据库、从 38 → 43 这类 schema 变化,以及对应的 Gateway PID,并提示先停掉 Gateway 再重跑 openclaw update;不需要迁移的更新仍然照常进行。
macOS 用户这轮等来的是 PR #203177。打包版 macOS 应用的欢迎流程即使内置 Bun Gateway 已经就绪,也可能加载不出连接选项:只读 SQLite 子进程拿不到运行时选定的内置库路径,openclaw.setup.detect 直接返回 SQLite UNAVAILABLE,而不是可用的认证选项。修复让只读启动器带上 Bun 在运行时准入时选中的库路径,修复后同一条调用返回了 77 个认证选项,打包 Gateway 也正常达到就绪状态。
回滚本身还有两条独立提交补齐:2c47390 让包回滚后 Doctor 能跑完——它在保留迁移锁之前先配置共享状态 SQLite 的日志模式,好让 agent 维护写入方拿到租约;配套的 5f49bdb 让 Git 更新校验先等繁忙的 Gateway 重启完成再验证。
Code Mode、Tool Search 与 Templates 脱离 Labs
第二条主线是功能成熟度。Code Mode 和 Tool Search 早已有核心默认值,Templates 也有完整的目录、创建器和安装器,但它们的普通入口仍然藏在 Labs 里,需要额外开一次实验特性开关才能看到。
PR #203096 把这三项一次性移出 Labs:Code Mode 和 Tool Search 迁到 Settings → Agents → Agent defaults → Tools,其中 Code Mode 在被评估过的首选模型上默认选 Auto,而不是对所有模型强制打开,显式的模型/Agent 选择、Node 或可选 QuickJS 选择、native harness 行为都不变;Templates 则从 Customize → Templates 正常可用,且不会把默认值写进已保存的配置,显式写 false 依然是进阶退出项。这次改动只是搬位置,没有引入新的运行时或配置归属方,Templates 的评审、安装、草稿和发布守卫仍然是最终权威,也不授予安装或发布权限。
围绕它还有三块补丁。PR #203101 把 Code Mode 的桥接错误与「运行失败」区分开,避免把环境问题误读成任务失败;8bbb353 保证只读 worker 退役之后 Code Mode 仍然可用;a754298 则把 create-template 技能从「只能复制当前 Agent」扩展到「按描述起草」——一个角色、某个具名插件或一条新自动化都能在同一次对话里产出提案、评审卡和落地清单,具名插件只允许声明一个确切已发布的 ClawHub 版本,所有者私有细节被移进首次运行时生成的 BOOTSTRAP.md,并且其中的自动化默认声明为禁用。
子代理交付:结果唤醒与重启保留
第三条主线是子代理结果的交付时机,这里有一次被写进 PR 描述的真实事故。
PR #203176 的问题描述很具体:一个请求方派生多个 completion 模式子代理后调用 sessions_yield,只有当冻结批次里所有成员都就绪时它才会被唤醒。于是一个仍在跑、或自己卡在 sessions_yield 等后台命令的兄弟节点,会把已经完成的结果全部扣住。2026-11-21 的线上事故里,一个仪表盘父任务派生 3 个子任务并在 16:20 IST 挂起,其中两个分别在 16:26:58 和 16:29:41 完成并带着需要决策的报告,第三个一直在 exec-yield 与恢复之间循环;Gateway 日志里没有对应的 announce 运行记录,父任务直到 18:32 有人往聊天里打字才再次跑起来。状态数据库显示那两条已完成记录都是 terminal/ok,但投递状态是 pending,唤醒门禁却要求冻结批次全员通过检查。新规则是:每个就绪的结果都会唤醒已挂起的父任务,仍在工作的兄弟节点保留自己的唤醒,并在自己完成时再次唤醒父任务。
同一天合并的另外几条修的是「结果没送到」而不是「送得晚」。PR #203102 处理被复用的子会话:旧的后代已经交付结果但清理尚未结束时,普通的完成准入仍把它算作 pending,导致即使空闲的请求方也要一直等到交付超时;修复后普通准入和索引生成准入共用同一套「哪些投递结局已经终结」的判定。PR #203198、PR #203156 与 PR #203132 分别把活跃请求方背后的子代理结果、重启期间的私有子代理结果、以及重启中断交付时的子代理结果保留下来。
另有两条独立提交补的是上下文继承与重启续跑:7ad6f9c 让子代理继承已注册的项目目录,b9377c6 让保留任务里的新对话轮次在重启后能继续。
可信代理认证:把 OpenClaw 放到 Cloudflare Access 后面
第四条线让「OpenClaw 跑在反向代理后面」这种常见部署形态真正可用。
80840af 给可信代理认证增加了可选的 Cloudflare Access JWT 校验:设置 gateway.auth.trustedProxy.cloudflareAccessJwt 之后,Gateway 会用 RS256 校验 cf-access-jwt-assertion,公钥取自 issuer 下的 /cdn-cgi/access/certs,检查 iss、aud 与 exp,并从签名里的邮箱声明取用户身份,同时要求用户请求头与该声明一致。不配置则保持原有行为,服务令牌请求的结果也不变。配套的加固包括:证书读取有 64 KB 上限、每个 issuer 最多 30 秒拉取一次(失败后同样计入)、允许 60 秒时钟偏移,并且在开启校验时明确拒绝委托身份的传递。
2821214 补上了客户端一侧:站在身份感知代理后面的 CLI 没有 Gateway token 也没有密码,代理负责认证 WebSocket 升级,因此 openclaw tui、openclaw tui --url 和 openclaw gateway call 之前会直接拒绝拨号,设备根本发不出配对请求。当目标源配置了 edgeAuth 头时,本地共享凭据预检会被跳过,交给 Gateway 的设备配对决定;没有配置 edgeAuth 的目标和其他源仍按原样要求凭据,未配对的 edgeAuth 设备会被提示改用 TUI 完成配对。
模型与 Provider:选得出来,也别把该静默的回复发出去
模型侧的变化集中在「第一次用起来」和「别把不该出现的内容投递出去」。
PR #203118 修的是全新 profile 上最常见的一段流程:几乎所有浏览器/设备登录(OpenCode Go、OpenCode、OpenAI、OpenRouter、Copilot、MiniMax 等)都被声明为 credentialOnly,登录向导只保存账号;对话框里那个模型名要等 2 到 4 秒后的目录查询才可能出现,而目录查询又是去翻 recommended 行,于是用户看到一个只写着「已就绪」却不带模型名的弹窗,连「开始新对话」都没有,Agent 始终没有主模型,聊天里接着就是「先设置一个模型」。事故日志里弹窗在 +1.9 秒被关掉,目录回复在 +3.9 秒和 +5.8 秒才到;即便名字出现了,它也只钉在新会话上,Agent 的主模型仍然是空的。修复把「有没有模型可用」和「这个 Agent 选过模型没有」拆开,浏览器登录完成后能选出一个首个模型。
PR #203174 则是一个明确的回归:从 2026.11.5 起,答案文本的选择逻辑会挑走带签名的文本块——本意是取 OpenAI Responses 的 item id——但 Gemini 3 把思考签名放在答案之后的独立空 part 里,于是选中的答案是空字符串,这一轮被标记为空而不是静默,NO_REPLY 字面量被当作文本投递到了聊天里,自动化播报结果时同样会念出来。修复把签名块的选择限定回 OpenAI Responses 消息,Gemini 改用全部文本块,2026.8.2 时代的静默行为恢复。
另外三条偏效率与体验。PR #203093 让只申请 Provider API key 的插件不再顺带初始化模型专属的认证运行时,凭证选择、取消语义和模型侧行为不变,属于加载边界收敛,而不是延迟优化承诺。eac1324 修复了 OpenAI 兼容代理在多次工具调用之间丢失推理内容的问题。39dabcb 把推荐模型序列调整为 Gemini 4 Neon 排在 Carbon 之后。
数据完整性、渠道与工具链细节
值得单独提一下的是 PR #203130,它涉及一个 3.7 GB 的 Agent 数据库。Gateway 启动时的 state 升级会把状态复制到影子目录再原地换入,为了控制复制体积,超过 64 MiB 的当前 SQLite 文件被排除在拷贝之外;而跑在影子里的 Doctor 看不到已注册的主 Agent 数据库,于是删掉了它的 agent_databases 注册行。文件和数据都还在,1187 个会话、712991 条 transcript 事件完好,sessions list 和 agents list 照常工作,但这个 Agent 在配置之外唯一的归属记录没了——未配置的 Agent 会从发现列表里掉出去,直到有人再次打开它。修复后 Doctor 不再仅仅因为文件缺失就注销注册行,仍然会报告「跳过缺失的已注册 Agent 数据库」。
其余是分散在渠道与工具链上的小步快跑。PR #203234 修复 feishu_drive create_folder 不带父目录时必然失败的 bug:根目录查询走了不带 tenant access token 的底层 HTTP 实例,飞书返回 99991661,而空的 catch 把这个错误吞了,最后带着 folder_token 为 0 发出去,换来一句误导性的 1061002 params error;现在根目录查询改走同一条已认证的请求路径,飞书真的拒绝时也会如实抛出飞书自己的错误。PR #203283 消除了新会话第一条 Talk 目录读取必然失败一次的问题:首个 talk.catalog 请求总是返回可重试的 UNAVAILABLE 并标注 warming,哪怕目录构建几毫秒后就完成了;现在没有快照时会等待在途构建,受既有的 5 秒刷新期限约束。PR #203235 修了运行中的 Gateway 上 openclaw config unset models.providers.ollama 被拒的问题:CLI 构造的删除同意路径只依据已落盘的配置,而 Gateway 的守卫检查的是运行时视图——运行时里被省略的 provider models 列表和插件 schema 默认值都是数组,于是「删除」了一个 CLI 从没点名过的数组,报错里还给出 CLI 根本没有的选项。PR #203147 处理 Windows 上 OpenClaw 目录大小写写法不一致导致插件被 missing-openclaw-peer-link 卡住的问题,重装插件或 doctor --fix 都无效,因为两种拼写指向同一个目录而 OpenClaw 之前按文本比较,现在改为比对设备号与文件 ID。
这一轮提交几乎每条都源自真实失败现场,把「能跑通」与「敢依赖」的差距逐条补上。对自升级、子代理交付这类高代价路径而言,以事故为纲的节奏比再堆功能更能决定下一版可信度。


评论