openclaw-release-2026-W18-nvidia-provider

一、本周 Release 核心变更梳理
数据来源:openclaw/openclaw Releases
本周抓取日期:2026-05-01(对应 W18,2026 年第 18 周)
本周发布最新版本 v2026.4.29(2026 年 4 月 30 日),系正式版发布,以下内容基于该版本整理。
v2026.4.29(2026 年 4 月 30 日)
⚠️ Breaking Changes(破坏性变更,需重点关注)
1. tools.exec / tools.fs 配置不再隐式拓宽 restricted profiles(安全行为变更)
tools.exec 和 tools.fs 配置节在 messaging 和 minimal 等 restricted profiles 下,不再隐式拓宽权限边界。依赖此隐式行为的配置会在启动时收到警告提示,需要主动添加显式 alsoAllow 条目方可继续使用。影响范围覆盖 Issue #47487。
影响判断:如果你的 OpenClaw 运行在受限配置下(尤其
messagingprofile)且依赖 exec/fs 工具能力,请检查启动日志是否有警告,并参考 tools.exec 官方文档 添加显式权限。
2. Active Run 队列行为变更(默认启用 steer 模式)
消息队列默认行为由直接执行变更为 steer 模式(带 500ms followup fallback debounce),原有 one-at-a-time 模式降级为队列兜底策略。具体影响取决于你的消息场景,详见 Command Queue 官方文档。
✨ Other Notable Changes(其他重要变更)
1. NVIDIA Provider 正式加入——API-Key onboarding + 静态模型目录
OpenClaw 引入全新 NVIDIA Provider,支持 API-Key 直接接入和静态模型目录选型,NVIDIA 托管模型可直接通过 provider prefix 选取,无需额外 gateway 配置。参见 PR #71204。
2. Memory 升级为人员感知 Wiki——people wiki + provenance + 关系图谱
Active Memory 模块新增 agent-facing people wiki 元数据体系,支持人员别名规范化、人员卡片、关系图谱、隐私溯源报告、evidence-kind 下钻,以及人员检索、问题路由、来源证据、原始声明等多种搜索模式。结合新增的 per-conversation allowedChatIds / deniedChatIds 过滤器和超时部分召回机制,Memory 从简单向量存储演化为结构化知识网络。贡献者:@vincentkoc, @quengh, @joeykrug。
3. SQLite-backed Plugin State Store(重启安全键值存储)
新增 api.runtime.state.openKeyedStore 接口,提供基于 SQLite 的插件状态持久化存储,支持 TTL、LRU 淘汰和自动插件隔离,插件重启后状态安全保留,无需额外状态恢复逻辑。贡献者:@amknight。
4. spawnedBy 元数据——子 agent 事件路由无需额外查询
Gateway 事件 payload 新增 spawnedBy 字段,子 agent 聊天和 agent 广播事件均携带来源标识,客户端可直接路由,无需再执行一次 session 查找。参见 PR #63244。
5. Opt-in Follow-up Commitments(心跳驱动的主动承诺追踪)
新增可选的 inferred follow-up commitments 功能,支持 per-agent / per-channel 范围限定、心跳提醒投递、CLI 管理,以及 commitments.enabled / commitments.maxPerDay 配置项。参见 PR #74189。
6. 渠道稳定性修复集群
| 渠道 | 修复内容 |
|---|---|
| Slack | Block Kit 消息大小限制处理 |
| Telegram | 代理/webhook/polling/发送全链路韧性 |
| Discord | 启动时序优化 + rate-limit 退避处理 |
| 消息送达 + liveness 心跳 | |
| Teams / Matrix / Feishu | 边缘场景特殊字符处理 |
7. 模型相关修复
- Codex/OpenAI 兼容层:修复 OAuth bearer 注入路径,确保 PI OAuth token 正确传递至 ChatGPT/Codex Responses;同时清除 native Codex-only 不兼容字段,不影响自定义兼容端点。参见 PR #75111。
- gpt-5.4-mini / openai-codex:阻止显式配置的 stale inline entries 绕过 manifest capability block,避免 ChatGPT-backed Codex 账户切换模型后重复出现 assistant-turn 失败。参见 Issue #74451。
8. Gateway 可靠性增强
- systemd Supervision:EADDRINUSE 冲突以
sysexit 78退出码终结,避免 Restart=always 循环重载插件(#75115) - Browser/Gateway:
browser.executablePath、headless、noSandbox配置实时生效,不再回退至过时自动检测(#75087) - Gateway 启动:跳过无凭证
tools.web.fetch配置的 pre-bind provider discovery,Docker/Kubernetes 环境不再因此阻塞绑定(#74896) - Subagent 孤立恢复:wedged-session tombstone + 持久化恢复尝试,
task maintenance/doctor自动协调,无需手动 surgery sessions.json(#74864)
二、本机 OpenClaw 状态
| 项目 | 当前值 |
|---|---|
| 运行版本 | 2026.4.21 |
| 最新可用版本 | 2026.4.29 |
| 插件 (openclaw-qqbot) | v1.5.7 |
| Gateway 模式 | 本地回环(local loopback) |
| Channel | QQBot |
⚠️ 本机当前运行版本 2026.4.21,与最新版本 2026.4.29 相差 8 个版本,建议优先评估以下升级必要性。
三、升级必要性分析与操作步骤
🔴 推荐升级——理由如下
本机(v2026.4.21)升级至 v2026.4.29 的核心动力:
- NVIDIA Provider:如果你计划使用 NVIDIA 托管模型(Llama、Mistral 系列),新版本原生支持 NVIDIA API-Key onboarding,无需手动配置 gateway provider。
- 人员 Wiki Memory:如果你需要结构化管理人物关系和背景信息(如客户服务、多角色对话场景),新版 Memory 的 people wiki 功能大幅降低人工维护成本。
- systemd/port 冲突修复:Gateway 退出码修复对桌面环境意义不大,但如果你有 Docker 化部署计划,v2026.4.29 的 startup 修复直接解决 Docker 场景下的绑定卡顿问题。
- Codex gpt-5.4-mini 兼容性修复:如果你使用 ChatGPT-backed Codex 账户,升级后可避免 stale 模型配置导致的 assistant-turn 重复失败。
🟡 可选升级——建议观察
- Active Run steer 默认化:涉及队列行为,建议先在 staging 环境验证消息处理逻辑后再在生产环境升级。
tools.execrestricted profile 隐式拓宽移除:如果你的 messaging/minimal profile 配置依赖 exec/fs 工具,先检查openclaw doctor警告再升级。
⚡ 升级命令
# 1. 检查当前状态(显示当前版本、可用更新、配置问题)
openclaw doctor
# 2. 执行升级(自动下载并安装最新版本)
openclaw update run
# 3. 升级后再次诊断,确认配置完整性
openclaw doctor --fix # 自动修复已知配置问题(谨慎使用,先看 diff)⚠️ 风险提示
- 版本跨度较大(v2026.4.21 → v2026.4.29):建议避开生产高峰,择机在本地测试验证工作流正常运行后再推送。
- messaging / minimal profile 用户:升级后立即运行
openclaw doctor检查是否有tools.exec相关启动警告,如有需手动补充alsoAllow条目。 - Plugin 兼容性:
openclaw-qqbot v1.5.7需确认与 v2026.4.29 的 API 兼容性,升级后验证 QQ 消息收发正常。 - Stashed sessions:v2026.4.29 的 subagent orphan recovery 变更可能影响处于 wedged 状态的 session,升级后关注
sessions.json是否有自动清理日志。
本文由 OpenClaw Release Tracker 自动生成,每周五定时更新。