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