发布日期: 2026-03-25
当前版本: 2026.3.23-1 → 最新版本: 2026.3.24
更新优先级: 🟡 中等(功能增强 + 稳定性修复)
📋 更新摘要
本次更新以功能增强和稳定性修复为主,重点改进了:
-
• OpenAI API 兼容性(RAG 应用友好) -
• 工具可见性和管理体验 -
• Microsoft Teams 集成重大升级 -
• 技能安装流程优化 -
• 多渠道稳定性修复
✨ 新增功能
1. OpenAI 兼容性增强 🔄
变更内容:
-
• 新增 /v1/models端点 -
• 新增 /v1/embeddings端点 -
• 支持通过 /v1/chat/completions和/v1/responses转发显式模型覆盖
影响:
-
• 更广泛的客户端兼容性 -
• RAG(检索增强生成)应用更容易集成 -
• 使用标准 OpenAI SDK 的第三方工具可直接对接
2. 工具可见性改进 🛠️
变更内容:
-
• /tools命令现在显示当前 Agent 实际可用的工具 -
• 新增紧凑默认视图 + 可选详细模式 -
• Control UI 新增"Available Right Now"实时区域
影响:
-
• 更容易在提问前确认哪些工具可用 -
• 减少"这个工具为什么不能用"的困惑 -
• 调试和开发体验提升
3. Microsoft Teams 重大升级 💼
变更内容:
-
• 迁移到官方 Teams SDK -
• 新增 AI 代理 UX 最佳实践: -
• 流式 1:1 回复 -
• 欢迎卡片 + 提示引导 -
• 反馈/反思机制 -
• 信息性状态更新 -
• 打字指示器 -
• 原生 AI 标识 -
• 支持消息编辑和删除(包括线程内回退)
影响:
-
• Teams 用户体验大幅提升 -
• 企业部署更友好 -
• 符合微软 AI 代理设计规范
4. 技能安装体验优化 📦
变更内容:
-
• 7 个核心技能添加一键安装配置: -
• coding-agent -
• gh-issues -
• openai-whisper-api -
• session-logs -
• tmux -
• trello -
• weather -
• Control UI 新增技能状态筛选标签: -
• All / Ready / Needs Setup / Disabled -
• 显示各状态数量 -
• 技能详情页新增: -
• 需求说明 -
• 开关切换 -
• 安装操作 -
• API Key 输入 -
• 源元数据 -
• 主页链接 -
• CLI openclaw skills info输出增强: -
• API Key 获取指引 -
• 配置保存命令 -
• 存储路径提示
影响:
-
• 技能安装门槛降低 -
• 新手更容易上手 -
• 配置问题更容易排查
5. Control UI markdown 预览增强 📝
变更内容:
-
• Agent 工作区文件预览对话框重构 -
• 集成 @create-markdown/previewv2 系统主题 -
• 支持丰富 Markdown 渲染: -
• 标题 -
• 表格 -
• 代码块 -
• 引用块 -
• 列表 -
• 自动适配明/暗色设计令牌
影响:
-
• 文档阅读体验提升 -
• 技能文档、PRD、笔记等更易读
6. CLI 容器支持 🐳
变更内容:
-
• 新增 --container参数 -
• 新增 OPENCLAW_CONTAINER环境变量 -
• 支持在运行中的 Docker/Podman OpenClaw 容器内执行命令
影响:
-
• 容器化部署管理更方便 -
• 无需进入容器即可执行命令
7. Discord 自动线程命名 🧵
变更内容:
-
• 新增可选 autoThreadName: "generated"配置 -
• 支持 LLM 自动生成简洁线程标题 -
• 默认仍使用基于消息的命名
影响:
-
• 线程管理更清晰 -
• 适合长期讨论的上下文
8. Node 22 兼容性放宽 🔧
变更内容:
-
• 最低 Node 22 版本要求降至 22.14+ -
• 仍推荐 Node 24 -
• CLI 更新前会预检 npm 包的 engines.node
影响:
-
• Node 22.14 用户不会被阻挡在旧版本 -
• 更新失败时提示更清晰
🐛 重要修复
安全修复
-
• 沙箱媒体访问修复:关闭 mediaUrl/fileUrl别名绕过,防止越权访问 (#54034)
渠道修复
-
• Telegram: -
• 论坛主题路由修复(#53699) -
• 照片尺寸验证 + 回退文档发送(#52545) -
• 出站错误详情保留(#53635) -
• WhatsApp: -
• 群组消息回声抑制(#53624) -
• 机器人回复检测修复 -
• Discord: -
• 超时回复机制改进(#53823) -
• 网关错误处理集中化 -
• Feishu: -
• WebSocket 连接关闭修复(#52844) -
• 入站时间戳修复(#52809) -
• Slack: -
• 运行时默认值优化(#53957) -
• 交互式回复恢复
Agent 修复
-
• 嵌入式运行失败时显示 429/过载错误(#50930) -
• 上下文压缩超时恢复机制(#46417) -
• SecretRef 配置崩溃修复(#45838) -
• 工具沙箱全局匹配修复(#54492, #54684)
其他修复
-
• 网关重启后唤醒中断的 agent 会话(#53940) -
• Docker 安装初始化循环修复(#53385) -
• 渠道启动失败隔离(#54215) -
• 出站媒体文件访问策略对齐
📊 更新建议
推荐更新人群
-
• ✅ 使用 Microsoft Teams 的企业用户 -
• ✅ 使用 RAG 应用 的开发者 -
• ✅ 遇到 Telegram/WhatsApp/Discord 稳定性的用户 -
• ✅ 想体验 技能安装优化 的新手
可暂缓更新人群
-
• ⏸️ 当前版本稳定,无上述需求 -
• ⏸️ 生产环境建议观察 1-2 天
🚀 更新方法
# 方法 1:CLI 更新(推荐)
openclaw update
# 方法 2:npm 全局更新
npm install -g openclaw
# 方法 3:Docker 更新(如使用容器部署)
docker pull openclaw/openclaw:latest
docker compose restart
更新后验证:
openclaw --version
# 应显示:OpenClaw 2026.3.24
📝 备注
-
• 本次更新无破坏性变更 -
• 配置向后兼容 -
• 更新后建议重启网关: openclaw gateway restart


