OpenClaw 24h 更新快报(2026-11-20):重启恢复、PostgreSQL 网关、审批鉴权

内容管家 其他评论0字数 5810阅读19分22秒阅读模式
OpenClaw 24h 更新快报(2026-11-20):重启恢复、PostgreSQL 网关、审批鉴权

OpenClaw 24h 更新快报(2026-11-20):重启恢复、PostgreSQL 网关、审批鉴权

过去 24 小时,openclaw/openclaw 有超过 200 个 PR 合并。真正影响运行状态的改动集中在三处:网关重启后卡住的会话被逐一唤醒;PostgreSQL 网关上的插件与密钥读取改回 worker 执行;审批与工具策略不再在请求中途反复复核。同时,自更新链路补上了 macOS 死锁文件、Git release 目录和版本桥接这三类长期卡住升级的问题。

会话恢复:网关重启后不再“睡死”

重启恢复是这个窗口里最集中的一条线,四个 P1 级别的 PR 都指向同一个现象:会话在重启后停在一个永远不会到来的唤醒上。

PR #201970 修的是根会话发现的漏洞。根发现逻辑 resolveRootSubagentRequester 只在会话 key 看起来像隐藏子代理(agent:…:subagent:…)时沿祖先链向上走;一个用 sessions_spawn 以 visible: true 创建的可见子代理会中断这次遍历,它自己的重启标记随后因为“是 spawned child”被拒绝,真正的根会话因此从未被标记。线上表现是 root chat → 可见协调者 → 隐藏子代理这样一条链在重启后整条都没恢复。

PR #202000 修的是子代理那一侧。父会话停在 sessions_yield 等待子会话时,等待本身无法存活重启,启动流程只让子会话失败——recordRestartYieldFailure 会写出可见错误“The Gateway restarted, but the child completion this run was waiting for can no longer arrive…”。但那只是子会话的失败,它在 registry 里的 run 仍然以 yielded 状态挂着,父会话欠下的那次完成通知永远送不出去,父会话就一直停在那里。线上曾观测到父会话在一次重启后睡了两小时以上,下一次重启后又睡了一次,直到有人手写消息给它。改法是在既有的生命周期失败之后,通过既有的完成归属方(completeSubagentRunWithRecovery,settleYielded: true)结算这次精确的 yielded run,走正常的清理与投递。

PR #202044 补上了根会话的缺口。子代理由上一条处理了,普通根会话却没有任何东西结算它——completeSubagentRunWithRecovery 在没有 registry 行时直接返回,于是根会话的工作失败后就一直失败。现在 resolveSessionYieldWait 在根分支发现“没有等待中的子会话解决、但仍有子会话欠着这个 requester 一次完成”时返回 waiting,并把这次 registry 完成当作根会话唯一的唤醒源。配套的文档改动在 docs/gateway/restart-recovery.md。

PR #202043 处理的是另一个让人无从下手的场景:打开一个旧会话的 Review,如果它的 worktree 已被清理,只会报一句“Local workspace review owner changed”,没有任何可执行的下一步。现在 Review 会明确告知该会话的 worktree 已被移除,并指向 Settings > Worktrees 里的 Restore,或者干脆开一个新会话;缺失的 registry 记录也会给出同样的指引,而真正的 owner、仓库、分支与检出路径不匹配仍然是错误。

审批与工具策略:权限只在请求开始时校验一次

这一组改动共享同一条仓库规则——检查一次权限,在工作开始时;撤销适用于下一个请求,已经开始的请求允许跑完。此前大量代码在请求生命周期中途反复复核权限,结果是人工已经批准的变更被静默丢弃。

PR #201998 是其中体量最大的一处(size: L,并带 security-sensitive-changed 标记)。一个委派的 system-agent 变更(配置修改或插件安装,人工批准或“自动批准变更”授权)在请求开始后几乎每一步都要重新检查发起方的权限:对账之后、解析提案时、应用非 deny 决策前、持久化效果边界(含对 auto-approve 授权的一次晚期复核)、继续修正之前、决策续接时,以及对账轮询里。若在人工批准之后该次运行结束,已批准的变更会被静默地不执行。现在运行权限只在请求准入时检查一次,准入逻辑本身保持不变,上述复核与对账轮询被移除。

