一、版本更新概览

openclaw于2026年3月25日正式发布v2026.3.24版本，本次更新聚焦OpenAI生态兼容、智能体工具能力、多平台交互体验、技能安装与管理、CLI与容器支持、UI界面优化、运行时兼容性等核心方向，同时修复了大量安全、稳定性与多平台适配问题，全面提升了AI智能体网关的可用性、兼容性与安全性。

二、Breaking Changes（重大变更）

1. Gateway/OpenAI兼容性升级

• 新增/v1/models与/v1/embeddings接口，实现与OpenAI生态的基础接口对齐
• 在/v1/chat/completions与/v1/responses接口中，支持显式模型覆盖转发，大幅提升客户端与RAG系统的兼容性

2. Agents/tools能力重构

• /tools接口仅返回当前智能体可立即使用的工具，精准匹配智能体可用能力
• 新增紧凑默认视图，同时提供可选的详细模式，兼顾简洁性与信息完整性
• Control UI新增实时“Available Right Now”（当前可用）区域，让用户在发起请求前清晰知晓可用工具，提升交互效率

3. Microsoft Teams深度集成优化

• 迁移至官方Teams SDK，遵循AI-agent用户体验最佳实践
• 支持1:1流式回复、带提示词启动器的欢迎卡片、反馈与反思功能、信息状态更新、输入指示器、原生AI标签
• 新增消息编辑与删除支持，无明确目标时提供线程内回退机制，适配Teams消息交互逻辑

4. Skills/install元数据增强

• 为捆绑技能（coding-agent、gh-issues、openai-whisper-api、session-logs、tmux、trello、weather）添加一键安装配置
• CLI与Control UI可在依赖缺失时自动提示并完成依赖安装，简化技能部署流程

5. Control UI/skills管理升级

• 新增状态筛选标签（全部/就绪/需设置/已禁用），并显示各状态技能数量
• 替换内联技能卡片为点击详情对话框，展示技能依赖、开关、安装操作、API密钥输入、源元数据与主页链接，实现一站式技能管理

6. Slack交互回复优化

• 恢复直接交付的富文本回复一致性，确保交互体验统一
• 自动将简单的末尾Options:行渲染为按钮/选择框，提升交互便捷性
• 优化Slack交互设置默认值，将回复控件与插件交互处理程序隔离，避免功能冲突

7. CLI/containers容器支持

• 新增--container参数与OPENCLAW_CONTAINER环境变量，支持在运行中的Docker或Podman OpenClaw容器内执行openclaw命令，适配容器化部署场景

8. Discord/auto threads自动线程命名

• 新增可选autoThreadName: "generated"命名模式，新自动创建的线程可通过LLM异步生成简洁标题
• 保留原有基于消息的命名作为默认，兼顾兼容性与个性化需求

9. Plugins/hooks插件钩子增强

• 新增before_dispatch钩子，提供规范的入站元数据
• 路由处理后的回复通过标准最终交付路径，保留TTS与路由交付语义，确保功能一致性

10. Control UI/agents界面重构

• 智能体工作区文件行转换为可展开的<details>组件，支持懒加载内联Markdown预览
• 新增全面的.sidebar-markdown样式，适配标题、列表、代码块、表格、块引用、details/summary等元素，优化文档预览体验

11. Control UI/markdown预览优化

• 重新设计智能体工作区文件预览对话框，采用磨砂背景、适配尺寸面板与样式化标题
• 集成@create-markdown/preview v2系统主题，支持富Markdown渲染（标题、表格、代码块、标注、块引用），并自动适配应用明暗设计令牌

12. macOS app/config导航重构

• 替换水平药丸式子部分导航为可折叠树形侧边栏，使用展开箭头与缩进子行，提升配置界面的层级清晰度与操作便捷性

13. CLI/skills提示优化

• 将缺失依赖标签从“missing”优化为“needs setup”，表述更友好
• 在openclaw skills info输出中，补充API密钥设置指南（密钥获取途径、CLI保存命令、存储路径），降低用户配置门槛

14. macOS app/skills配置增强

