OpenClaw v2026.5.12 正式发布:权限管控更精细,扩展能力再升级

大家好！OpenClaw刚刚推送了v2026.5.12版本更新，本次更新带来了多项核心能力升级、体验优化和问题修复，覆盖权限管控、子代理调度、插件开发、多平台适配等多个场景，下面为大家梳理重点更新内容：

✨ 核心亮点（Highlights）

1. 1. 按发送者的工具权限管控：新增了基于发送者身份的工具权限策略，管理员可以全局、按Agent、按群组等不同维度限制危险工具的使用范围，大幅提升多用户/多Agent场景下的安全性
2. 2. 子代理会话血缘元数据开放：ACP会话列表和快照现在会暴露完整的会话血缘关系，客户端可以直接渲染子代理调用关系图，无需对接网关私有接口
3. 3. 上下文可视化命令：新增/context map命令，可以直接生成当前会话上下文贡献者的树状图，直观了解上下文构成
4. 4. 私有技能上传安装支持：新增私有技能压缩包上传安装路径，管理员开启配置后，可信客户端可以直接安装zip格式的私有技能
5. 5. 插件SDK新增媒体理解能力：新增结构化提取接口，可信插件可以直接调用模型完成图片等媒体内容的结构化信息提取，无需自行对接模型API
6. 6. Cron任务查询能力增强：新增cron.get接口和openclaw cron get命令，支持直接按ID查询单个定时任务的配置信息

🔧 功能变更（Changes）

模型适配优化

• • OpenAI接口现在会透传客户端传入的max_completion_tokens和max_tokens参数，优先使用max_completion_tokens
• • 自动兼容已退役的Gemini 3 Pro Preview模型ID，自动映射到google/gemini-3.1-pro-preview，无需手动修改配置
• • OpenAI CLI认证默认走ChatGPT/Codex账号登录流程，API密钥方式保留为显式选项

多平台适配升级

• • Slack平台新增链接/媒体预览开关、线程回复广播支持、@元数据保留、DM线程合并等多项优化
• • Discord语音功能新增实时诊断、允许频道限制、默认使用纯JS解码器避免原生编译耗时，可选高性能原生解码器
• • iMessage通道新增状态查询过滤功能，支持直接探测iMessage状态无需同时启动两个通道监控
• • 自动识别Fly Machines容器环境，自动适配网关绑定和Bonjour默认配置

开发体验优化

• • 包管理工具升级到pnpm 11，所有构建、安装、发布流程统一适配pnpm 11配置
• • TypeScript编译器开启更严格的检查规则，oxlint、Vitest新增更多代码质量检查规则
• • 系统提示词默认精简，减少不必要的token消耗
• • 命令行引导流程优化，设置、配置、通道相关命令会提示下一步可执行的操作

插件SDK优化

• • 废弃无使用量的公开子路径，减少SDK暴露面
• • 新增会话操作分组命名空间，统一管理会话动作、附件发送、定时任务清理等能力
• • 向插件工具工厂暴露当前使用的模型元数据，方便插件做自定义策略控制

其他变更

• • 子代理交互最大轮次上限提升到20（默认仍为5），支持更长的Agent协作链路
• • 文档导航调整，原工具导航更名为”能力”，结构更清晰
• • 升级所有核心依赖到最新稳定版，包括Anthropic SDK、Playwright、Google GenAI、OpenAI SDK等

🐛 问题修复（Fixes）

1. 1. 修复控制UI空白页问题，当应用模块注册失败时会显示HTML恢复面板，提供重试路径和故障排查指引
2. 2. 修复子代理后台会话引用丢失问题，会话压缩后仍能正确保留后台执行/进程会话的引用
3. 3. 修复Slack DM线程拆分问题，同一会话的消息不会被拆分成多个线程
4. 4. 修复Codex应用服务器客户端超时复用问题，超时后不会再复用占用CPU的旧进程
5. 5. 优化Discord命令预览展示，宽度提升50%，可以展示更多命令上下文信息

📥 升级指引

本次版本为可选升级，使用官方安装脚本的用户可以直接执行openclaw update完成升级，Docker部署用户可以拉取最新镜像重启即可。如果在升级使用过程中遇到任何问题，欢迎在GitHub仓库提交Issue反馈~