同类问题在节点路径上被逐个清理。PR #201947 处理 node.invoke 对转发的审批在已被接受后仍多次复核存活状态——策略存活回调里、策略 await 之后真正走 transport 之前、registry 最终的 isDispatchAuthorized;如果审批的保留绑定在命令准备期间发生变化,已经开始的命令会被“approved runtime authority closed before node dispatch”拒绝。PR #201968 处理插件节点审批,它在一个审批的多个阶段重复调用 isCurrent——请求审批时、放置授权解析后、决策到达后、消费后的第二次决策投影、以及授权保留之后,结果同样是已经开始的审批可能被拒绝,或在执行中途变成空决策。

PR #196907 修的是一个更实质的工具策略漏洞:一个声称了并不属于自己的 plugin owner 的 node tool,可以通过“按 plugin ID 放行”的白名单——只要该工具最初是通过宽泛的插件授权进入的。现在按 plugin ID 的白名单条目只放行所有权在 node tool 物化时已被验证的工具;cron job 从创建者捕获的工具同理;使用保留 owner 名的大小写或空白变体、但并非真正 node-MCP 描述符的条目也不再蒙混过关。

PR #136506 收紧了语音通话的绑定边界。Twilio realtime 流启动时,WebSocket 可能与生成其 TwiML 的那个签名已验证的 webhook 请求所不同的通话身份关联;而一个签名合法但 CallSid 缺失或只有空白的 webhook,还能铸造出一个未绑定的一次性流 URL。现在 TwiML 路径在发出任何 Stream 响应或一次性流会话之前,先 trim 并要求签名已验证的 CallSid,缺失或空白则返回既有的、不泄露信息的拒绝响应。

PR #202072 则是一个被吞掉的错误:原生审批投递之后,route coordinator 还会给请求来源的聊天发一条通知,这条通知同时是原生投递没送到人时的手工兜底(“Approval required. I could not deliver the native approval request. Reply with: /approve …”)。如果这次发送失败,catch 会吞掉错误且不留任何日志,注释还假定审批投递已经成功——但对兜底路径这个假定并不成立。现在发送失败会带上审批 id、频道和错误打一条 warning(通知正文不入日志),运维能看到卡住的原因,而不是面对一次静默停滞。

顺带解决的还有 scope 缺失。PR #201883 指出,用 openclaw worktrees create 建起来的托管式 worktree 里干活的 agent 无法发布自己的成果:github_publish 提示未绑定会话“把 workspacePath 设为检出目录再发布”,网关却用 missing scope: operator.admin 拒绝了这次调用,而子代理从不持有 operator.admin,于是每次重试都以同样的错误失败,完成并已评审的工作就发不出去。线上曾观测到某个子代理在 14 小时内重试三次。改动之后,这类会话在自己的受管 worktree 内发布不再需要那个越界 scope。

PostgreSQL 网关:把插件与密钥的读取搬回 worker

当网关把共享状态放在 PostgreSQL 里时,一批需要读插件的操作会在主线程上撞上“PostgreSQL connections must run in a worker”。过去一天里,至少四条 PR 在补这条路径。

PR #201976(P1)是影响最直接的一条:控制台里的 Talk 永远停在“Talk catalog is warming”,其他按需加载插件的请求直接失败,受影响的例子包括 talk.config,以及启动时为自动化准备的 provider 认证。这个问题从 2026.11.5 开始出现,2026.11.3 没有。根因是插件加载要检查一份“未完成的插件数据迁移”台账:网关启动时在 worker 里读它,之后同步加载复用该结果,而复用键是迁移回执——自 #197510 起回执改为“查而不建”,普通网关运行根本拿不到回执,启动时的结果又没有保留,于是同步加载只能在主线程重读一遍。现在 Talk 恢复正常,按需加载插件的请求复用 worker 已经读到的就绪状态,SQLite 网关也不再在每次同步插件加载时重读这份台账,不涉及任何配置、schema 或权限变化。

PR #201063 处理的是冷启动阶段准备插件背书密钥时的失败。密钥准备现在通过 worker 读取插件元数据,web provider 发现把已读取的已安装插件记录与迁移就绪状态交给受限加载器,外部频道契约复用已准备好的 manifest registry;此外,只有 web 工具配置(tools.web 的搜索或抓取)这一个插件背书面的场景,也会一并加载插件元数据。

