乐于分享
好东西不私藏

OpenClaw 2026.3.24 升级公告:这次更新太香了

OpenClaw 2026.3.24 升级公告:这次更新太香了

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 新增状态过滤标签页,一目了然:

状态
含义
颜色
🟢 Ready
可以直接用
绿色
🟡 Needs Setup
缺配置或 API Key
黄色
🔴 Disabled
已禁用
红色
⚪ All
全部
灰色

点开每个技能卡片,现在可以看到:

  • 依赖是否满足
  • 如果缺 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 版本要求
最低支持 Node 22.14+(之前是 Node 22.x 即可,现在要求 22.14 以上)
Discord 线程命名
可选 autoThreadName: "generated",让 AI 自动给线程起简短标题
WhatsApp 群组
修复了群组消息回音(Echo)问题,发出去的消息不会再被当新消息接收
Telegram 图片发送
图片尺寸不符合 Telegram 要求时,自动降级为文档发送,不再报错
Gateway 重启恢复
重启后通过心跳唤醒中断的会话,而不是只发一条干巴巴的重启提示
Slack 运行时默认值
优化了 DM 回复开销,恢复 Codex 自动传输,web-search 行为更合理
Telegram 错误处理
机器人被踢出群等 403 错误不再无限重试,直接标记为失败

怎么升级?

如果你用的是 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,右上角会提示更新,点一下就行。


升级前检查清单

  1. 跑一下状态确认:openclaw status,
    确认当前环境正常再升级
  2. 看完 Release Note:
    确认没有和你的自定义配置冲突的 Breaking Change
  3. 备份配置目录:cp -r ~/.openclaw/ ~/.openclaw.backup/,
    出问题可以回滚
  4. 检查 Node 版本:node --version,
    确保是 22.14+

我的升级体验

我是在看到 Release Note 之后第一时间升级的,整个过程非常顺利:

  1. 跑 openclaw update,系统提示 Node 版本符合要求
  2. 下载安装,大概 1 分钟完成
  3. 重启 Gateway 服务
  4. 所有历史会话正常,技能配置保留
  5. Control UI 打开,技能状态一目了然

使用感受:

  • 技能系统用起来舒服多了,缺什么一眼看出来
  • Docker 环境下测试插件再也不会卡住
  • Teams 的体验提升明显

最后

OpenClaw 的迭代速度是真的快。这个项目最初是一个人在业余时间开发,现在已经有了来自全球的社区贡献者体系。这次版本有 20+ 位社区开发者提交了 PR,每一个 PR 背后都是真实的用户需求。

作为用户,我是越来越觉得顺手了。工具在变强,我的日常工作也越来越依赖它。

你们升级了吗?升级过程中有什么问题,欢迎在评论区聊聊。

https://github.com/openclaw/openclaw/releases/tag/v2026.3.24


关注我,我会第一时间跟踪 OpenClaw 的重要版本更新。