• API密钥编辑器对话框新增“Get your key”主页链接与存储路径提示
• 保存确认消息中显示配置路径，方便用户定位配置文件

15. Control UI/agents选择器优化

• 默认智能体模型选择器下拉框新增“Not set”占位符，明确未选择状态

16. Runtime/install运行时兼容性调整

• 将Node 22支持最低版本降至22.14+，同时推荐使用Node 24
• 避免npm安装与自动更新导致Node 22.14用户停留在旧版本，提升兼容性

17. CLI/update更新前置检查

• 在openclaw update执行全局包安装前，预检查目标npm包的engines.node要求
• 过时Node运行时会触发清晰的升级提示，而非尝试安装不支持的最新版本，减少更新失败问题

三、Fixes（问题修复）

1. 媒体文件与安全相关修复

• 出站媒体/本地文件：使出站媒体访问与配置的文件系统策略对齐，关闭workspaceOnly时，主机本地文件与入站媒体路径可正常发送；严格工作区隔离的智能体保持沙箱化
• 安全/沙箱媒体分发：关闭mediaUrl/fileUrl别名绕过漏洞，防止出站工具与消息操作突破媒体根目录限制
• 嵌入式运行/密钥：未解析的SecretRef配置不再导致嵌入式智能体运行崩溃，必要时回退到已解析的运行时快照

2. 网关与多平台稳定性修复

• 网关/重启哨兵：重启后通过心跳唤醒中断的智能体会话，而非仅发送尽力而为的重启通知；临时失败时重试出站交付一次；保留显式线程/主题路由，确保回复送达正确的Telegram主题或Slack线程
• Docker/安装：通过openclaw-gateway路由安装时的配置写入，避免预启动openclaw-cli共享网络命名空间循环，解决全新Docker安装在网关启动前失败的问题
• 网关/通道：保持通道启动顺序，同时隔离各通道启动失败，单个故障通道不再阻塞后续通道启动
• Discord/网关监控：将网关错误处理集中到生命周期管理的监控器中，统一分类早期、活跃、后期拆除阶段的Carbon网关错误，避免进程崩溃
• Discord/超时：入站Discord工作线程在最终回复开始前超时，发送可见的超时回复，包含创建的自动线程目标与排队运行顺序

3. 即时通讯平台适配修复

• WhatsApp/群组：跟踪网关最近发送的消息ID，仅抑制匹配的群组回声，保留所有者的/status、/new、/activation命令
• WhatsApp/回复检测：通过解包botInvokeMessage负载并从creds.json读取selfLid，恢复群组隐式回复检测，确保基于回复的提及能触达机器人
• Telegram/论坛主题：当Telegram省略论坛元数据时，恢复#General主题1路由，支持原生命令、交互回调、入站消息上下文与回退错误回复
• Telegram/出站错误：保留可操作的403成员/阻止/踢出详情，将机器人非成员视为永久交付失败，停止重试无效聊天
• Telegram/照片：预检查Telegram照片尺寸与宽高比规则，图像元数据无效或不可用时回退为文档发送，解决PHOTO_INVALID_DIMENSIONS上传失败问题
• Slack/运行时默认值：减少Slack私信回复开销，恢复Codex自动传输；收紧Slack/网页搜索运行时默认值，优化私信预览线程、缓存范围、警告去重与显式网页搜索选择加入
• ACP/直接聊天：最终TTS未生成音频时，始终交付终端ACP结果，即使块文本已提前流式传输；跳过冗余的空文本最终合成

四、总结

代码地址：bgithub.xyz/openclaw/openclaw

openclaw v2026.3.24版本是一次兼顾兼容性、易用性、安全性与稳定性的全面升级。在OpenAI生态适配、智能体工具管理、多平台交互优化上实现重大突破，同时通过CLI与容器支持、UI界面重构、运行时兼容性调整，大幅降低了部署与使用门槛；问题修复则聚焦媒体安全、网关稳定性、多平台适配等核心痛点，为企业级与个人用户提供了更可靠、更高效的AI智能体网关服务。