OpenClaw v2026.4.19-beta.2发布:修复本地模型用量统计+嵌套会话隔离+旧版升级兼容

🔍 OpenClaw v2026.4.19-beta.2 Release 版本分析报告

📅 发布时间：2026-04-19 | 📦 版本：v2026.4.19-beta.2 | 🧪 类型：Beta预发布 | ✍️ 发布人：steipete (Peter Steinberger) | 🔐 提交：dc3df91 (SSH签名验证)

📋 版本概览

本版本为聚焦用量统计与会话隔离的Beta热修复，核心聚焦于：

✅ OpenAI兼容后端流式用量上报修复，解决本地模型用量显示为0%问题
✅ 嵌套Agent会话作用域隔离，避免长任务阻塞网关其他会话
✅ 状态命令用量数据持久化，兼容省略usage元数据的提供商
✅ 旧版安装升级路径兼容修复，保障从全局安装平滑迁移至Beta

⚠️ 适用场景：测试环境/灰度验证，生产环境建议等待正式稳定版

🔧 核心修复汇总

📊 用量统计与监控增强

修复项	问题描述	技术方案	PR
流式请求用量上报	本地/自定义OpenAI兼容后端（llama.cpp/vLLM等）在流式请求中用量始终显示0%	强制在`openai-completions`提供商的流式请求中注入`stream_options.include_usage: true`，确保后端返回真实token用量 [[11]]	#68746
状态命令数据持久化	部分提供商省略usage元数据时，`/status`和`openclaw sessions`用量回退至未知/0%	会话状态携带转发上一轮已知token总量，用量显示连续性提升	#67695
修复效果	✅ 本地模型用量可视化可信 ✅ 配额监控/自动压缩触发精准 ✅ 多提供商用量统计一致性	-	-

🔄 会话隔离与并发优化

修复项	问题描述	影响范围	PR
嵌套Agent作用域隔离	长运行嵌套任务在单一会话执行时，通过网关队列头阻塞机制影响其他无关会话	多用户/企业工作空间/高并发场景	#67785
技术方案	嵌套Agent工作按`target session`作用域隔离，队列调度独立于主会话lane [[24]]	-
修复效果	✅ 会话间无相互阻塞 ✅ 网关吞吐量提升 ✅ 多租户场景稳定性增强	-

📦 安装/升级兼容性

修复项	问题现象	根因分析	修复方案
旧版升级验证兼容	从旧全局安装（npm全局包）升级到Beta版本时，更新验证失败但npm安装成功	QA Lab runtime shim与新版验证逻辑不兼容	保持legacy update verification路径兼容，显式支持shim环境检测

📦 依赖/架构变化

无新增第三方依赖
：本版本聚焦逻辑修复，未引入外部库变更
OpenAI兼容层协议增强
：openai-completions提供商默认启用stream_options注入，符合OpenAI API最新规范 [[14]]
会话状态机优化
：AgentStatus模块增加carriedForwardUsage字段，支持用量数据跨请求持久化

⚠️ 兼容性提示（Beta版本特别注意）

类型	内容	建议
🔬 测试范围	本版本为Beta.2预发布，修复可能随正式版微调	仅限测试/灰度环境，避免直接部署生产
🔄 用量统计	启用`include_usage`后，部分旧版兼容后端可能返回额外字段	验证自定义后端日志，确认无解析异常
🧩 嵌套会话	作用域隔离变更后，跨会话共享上下文需显式配置`session.share`	检查多Agent协作场景的上下文传递逻辑
📦 升级路径	旧全局安装用户升级时，建议先执行`openclaw doctor --check install`	提前验证环境兼容性，避免升级中断

🔄 升级指南（测试环境）

# 1. 确认环境：仅限测试/灰度部署echo"⚠️ Beta.2版本，请勿直接用于生产"
# 2. 备份配置与会话状态cp-r ~/.openclaw ~/.openclaw.backup.$(date +%Y%m%d-%H%M)
# 3. 下载Beta.2版本（显式指定tag）# macOScurl-LO https://github.com/openclaw/openclaw/releases/download/v2026.4.19-beta.2/OpenClaw-2026.4.19-beta.2.dmg# Linux/通用curl-LO https://github.com/openclaw/openclaw/releases/download/v2026.4.19-beta.2/OpenClaw-2026.4.19-beta.2.zip
# 4. 校验完整性（以发布页SHA256为准）# macOS示例：echo"cf320baf60da2d9d2cb4dbb62f88299e6e135ae6e2edb5d8e6d79df5b6b75f2b  OpenClaw-2026.4.19-beta.2.dmg"| shasum -a256-c
# 5. 执行升级（需--allow-prerelease标记）openclaw update --to v2026.4.19-beta.2 --allow-prerelease
# 6. 验证关键修复# - 用量统计：执行流式请求后检查 /status 用量是否非0# - 会话隔离：并行触发多会话任务，验证无相互阻塞# - 升级兼容：旧安装用户验证更新后配置完整性

💡 验证清单：
本地Ollama/vLLM后端流式请求后，openclaw status用量显示是否准确
多会话并行执行长任务时，网关响应延迟是否无明显波动
旧全局安装升级后，openclaw --version与配置加载是否正常
自定义OpenAI兼容后端日志中是否包含stream_options字段

🔗 参考链接

📄 完整Release Notes^[1]
📡 PR #68746: stream_options注入修复^[2]
🧵 PR #67785: 嵌套会话作用域隔离^[3]
📊 OpenAI流式用量API文档^[4] [[14]]
🧪 Beta版本反馈通道^[5]

引用链接

[1] 完整Release Notes: https://github.com/openclaw/openclaw/releases/tag/v2026.4.19-beta.2

[2] PR #68746: stream_options注入修复: https://github.com/openclaw/openclaw/pull/68746

[3] PR #67785: 嵌套会话作用域隔离: https://github.com/openclaw/openclaw/pull/67785

[4] OpenAI流式用量API文档: https://community.openai.com/t/usage-stats-streaming/738156

[5] Beta版本反馈通道: https://github.com/openclaw/openclaw/discussions/categories/beta-feedback