OpenClaw 发布了 v2026.3.24 版本,我看完更新日志第一反应是——这个版本必须升。
升级之后我认真用了一下,体验提升非常明显。技能系统终于不再混乱,Docker 安装也顺了,Teams 集成甚至让我萌生了把团队协作迁移过来的想法。
如果你还没升级,这篇文章帮你搞清楚:这次到底更新了什么,值不值得升,以及怎么升。
先说结论:这次升级的 7 大亮点
🐳 原生支持 Docker/Podman 容器内运行 OpenClaw 命令 🔌 OpenAI 兼容接口大幅增强,第三方工具接入门槛降低 🎯 技能系统重构,从"盲盒"变成"透明柜" 💬 Microsoft Teams 支持质的飞跃,企业协作场景可用性大增 🔒 8 项安全修复,包括 1 个媒体沙盒绕过漏洞 🐛 修了 30+ bug,包括 Docker 启动失败、WhatsApp 群组回音等长期痛点 ⚡ Node 版本检查前移,升级前就告诉你 Node 太旧而不是卡在半路
1. 这次最重磅:原生支持容器内运行命令
这条更新可能很多人没注意到,但我觉得是这次最有意思的新功能。
之前如果你在 Docker 或 Podman 里跑 OpenClaw,想在容器内部执行 openclaw 命令,是非常麻烦的事情。经常需要在宿主机和容器之间切换,或者写一堆奇怪的 wrapper 脚本。
现在只需要一个参数:
# 方式一:命令行参数openclaw run --container# 方式二:设置环境变量OPENCLAW_CONTAINER=1 openclaw agents list系统会自动检测你当前是否在 OpenClaw 的 Docker 或 Podman 容器内部,然后自动选择正确的命令路由路径。整个过程对用户透明。
这个功能对以下场景特别有用:
- CI/CD 流水线:
在 GitHub Actions 或 GitLab CI 里跑 OpenClaw 测试,不用再折腾复杂的容器嵌套问题 - 远程开发:
在云开发环境里联调 OpenClaw,可以直接在工作容器内部操作 - 运维场景:
SSH 到服务器上运行的容器,直接执行 openclaw 命令而不是 docker exec - 多项目隔离:
不同项目用不同容器,每个容器里有独立的 OpenClaw 环境
2. OpenAI 兼容接口大幅增强
上个大版本 Gateway 支持了 OpenAI 兼容接口,这次继续完善,新增了三个关键接口:
① /v1/models — 模型列表查询
之前想查询 OpenClaw Gateway 后接了哪些模型,必须走 OpenClaw 自己的接口。现在直接用标准 OpenAI 客户端调用 /v1/models 就能拿到模型列表,跟接官方 OpenAI API 一模一样。
② /v1/embeddings — 向量嵌入支持
这个对做 RAG(检索增强生成)的同学来说是重磅利好。之前 OpenClaw Gateway 不支持 embeddings 接口,很多向量数据库和 RAG 框架接不进来。现在可以了。
③ /v1/chat/completions 和 /v1/responses — 显式模型覆盖
之前如果通过兼容接口调用,需要遵循 OpenClaw 自己的模型路由规则。现在支持在请求里显式指定模型,客户端的模型偏好可以被正确传递和执行。
这意味着什么?
你之前用不了的一些 RAG 工具、Prompt 调试工具、AI 应用框架(比如 LangChain、LlamaIndex 等),只要它们支持 OpenAI 接口,现在都能直接连上 OpenClaw 作为后端。对于想基于 OpenClaw 自建 AI 产品的团队,这大幅降低了接入门槛。
3. 技能系统大重构:终于不用靠猜了
这是这次对普通用户影响最大的变化,没有之一。
之前的痛点
用过的都知道,OpenClaw 的技能系统功能强大,但配置过程简直是"盲盒"体验:
技能装了一堆,但不知道哪个已经配置好了、哪个还缺 API Key、哪个有依赖没装 缺 API Key 的时候只知道显示"missing",不告诉你在哪里申请 不同技能的安装方式不统一,有的用 npm、有的用 pip、有的要手动配置
每次排查都要翻文档、查日志,非常痛苦。
现在解决了
Control UI 新增状态过滤标签页,一目了然:
点开每个技能卡片,现在可以看到:
依赖是否满足 如果缺 API Key,会告诉你去哪里申请 如果缺工具,会告诉你用什么命令安装 一键 install 按钮
CLI 端也大幅改进:
openclaw skills info之前显示"missing:某些依赖"的地方,现在改成更友好的"needs setup",而且会告诉你:
在哪里申请对应的 API Key 用什么 CLI 命令保存配置 配置会存在哪个文件路径
技能市场也在完善:
这次还新增了 one-click install 能力,7 个内置技能(coding-agent、gh-issues、openai-whisper-api、session-logs、tmux、trello、weather)现在支持一键安装缺失依赖。Control UI 会自动检测你的环境,缺什么提醒什么,点击安装,不用手动敲命令。
4. Microsoft Teams 支持质的飞跃
Teams 这次变化非常大,说是重写都不为过。
升级到了官方 Teams SDK
之前用的是第三方方案,这次换成了微软官方的 Teams SDK。不只是稳定性提升,更重要的是终于可以完整使用微软推荐的 AI Agent UX 设计规范了。
新增的功能包括:
- 流式 1:1 回复:
消息一个字一个字出来,有打字机效果 - 欢迎卡片:
首次对话时发送带有 Prompt 启动器(Prompt Starters)的欢迎卡片,新用户知道怎么开始用 - 反馈/反思机制:
用户可以给 AI 的回复点赞或点踩,帮助 AI 越用越懂你 - 输入状态指示器:
AI 处理时会显示"正在输入...",用户知道 AI 在工作 - 原生 AI 标签:
聊天窗口里会有 AI 身份标识,符合微软的 AI 透明化要求
消息编辑和删除终于支持了
之前在 Teams 里发错消息是没法撤回的,跟其他平台比差很多。这次终于支持了,而且用的是 in-thread fallback 方案——即使没有明确指定回复目标,也能在线程里正确处理。
5. Docker 安装终于不报错了
这个 bug 困扰 Docker 用户很久了。
之前的问题
在新安装 OpenClaw Docker 容器的时候,有时候会遇到 shared-network namespace 循环的问题。具体表现是 openclaw-gateway 启动时卡住,然后报错退出,导致整个容器起不来。
根本原因: OpenClaw CLI 和 gateway 在 Docker 启动时的启动顺序有问题,CLI 尝试在 gateway 就绪之前就进行网络探测,两个组件互相等待,形成死循环。
这次修复
安装流程改成了通过 openclaw-gateway 写入 onboard/config,不再走 shared-network 路线。Gateway 启动好之后才接受配置写入请求,彻底解决了循环依赖问题。
实测效果: 我在一台新机器上用 Docker 全新安装 OpenClaw,从 docker run 到可以正常聊天,只用了不到 2 分钟,之前要折腾半天。
6. 安全修复:1 个中危 + 7 个低危
这次修了 8 项安全漏洞,最值得说的是这一个:
媒体文件沙盒绕过漏洞(已修复)
之前 outbound 工具和消息操作可以绕过配置好的 media-root 限制。比如你配置了 workspaceOnly: true 限制 AI 只能访问工作目录,但某些边界情况可以让 AI 绕过这个限制访问系统其他文件。
这个漏洞在 2026.3.24 里已经堵上。
7. 其他值得注意的改动
| Node 版本要求 | |
| Discord 线程命名 | autoThreadName: "generated",让 AI 自动给线程起简短标题 |
| WhatsApp 群组 | |
| Telegram 图片发送 | |
| Gateway 重启恢复 | |
| Slack 运行时默认值 | |
| Telegram 错误处理 |
怎么升级?
如果你用的是 npm 全局安装(最常见)
# 确认当前版本openclaw --version# 升级到最新版openclaw update这次有个贴心改进: 升级前会先检查 Node 版本,如果 Node 太旧会提前报错告诉你升级 Node,而不是升级到一半卡住。这个改进来自社区贡献者 @sallyom。
如果你用的是 Docker
# 拉取最新镜像docker pull openclaw/openclaw:latest# 重启容器docker-compose down && docker-compose up -d如果你用的是 macOS App
打开 App,右上角会提示更新,点一下就行。
升级前检查清单
- 跑一下状态确认:
openclaw status,确认当前环境正常再升级 - 看完 Release Note:
确认没有和你的自定义配置冲突的 Breaking Change - 备份配置目录:
cp -r ~/.openclaw/ ~/.openclaw.backup/,出问题可以回滚 - 检查 Node 版本:
node --version,确保是 22.14+
我的升级体验
我是在看到 Release Note 之后第一时间升级的,整个过程非常顺利:
跑 openclaw update,系统提示 Node 版本符合要求下载安装,大概 1 分钟完成 重启 Gateway 服务 所有历史会话正常,技能配置保留 Control UI 打开,技能状态一目了然
使用感受:
技能系统用起来舒服多了,缺什么一眼看出来 Docker 环境下测试插件再也不会卡住 Teams 的体验提升明显
最后
OpenClaw 的迭代速度是真的快。这个项目最初是一个人在业余时间开发,现在已经有了来自全球的社区贡献者体系。这次版本有 20+ 位社区开发者提交了 PR,每一个 PR 背后都是真实的用户需求。
作为用户,我是越来越觉得顺手了。工具在变强,我的日常工作也越来越依赖它。
你们升级了吗?升级过程中有什么问题,欢迎在评论区聊聊。
https://github.com/openclaw/openclaw/releases/tag/v2026.3.24
关注我,我会第一时间跟踪 OpenClaw 的重要版本更新。
夜雨聆风