![]()
![]()
![]()
一、版本更新概览
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系统的兼容性
•
/tools接口仅返回当前智能体可立即使用的工具,精准匹配智能体可用能力• 新增紧凑默认视图,同时提供可选的详细模式,兼顾简洁性与信息完整性
• Control UI新增实时“Available Right Now”(当前可用)区域,让用户在发起请求前清晰知晓可用工具,提升交互效率
• 迁移至官方Teams SDK,遵循AI-agent用户体验最佳实践
• 支持1:1流式回复、带提示词启动器的欢迎卡片、反馈与反思功能、信息状态更新、输入指示器、原生AI标签
• 新增消息编辑与删除支持,无明确目标时提供线程内回退机制,适配Teams消息交互逻辑
• 为捆绑技能(coding-agent、gh-issues、openai-whisper-api、session-logs、tmux、trello、weather)添加一键安装配置
• CLI与Control UI可在依赖缺失时自动提示并完成依赖安装,简化技能部署流程
• 新增状态筛选标签(全部/就绪/需设置/已禁用),并显示各状态技能数量
• 替换内联技能卡片为点击详情对话框,展示技能依赖、开关、安装操作、API密钥输入、源元数据与主页链接,实现一站式技能管理
• 恢复直接交付的富文本回复一致性,确保交互体验统一
• 自动将简单的末尾Options:行渲染为按钮/选择框,提升交互便捷性
• 优化Slack交互设置默认值,将回复控件与插件交互处理程序隔离,避免功能冲突
• 新增
--container参数与OPENCLAW_CONTAINER环境变量,支持在运行中的Docker或Podman OpenClaw容器内执行openclaw命令,适配容器化部署场景
• 新增可选
autoThreadName: "generated"命名模式,新自动创建的线程可通过LLM异步生成简洁标题• 保留原有基于消息的命名作为默认,兼顾兼容性与个性化需求
• 新增
before_dispatch钩子,提供规范的入站元数据• 路由处理后的回复通过标准最终交付路径,保留TTS与路由交付语义,确保功能一致性
• 智能体工作区文件行转换为可展开的
组件,支持懒加载内联Markdown预览
• 新增全面的
.sidebar-markdown样式,适配标题、列表、代码块、表格、块引用、details/summary等元素,优化文档预览体验
• 重新设计智能体工作区文件预览对话框,采用磨砂背景、适配尺寸面板与样式化标题
• 集成
@create-markdown/preview v2系统主题,支持富Markdown渲染(标题、表格、代码块、标注、块引用),并自动适配应用明暗设计令牌
• 替换水平药丸式子部分导航为可折叠树形侧边栏,使用展开箭头与缩进子行,提升配置界面的层级清晰度与操作便捷性
• 将缺失依赖标签从“missing”优化为“needs setup”,表述更友好
• 在
openclaw skills info输出中,补充API密钥设置指南(密钥获取途径、CLI保存命令、存储路径),降低用户配置门槛
• API密钥编辑器对话框新增“Get your key”主页链接与存储路径提示
• 保存确认消息中显示配置路径,方便用户定位配置文件
• 默认智能体模型选择器下拉框新增“Not set”占位符,明确未选择状态
• 将Node 22支持最低版本降至22.14+,同时推荐使用Node 24
• 避免npm安装与自动更新导致Node 22.14用户停留在旧版本,提升兼容性
• 在
openclaw update执行全局包安装前,预检查目标npm包的engines.node要求• 过时Node运行时会触发清晰的升级提示,而非尝试安装不支持的最新版本,减少更新失败问题
• 出站媒体/本地文件:使出站媒体访问与配置的文件系统策略对齐,关闭
workspaceOnly时,主机本地文件与入站媒体路径可正常发送;严格工作区隔离的智能体保持沙箱化• 安全/沙箱媒体分发:关闭
mediaUrl/fileUrl别名绕过漏洞,防止出站工具与消息操作突破媒体根目录限制• 嵌入式运行/密钥:未解析的
SecretRef配置不再导致嵌入式智能体运行崩溃,必要时回退到已解析的运行时快照
• 网关/重启哨兵:重启后通过心跳唤醒中断的智能体会话,而非仅发送尽力而为的重启通知;临时失败时重试出站交付一次;保留显式线程/主题路由,确保回复送达正确的Telegram主题或Slack线程
• Docker/安装:通过openclaw-gateway路由安装时的配置写入,避免预启动openclaw-cli共享网络命名空间循环,解决全新Docker安装在网关启动前失败的问题
• 网关/通道:保持通道启动顺序,同时隔离各通道启动失败,单个故障通道不再阻塞后续通道启动
• Discord/网关监控:将网关错误处理集中到生命周期管理的监控器中,统一分类早期、活跃、后期拆除阶段的Carbon网关错误,避免进程崩溃
• Discord/超时:入站Discord工作线程在最终回复开始前超时,发送可见的超时回复,包含创建的自动线程目标与排队运行顺序
• WhatsApp/群组:跟踪网关最近发送的消息ID,仅抑制匹配的群组回声,保留所有者的/status、/new、/activation命令
• WhatsApp/回复检测:通过解包
botInvokeMessage负载并从creds.json读取selfLid,恢复群组隐式回复检测,确保基于回复的提及能触达机器人• Telegram/论坛主题:当Telegram省略论坛元数据时,恢复,支持原生命令、交互回调、入站消息上下文与回退错误回复
• 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智能体网关服务。
我们相信人工智能为普通人提供了一种“增强工具”,并致力于分享全方位的AI知识。在这里,您可以找到最新的AI科普文章、工具评测、提升效率的秘籍以及行业洞察。 欢迎关注“福大大架构师每日一题”,发消息可获得面试资料,让AI助力您的未来发展。
特别声明:以上内容(如有图片或视频亦包括在内)为自媒体平台“网易号”用户上传并发布,本平台仅提供信息存储服务。
Notice: The content above (including the pictures and videos if any) is uploaded and posted by a user of NetEase Hao, which is a social media platform and only provides information storage services.