PR #202050 恢复了一条丢失的计费提示:模型配置编辑此前可能漏掉“从订阅凭据迁到计量凭据”的告警,因为 PostgreSQL 拒绝了网关读取用于对比路由的 auth profile。现在模型配置写入改用 auth-profile worker 做只读检查,在相关凭据可读时会照常返回既有的计费路由提示。PR #201831 则是测试补强:PostgreSQL 的 cron 覆盖此前没有证明“定时一次性任务在同一进程内于网关重启后自动重试”,新增用例覆盖了这一场景,不涉及运行时、schema、迁移或持久化格式。

自更新链路:死锁文件、Git release 目录与版本桥接

升级路径在这个窗口里被集中打通,六个 PR 都属于“曾经能把人卡住几天”的类型。

PR #201912(P0)解决的是 macOS 上一个持续数周的升级失败:在 2026.10.1 之前崩溃的网关会留下锁文件,之后每次更新都失败——Doctor 拒绝启动维护,报“Legacy Gateway lock … still has a live or unverified owner (PID …)”,更新随即回滚,尽管那个 PID 早已退出。一位报告者的 Mac 在 23 小时、20 次尝试里有 19 次以 doctor-failed 回滚了 2026.11.4 到 2026.11.5 的自动更新。根因是自 2026.10.1 起锁记录带上了 processNamespace(host、boot、PID namespace),而自 #178076 起,没有该字段的记录被视为不可验证。现在 macOS 上的更新与网关启动能自行从 2026.10.1 之前留下的死锁文件恢复;进程仍在运行、或无法证明其已死亡的锁仍会被拒绝;Linux 行为不变;拒绝信息会指明针对它实际找到的那个文件该做什么恢复操作。

PR #201917(P1)修的是托管式 Git 安装下网关的一次 MCP 轮次在回复前就失败:Stripping types is currently unsupported for files under node_modules,随后是“Embedded agent failed before reply: Claude Code started without the OpenClaw MCP server”。这是两条路径规则相撞的结果——#199706 把每个 Git release(一份带插件 TypeScript 源码的完整 worktree)放在 releases/<id>/lib/node_modules/openclaw,而 resolvePublicSurfacePath 在源码存在时会优先取 extensions/<plugin>/<file>.ts 而不是 dist(只有 Git release 带源码,npm 包只发 dist);插件加载器给 Jiti 的 nativeModules 里加的 "openclaw" 则会被 Jiti 2.7.0 展开成 node_modules/(openclaw)/ 并原生加载任何匹配项。改法是让 Git release 的构建与服务都发生在 node_modules 之外。

PR #201984(size: XL)补的是版本桥接。2026-11-19 当天发布了 beta 通道的 2026.11.10-beta.1 与 latest 通道的 2026.11.6,而 main 上还没有为这两个版本生成 update bridge 文件,pnpm update:compat:check 因此失败,从这两个版本升到 main 的下一个构建也不会带上其他近期版本都有的兼容桥。改动只是重新生成 scripts/lib/update-compat-inventory.json(+4225/-0,32 个既有条目逐字节不变),用户不需要做任何事。

PR #201538 修的是一个会让更新“假成功”的状态:Git checkout 安装在切换 release 链接之后、新网关启动新 release 之前失败时,下一次 openclaw update 会把那个从未启动过的 release 当成正在服务的那一个——目标相同时报告“已是最新”而网关仍跑旧构建;目标更新时则把它记为新试运行的兜底,导致启动失败的候选回退到一个从没跑过的构建,而且每次尝试还在磁盘上多留一份完整构建。

PR #201901 解决的是小内存机器上的源码构建:当前 main 的构建在 8 GiB 内存放不下,在一个没有其他负载的 8 GiB 容器里,冷 pnpm build 在声明步骤被 OOM kill,三次全部如此。内存被原生 TypeScript 编译器吃掉(#198661 把它并行化了),而构建的内存守卫看不见这部分,因为 --max-old-space-size 管不到 Go 子进程。PR #201914 则处理了从 2026.11.3 或更早版本升级时的另一个卡点:只要共享状态数据库里存在遗留的 sqlite_stat4 规划统计表(哪怕是空表),且更新跑在官方 Node.js 构建上,候选 Doctor 就会以 ScopedMigrationSnapshotUnsupportedError 拒绝,更新最终以 doctor-failed 结束。

