夜雨聆风
一、版本更新概览
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智能体网关服务。
我们相信人工智能为普通人提供了一种“增强工具”，并致力于分享全方位的AI知识。在这里，您可以找到最新的AI科普文章、工具评测、提升效率的秘籍以及行业洞察。
欢迎关注“福大大架构师每日一题”，发消息可获得面试资料，让AI助力您的未来发展。
