2026 年 3 月 25 日,OpenClaw 发布 v2026.3.24。这是继安全加固版 v2026.3.22 两天后的快速跟进版本,无破坏性变更,完全聚焦于功能扩展和用户体验优化。本次更新的两大核心亮点——Microsoft Teams 深度重构7 个内置技能一键安装——让 OpenClaw 的企业级适用性和新手友好度均得到显著提升。更多资讯请访问 OpenClaw 中文版官网

一、Microsoft Teams:从”勉强可用”到”真正好用”

OpenClaw 对 Teams 的集成长期以来被社区戏称为”继子待遇”——功能实现靠非官方手段拼凑,体验与其他渠道相比有明显差距。v2026.3.24 彻底改变了这一局面。

迁移至官方 Teams SDK

此次更新将 Teams 集成底层完全迁移至 Microsoft 官方 Teams SDK(PR #51808),不再依赖非官方兼容层。这一变化带来了一系列 AI 原生交互能力:

  • 流式回复(Streaming 1:1 Replies):AI 生成内容时实时更新消息气泡,不再等到完整回复后一次性发出,体验对齐 ChatGPT 等主流 AI 产品
  • 欢迎卡片(Welcome Cards):用户首次与 Bot 对话时,显示带有预设提示词的欢迎卡片,降低使用门槛
  • 提示词起始器(Prompt Starters):欢迎卡片内置常用操作按钮,用户点击即可发起常见任务
  • 打字指示器(Typing Indicators):AI 思考和生成时显示”正在输入…”状态,明确告知用户请求已被接收
  • 原生 AI 标注(Native AI Labeling):消息带有符合 Teams 官方规范的 AI 来源标注,满足企业合规要求
  • 反馈与反思(Feedback/Reflection):用户可以对 AI 回复进行点赞/点踩反馈
  • 状态更新(Informative Status Updates):在执行长时间任务时实时推送进度状态

消息编辑与删除支持

本次更新同步新增了对已发送消息的编辑和删除支持,包括在线程内找不到明确目标时的回退处理。这解决了旧版本中 AI 发出错误消息后无法修正的痛点——过去用户只能眼睁睁看着错误回复留在对话中。

Teams 用户升级注意事项

由于底层 SDK 发生变化,现有 Teams 集成用户需要重新生成 Bot Manifest,使用官方 Teams SDK 提供的新 Schema 模板,才能启用流式回复等新功能。建议登录 Azure 门户更新 Bot 应用配置后再升级。

二、7 个内置技能:一键安装,告别依赖地狱

这是本次更新中对新手用户影响最直接的改进。

新增一键安装菜谱的 7 个技能

以下 7 个内置技能现在带有完整的依赖安装菜谱(Install Recipes)

技能名称 功能描述 典型用途
coding-agent 代码生成与调试智能体 自动化代码编写、bug 修复、重构建议
gh-issues GitHub Issue 管理 自动创建、分类、关闭 GitHub Issues
openai-whisper-api 语音转文字(Whisper API) 语音消息转录、会议录音处理
session-logs 会话日志管理 查询、导出和分析历史会话记录
tmux 终端会话管理 在持久化终端会话中执行长时间运行命令
trello Trello 看板集成 自动创建卡片、移动任务、更新状态
weather 天气查询 查询当前和未来天气,支持多城市

一键安装菜谱解决了什么问题?

此前,安装这些技能时,如果缺少依赖(如 Python 包、系统工具、API Key 配置),用户只能看到一个红色的”依赖缺失”错误,然后自己去翻文档寻找解决方案。

现在,CLI 和控制面板会自动检测缺失的依赖,并直接提示按步骤安装——用户点击”安装缺失依赖”即可自动处理,全程无需查文档、无需手动 pip/npm 安装。

技能界面状态分类全面改版

技能(Skills)控制面板同步迎来界面重构:

  • 新增四个状态过滤标签页:全部(All)/ 就绪(Ready)/ 需要配置(Needs Setup)/ 已禁用(Disabled),每个标签旁显示对应数量
  • 点击每个技能后弹出详细面板,清晰说明:该技能需要什么、如何配置、在哪里获取 API Key,以及如何安装
  • 旧版中配置缺失时显示红色”missing”的粗糙提示,已替换为明确的操作指引

这一改版让技能库从”密密麻麻、不知从何下手”变成了”状态一目了然、操作有章可循”。

三、OpenAI 兼容 API 扩展:Open WebUI 接入与 RAG 支持

v2026.3.24 对 Gateway 的 OpenAI 兼容层进行了重大扩展,新增了两个关键端点:

  • /v1/models:列出当前 OpenClaw 实例中所有可用模型,客户端可用于动态发现模型
  • /v1/embeddings:提供文本嵌入向量接口,支持 RAG(检索增强生成)管道和向量数据库集成

同时,/v1/chat/completions/v1/responses 端点现在支持显式模型覆盖转发——客户端可以在请求中指定使用哪个模型,OpenClaw 会正确路由到对应服务商。

实际意义:Open WebUI 可以直接控制 OpenClaw 子智能体

这一扩展最直接的受益场景是 Open WebUI:你可以将 Open WebUI 指向 OpenClaw 的本地端点,通过 Open WebUI 的界面与 OpenClaw 的子智能体(sub-agents)进行对话和任务分配,而不需要额外的桥接层。

对于已经使用 LangChain、LlamaIndex 或其他基于 OpenAI API 的客户端库的团队,现在可以直接将 base URL 指向 OpenClaw,实现零代码迁移。

四、/tools 命令:实时可见性升级

新版 /tools 命令得到了重要改进:

  • 现在显示的是当前智能体实际可以使用的工具,而非所有已安装工具的完整列表
  • 新增紧凑模式(Compact View)默认显示,可选切换到详细模式(Detailed Mode)
  • 控制面板新增 “当前可用(Available Right Now)” 实时面板,让用户在发送请求之前就能知道哪些工具可以被调用

这解决了一个常见困惑:用户以为某个工具可用,但实际调用时才发现权限不足或配置缺失。现在直接看 “Available Right Now” 面板即可,无需猜测。

五、Discord:LLM 驱动的线程自动命名

Discord 渠道新增可选的线程自动命名功能(PR #43366,贡献者 @davidguttman):

{
  "channels": {
    "discord": {
      "autoThreadName": "generated"
    }
  }
}

设置后,每当 OpenClaw 在 Discord 创建新线程时,系统会异步调用 LLM 生成一个简洁的线程标题,而不是使用默认的消息内容作为标题。线程创建时先用消息内容作为占位标题,LLM 生成完成后自动替换为更具语义的名称。

默认仍使用消息内容命名(autoThreadName: "message"),需要显式配置才会启用 LLM 命名模式。

六、安全修复:媒体文件访问路径绕过漏洞

本次更新修复了一个媒体文件访问的安全漏洞:mediaUrl/fileUrl 别名路径可以被用于绕过 OpenClaw 的媒体访问根目录限制,理论上允许攻击者访问不该能访问的文件。

修复方案是完全禁用这个别名路径——工具操作(tool actions)和消息操作(message actions)都无法再通过该路径突破媒体访问边界。建议所有用户尽快升级以修复此安全问题。

七、Slack 改进:富文本回复与按钮交互

  • 富回复格式一致性恢复:修复了 Slack 富文本回复格式在某些情况下与其他渠道不一致的问题
  • 自动按钮渲染:消息末尾简单的 “Options:” 列表现在会被自动渲染为 Slack 交互式按钮,用户点击即可触发操作,无需手动输入
  • Codex 自动传输恢复:修复了 Slack DM 回复中 Codex 自动传输模式的问题

八、CLI 容器支持:–container 参数

新增 --container 标志和 OPENCLAW_CONTAINER 环境变量,允许在已运行的 Docker 或 Podman OpenClaw 容器内部执行 CLI 命令(PR #52651,贡献者 @sallyom):

# 在运行中的 Docker 容器内执行 openclaw 命令
openclaw --container models list
openclaw --container doctor
openclaw --container cron list

# 或通过环境变量指定容器
OPENCLAW_CONTAINER=openclaw_gateway openclaw doctor

这对于 Docker 部署环境下的运维管理非常实用——无需进入容器内部开 shell,直接在宿主机上执行管理命令即可。

九、关键 Bug 修复

单个频道崩溃不再阻塞其他频道启动

修复了一个影响多频道部署的严重问题:当某个频道(如 WhatsApp)在启动时出现配置错误导致崩溃,会阻止后续所有频道(Telegram、Discord 等)正常加载。

修复后,频道启动保持顺序执行,但单个频道的失败被隔离,不影响其他频道的正常启动(PR #54215)。

Docker 首次安装不再失败

修复了 Docker 新安装时引导配置在 Gateway 启动前就尝试写入配置导致失败的问题。现在所有引导时的配置写入通过 openclaw-gateway 正确路由,不再依赖 openclaw-cli 的共享网络命名空间(PR #53385)。

WhatsApp 群组回声抑制

修复了 WhatsApp 群组中 OpenClaw 会将自己发出的消息再次处理(相当于自己回复自己)的 Bug,彻底消除了群聊中的重复处理问题。

Telegram 论坛话题路由修复

修复了 Telegram 论坛话题(Forum Topics)中遇到 #General 主题时路由错误、消息无法发到正确话题的问题。

Gateway 重启后会话恢复

Gateway 重启后,现在会通过心跳机制唤醒中断的智能体会话,并对瞬时失败的出站投递进行一次重试,同时保留 Telegram 话题和 Slack 线程的路由信息(PR #53940)。

macOS 菜单栏 App:可折叠树形侧边栏

macOS 伴侣 App 的侧边栏导航从水平标签页(Pill Navigation)改为可折叠树形结构,在深层嵌套内容(如多个智能体、多个渠道)的情况下导航体验明显改善。

十、v2026.3.24 完整变更速查

类别 变更内容 类型
Teams 迁移至官方 SDK,流式回复 + 欢迎卡片 + 打字指示器 ✨ 重大改进
Teams 消息编辑与删除支持 ✨ 新功能
Skills(7个) 新增一键安装菜谱,自动检测并安装缺失依赖 ✨ 新功能
Skills UI 状态分类标签页(All/Ready/Needs Setup/Disabled) ✨ 界面改进
Gateway/OpenAI 新增 /v1/models 和 /v1/embeddings 端点 ✨ 新功能
Agents/tools /tools 显示实际可用工具 + 实时面板 ✨ 改进
Discord LLM 生成线程标题(autoThreadName: “generated”) ✨ 新功能
Slack 富回复格式一致性修复 + Options 自动渲染按钮 ✨ 改进 + 修复
CLI 新增 –container 参数和 OPENCLAW_CONTAINER 变量 ✨ 新功能
Security 修复 mediaUrl/fileUrl 别名路径绕过漏洞 🔒 安全修复
Gateway/channels 单频道崩溃不再阻塞其他频道启动 🐛 修复
Docker 首次安装不再在 Gateway 启动前失败 🐛 修复
WhatsApp 群组回声(自我消息重复处理)抑制 🐛 修复
Telegram 论坛话题 #General 路由修复 🐛 修复
Gateway 重启后会话恢复 + 出站重试 + 话题路由保留 🐛 修复
macOS App 侧边栏从水平标签页改为可折叠树形导航 ✨ 界面改进
Plugins/hooks 新增 before_dispatch 钩子,支持 TTS 和路由投递语义 ✨ 新功能

总结

v2026.3.24 是一个节奏感很好的功能扩展版本:Teams 重构让企业场景真正可用,7 个技能的一键安装让新手不再卡在依赖配置,OpenAI API 扩展打通了与更广泛生态的连接,而安全漏洞修复确保了整体可信度。

这个版本没有破坏性变更,适合所有用户直接升级:

npm install -g openclaw@latest
# 或
docker compose pull && docker compose up -d

升级后,Teams 用户记得重新生成 Bot Manifest;Docker 部署用户可以立即体验新的 --container CLI 参数;所有用户都值得打开技能界面看看新的状态分类,为那些”Needs Setup”的技能补全配置。

想追踪 OpenClaw 每个版本的中文解读,欢迎访问 OpenClaw 中文版官网