上下文与历史读取:少解码一次就少一次

过去一天里有一批 PR 指向同一件事——同样一段数据被反复解码、反复投影、反复扫描。它们的共同特点是:不改变任何可见行为,只是把不必要的 CPU 与内存占用拿掉。

PR #201972(size: XL)是最显眼的一处:在一段已被压缩过的长会话里准备回复时,即使压缩已经把那些工具结果从模型视图里移除,仍然会先把全部旧工具结果解码一遍,直接拖慢模型派发。现在模型上下文读取器先借助既有的活跃位置、身份与依赖事实归属方确定一个安全的保留窗口,再执行未改动的原生导航 SQL;围栏、历史锚点、原生种子与全量读取、重置、缺失或过期事实、前缀后台来源与放置、提示重启,以及无法安全跳过的继承模型状态,仍保留完整读取器,token 预算与工具定义的字节完全不变。

PR #201983(size: L)处理受限 operator 角色读聊天历史:即使该角色的模型投影并没有改变任何消息,也会把整页解码再编码一遍。现在历史编码器在既有编码循环里记录策略敏感 assistant 行的有界字节区间,Gateway 校验内部索引后只投影这些行,直接借用未变化的字节区间;索引缺失或畸形时回退到原来的全量物化路径。线上的 JSON 与既有的披露行为保持不变。

PR #202061 处理常驻会话扫描:刷新聊天行、读取 transcript 回执时,可能在找到目标聊天之前就扫描了无关的常驻会话,而常驻会话集合越大,这部分开销越明显。现在复用副本归属方已有的 session-key 索引(含别名、淘汰与 LRU 顺序)做精确行读取和显式键的 transcript 回执,再套用既有的物理数据库与精确键检查,无键回执读取的行为不变。

PR #202063 带 security-sensitive-changed 标记,改的是构建会话列表的工作区权限时反复展开沙箱工具分组、编译策略 glob 的问题,而那一行其实只需要知道工作区是否被沙箱化。现在沙箱归属方暴露一个只返回布尔的行级分类,并由一个共享谓词保证与完整状态一致;回归在父提交上 20 行会触发 20 次策略读取,改动之后为 0,工作区权限与工具强制执行的结果没有任何变化。

PR #201929 针对自动化历史读取:过去要为每个保留的运行构造并校验一整份 schema 对象再挑页,在大历史上会为永远不进响应的行花 CPU 并分配临时对象,现在改为直接的线字段投影。PR #202015 针对技能归因:每次 read 工具的归因都要遍历选中的技能并重新推导宿主与路径别名,技能目录一大就会在完全无关的读取上消耗 CPU 和临时路径字符串,现在由快照发布、水合、资源重映射与 harness 交接共同准备一份 read-path 索引。PR #201950 减少重复提示估算:同一份大系统提示过去会被扫描两次,一次用于上下文组装、一次用于前台 token 预算,现在估算器在 context-engine 提示阶段就建立起来,两个阶段接得上。PR #201967 则让保存 subagent 进度时不再反复序列化那一行不可变的 registry 记录,改为复用已有的规范绑定,持久化字节与行为均不变。

渠道与客户端:回复、按钮与手机端手势

PR #202048(P1)修的是 ACP 客户端挂死:通过 openclaw acp 使用的客户端可以用 _meta: { deliver: true } 要求回复同时投递到会话的外部频道,但当会话有外部回复路由(例如主会话最近在某个消息频道上说过话)时,这个 prompt 不会向客户端流式输出任何文本,也不会结束。根因是 sendLivePayload 只向控制台可见的运行广播,deliver: true 的运行只投给 sessions.messages.subscribe 的订阅者,而 ACP 桥转发了 deliver: true 却从未订阅,因此既看不到回复也看不到最后一帧。现在 ACP 客户端能拿到流式回复与正常的 end_turn,频道仍只收到一次回复;不带 deliver: true 的 prompt、以及没有外部路由的会话上的 deliver: true prompt 行为不变。

