OpenClaw 2026.4.21 版本更新日志

OpenClaw 2026.4.21 版本带来了多项重要更新，包括图像生成增强、安全修复、模型支持改进以及多个平台的bug修复。以下是详细的更新内容。

主要更新

图像生成

• 默认图像模型：将捆绑的图像生成提供者和实时媒体测试默认设置为 gpt-image-2
• 新分辨率支持：在图像生成文档和工具元数据中提供 2K/4K 分辨率提示

错误修复

插件系统

• 医生插件修复：修复了捆绑插件的运行时依赖项，使打包安装可以在不安装广泛核心依赖项的情况下恢复缺失的频道/提供者依赖项
• 图像生成日志：在自动提供者回退之前记录失败的提供者/模型候选，使 OpenAI 图像失败在网关日志中可见，即使后续提供者成功

认证和命令

• 所有者验证加强：要求所有者身份（所有者候选人匹配或内部 operator.admin）才能执行所有者强制命令，而不是将通配符频道 allowFrom 或空所有者候选人列表视为足够 (#69774)。这修复了非所有者发送者通过宽松回退访问所有者唯一命令的安全问题

平台特定修复

• Slack 修复：在运行时出站发送中保留线程别名，使通用运行时发送在调用者提供 threadTs 时保持在预期的 Slack 线程中 (#62947)
• 浏览器修复：立即拒绝无效的 ax<N> 辅助功能引用，而不是等待浏览器操作超时 (#69924)
• npm 安装修复：将 node-domexception 别名镜像到根 package.json 的 overrides，停止显示从 Pi/Google 运行时依赖项拉取的已弃用 google-auth-library -> gaxios -> node-fetch -> fetch-blob -> node-domexception 链

模型和 API

• 思考模式优化：仅对明确支持提供商最大推理的模型公开 max，并在用户切换到另一个模型时将存储的 max 设置重新映射到支持的最大的思考模式
• OpenAI Responses：/think 级别针对每个 GPT 模型支持的推理工作，因此 /think off 不再变成高推理或发送不支持的 reasoning.effort: "none" 载荷
• Kimi 默认值：将捆绑的 Kimi 思考默认关闭，并规范化 Anthropic 兼容的 thinking 载荷

会话管理

• 会话维护：默认执行内置条目上限和年龄修剪，并在加载时修剪过度大小的存储，防止累积的 cron/executor 会话后台导致网关在写入路径运行前 OOM
• 自动回复：按会话类型应用静默 NO_REPLY 策略
• 会话重置：在 /new 和 /reset 时清除自动源模型、提供者和 auth-profile 覆盖，同时保留明确的用户选择

安全修复

• Env 注入阻止：阻止所有 OPENCLAW_* 密钥来自不受信任的 workspace .env 文件
• Gateway 工具配置保护：扩展 agent-facing gateway 工具的配置变更保护，使模型驱动的 config.patch 和 config.apply 无法重写操作员信任的路径
• 配对设备限制：将非管理员配对设备会话（设备令牌认证）限制在其自己的配对列表、批准和拒绝操作

定时任务 (Cron)

• 执行状态分离：将运行时执行状态拆分为 jobs-state.json，使 jobs.json 保持稳定以便 git 跟踪
• 交付模式：将显式 delivery.mode: "none" 运行视为未请求
• Telegram 去重：将隔离的直接交付去重键设为每次 cron 执行而非重用的会话 ID

集成修复

• Mattermost：将思考、工具活动和部分回复文本流式传输到单个草稿预览帖子
• BlueBubbles：将出站 HTTP 合并到类型化 BlueBubblesClient
• Matrix 命令：识别以机器人 Matrix 提及为前缀的斜杠命令

其他改进

• 向导师/向导：重新设计设置安全免责声明，添加加载微调
• 模型成本：支持来自缓存目录和配置模型的分层模型定价
• 终端日志：通过单个正则表达式传递优化 sanitizeForLog()
• QCI/QA：使 openclaw qa suite 和 openclaw qa telegram 在场景失败时默认失败

升级建议

建议所有用户升级到 2026.4.21 版本，以获得最新的功能改进和安全修复。

升级命令：

npm update -g openclaw
# 或
openclaw update

相关资源

• OpenClaw 官网
• OpenClaw GitHub
• OpenClaw 文档
• OpenClaw Discord 社区

总结

2026.4.21 版本是一个重要的维护版本，主要聚焦于错误修复、安全增强和多个平台的兼容性改进。这次更新修复了多个长期存在的问题，并提升了整体稳定性和安全性。

本文基于 OpenClaw 官方更新日志编写。