PR #201764 补的是按钮回调值的归属。agent 用 message 工具发出的按钮(presentation 按钮里 action 为 callback 并带 value,或旧式 value)没有记录归属方,当没有插件认领这次点击时各渠道只能各自猜测:Slack 让 agent 收到的是“Slack interaction: {json…}”系统事件而不是值本身,Discord 的 registry 路径只给“Clicked "<label>"”,Teams 给的是原始卡片 JSON。这次把归属记录补齐,让按钮值在所有渠道都能回到 agent。

PR #201790(size: XL,security-sensitive-changed)修的是一个跨渠道的竞态:上一轮运行在输入准备与准入之间结束时,后续消息可能被拒绝——准备阶段保留了旧的生命周期,而第一次修复只在持久化后端刷新它,内存会话仍有同样的竞态。现在隐式生命周期状态在共享的 actor 事务里选定(两种后端都拥有其顺序),移除了三处准备期的生命周期副本与冗余的输入快照包装;显式调用方守卫、重启恢复、排队输入归属与已释放 actor 的拒绝依然严格。

PR #202065 是移动端手势:在 Android 上键盘打开时按返回键,会离开当前页面而不是收起键盘,在聊天里按返回会跳到 Overview 且键盘仍然盖在上面,写了一半的会话直接从视野里消失;现在返回键先关闭已打开的键盘,再按一次才照原样导航。a578b67 则补齐了 iOS 原生聊天的嵌套工具结果展示,让嵌套工具调用在原生会话里可见。

控制台模板中心与自动化告警

PR #202011 改变了模板页的打开方式:此前打开一个自动化只是把行上已经显示过的 cron 表达式重复一遍,并不告诉你这个自动化实际要做什么。现在该行以自然语言显示调度计划、时区,以及自动化是否默认启用,点击行上任意位置可在标准对话框里读到完整说明,行内模板预览使用同样的措辞;打开一行不会添加也不会运行该自动化。目录详情现在携带模板声明的消息,页面复用共享的调度格式化器与对话框,而不是维护第二套内联展开逻辑。

围绕模板目录还有一批界面调整:PR #202057 让聊天里的插件与技能安装卡片排布更紧凑,PR #202056 修好了悬停时 Publish Template 行变得难以阅读的问题,PR #202051 给模板页补上了指向使用指南的入口,c25f49d 为每个模板类别配上贴切且互不相同的图标,a4d58ef 让模板详情与侧边栏预览行改用插件的展示名与图标(优先取已安装清单,否则取精确版本的目录详情),并去掉了 ClawHub/版本与 bundled 标签,fce78db 则让 agent 可以直接从菜单里作为模板分享出去。

自动化这边有一处投递路由问题:PR #189953 指出,delivery.target 为 owner 的自动化(例如 Doctor 迁移过来的心跳)失败告警,原本会落到作业会话的最后一个会话(可能是另一个私聊发送者或群聊),而不是发给 owner。根因是失败告警路由沿用了作业的主投递,却丢掉了 target 与 directPolicy,于是被解析成普通的 channel: last 投递,而不是走作业自身投递所用的 owner 解析器。

PR #201928 则修了一个反直觉的超时:把 compaction.timeoutSeconds 设成 600 之后,自动压缩仍然会在 6 分钟时被当作停滞而中断——回复看门狗的语义截止时间是从最后进度加 6 分钟、且只统计打开的模型请求,嵌套压缩自己在 compaction-session-agent.ts 里设定的截止时间根本没有被计入。

其他值得留意的修复

  • a143442:openclaw logs 不再为空白行打印原始 JSON。
  • 72a92df:磁盘写满导致归档写入后,Doctor 的心跳迁移不再卡住。
  • 33f04ae:provider 目录发现失败时,models status 与 Doctor 保持静默,不再输出误导性信息。
  • 021000b:手动挑选上下文过小的模型时给出警告,自动设置流程里直接跳过这类选择。
  • fbacc80:doctor --fix 不再移除指向已不存在插件产物的 appServer.command。
  • 6b3c804:Auto Review 超时不再把已经拿到的审核&查验结果一起吞掉。

这一轮更新的基调是把边界做实:谁在什么时刻有权做决定,重启后由谁负责把人叫醒,以及插件必须由谁来加载。对使用者来说,更新更稳、会话更不容易睡死,权限判定也更可预期。

常用链接

 
内容管家

发表评论