OpenClaw v2026.3.24 正式发布：Gateway 兼容性与多平台体验全面升级

2026年3月26日，OpenClaw 正式发布了 v2026.3.24 版本。这是继上次 v2026.3.23 修复飞书插件稳定性问题之后，又一个重量级更新——本次版本带来了 Gateway 与 OpenAI API 的全面兼容性增强、Microsoft Teams 的重大架构迁移、Skills 一键安装体验，以及多项安全与稳定性修复。建议所有用户尽快升级。

一、版本概况

二、Breaking Changes

⚠️ 重要变更，升级前请留意

2.1 Node.js 版本要求调整

本次更新调整了 Node.js 版本策略：将 Node 22 的最低版本要求从模糊约束明确为 Node 22.14+。

影响：使用 Node 22.14 以下版本的用户，将无法通过 openclaw update 自动升级到最新版本。系统会给出清晰的版本升级提示，而非此前静默安装失败。

原因：避免 npm 全局安装过程中将低版本 Node 用户"搁浅"在旧版本上。

三、核心功能更新

3.1 Gateway / OpenAI 兼容性大幅增强 ⭐

这是本次更新最受关注的功能。OpenClaw Gateway 新增了以下三个关键端点：

• • /v1/models — 模型列表端点
• • /v1/embeddings — Embedding 生成端点
• • /v1/chat/completions / /v1/responses — 支持显式模型参数透传

这意味着什么？

OpenClaw 现在可以作为 OpenAI API 的替代网关，无缝对接更多第三方客户端和 RAG 应用。开发者无需修改任何调用代码，即可将 OpenClaw 作为本地或私有化 AI 网关使用。

典型应用场景：

• • 本地部署 RAG 系统，需要调用 /v1/embeddings 接口
• • 使用非官方客户端（如各类 AI 聊天工具）接入 AI 服务
• • 在网络受限或合规要求严格的私有环境下搭建 AI 代理
• • 开发者调试 AI 应用，需要一个可控的本地网关

💡 技术细节：这些端点此前并非 OpenClaw Gateway 的核心能力。v2026.3.24 补全了 OpenAI API 兼容层的最后几块拼图，使得 Gateway 的定位从"AI 聊天框架"升级为"完整的本地 AI 网关解决方案"。

3.2 Microsoft Teams 架构迁移 🏢

OpenClaw 完成了对 Microsoft Teams 的全面 SDK 迁移：从原有兼容方案迁移至官方 Teams SDK，并引入了一系列 AI Agent 交互最佳实践。

新增能力：

• • ✅ 支持流式 1:1 回复
• • ✅ 欢迎卡片（Welcome Cards）+ Prompt 启动器
• • ✅ 用户反馈和反思机制
• • ✅ 状态更新提示
• • ✅ 打字机效果指示器
• • ✅ 原生 AI 标签支持

消息编辑和删除也同步支持，并支持在未指定明确目标时自动降级到线程内回复。

💡 企业价值：对于已有 Microsoft 365 体系的团队而言，Teams 是最自然的 AI 入口。SDK 迁移完成后，OpenClaw 在企业协作场景的可用性有了质的飞跃。

3.3 工具系统重构：/tools 命令更实用

/tools 命令不再只是列出所有可用工具，现在能够展示当前 Agent 实际可用的工具列表。

Control UI 新增：

• • 紧凑默认视图 + 可选详细模式
• • "Available Right Now" 实时区域——提问前即可知道哪些工具当前可用

这对于配置了多个工具的复杂 Agent 来说，调试效率提升显著。

3.4 Skills 一键安装：降低使用门槛 🎯

OpenClaw 官方 Skills（coding-agent、gh-issues、openai-whisper-api、session-logs、tmux、trello、weather）现在支持一键安装依赖。

当用户尝试使用某个 Skill 但缺少依赖时，CLI 和 Control UI 会自动提示并引导安装，而非直接报错失败。

Control UI Skills 页面全面改版：

• • 新增状态过滤标签页：All / Ready / Needs Setup / Disabled（带计数）
• • 点击 Skill 卡片可查看详情：依赖要求、开关状态、安装按钮、API Key 录入、源码信息、主页链接
• • 错误提示从"missing"优化为"needs setup"——措辞更友好，减少用户的心理负担

3.5 Slack 交互回复增强 💬

3.6 CLI 容器支持 🐳

新增 --container 参数和 OPENCLAW_CONTAINER 环境变量，允许在运行中的 Docker 或 Podman 容器内直接执行 openclaw 命令：

openclaw --container <container_id> statusopenclaw --container <container_id> logs --follow

这对在容器环境中调试或管理 OpenClaw 的开发者非常实用。

3.7 Discord 自动线程命名 🧵

新增可选配置 autoThreadName: "generated"。启用后，新创建的自动线程可以异步地用 LLM 生成简短标题来命名，而非使用原始消息内容作为线程名。

默认行为保持不变，仍使用消息作为线程名称。

3.8 插件钩子：before_dispatch 新增

新增 before_dispatch 钩子，接收规范化的入站元数据，并将处理的回复通过正常最终投递路径传递，保留 TTS 和路由投递语义。

这为插件开发者提供了更精细的拦截和控制能力。

3.9 Control UI 界面全面升级 🎨

四、安全修复 🔒

本次更新包含 两项重要安全修复，建议所有用户务必升级。

4.1 出站媒体访问策略修复

问题：此前当 workspaceOnly 配置关闭时，宿主机本地文件和入站媒体路径的访问策略与预期不符，存在边界情况下的访问失控。

现状：已修复，严格工作区隔离的 Agent 继续保持沙箱状态。

4.2 媒体调度绕过漏洞修复

问题：mediaUrl / fileUrl 别名存在绕过路径——出站工具和消息操作可能绕过媒体根目录限制。

修复：已修复，编号 [#54034]。

五、其他修复一览

六、升级指南

已在运行 OpenClaw 的用户，升级非常简单：

# 方法一：openclaw update 命令（推荐）openclaw update# 方法二：npm 重装npm i -g openclaw@latest# 方法三：手动重装npm install -g openclaw

升级完成后重启 Gateway：

systemctl --user restart openclaw-gateway.service

查看日志：

openclaw logs --follow

七、相关资源

八、总结

v2026.3.24 是一个兼具广度与深度的版本。

Gateway 兼容性的全面提升让 OpenClaw 从一个 AI 聊天框架，正式升级为可以真正替代 OpenAI API 的本地网关解决方案；Microsoft Teams 的官方 SDK 迁移补足了企业场景的最后一块短板；Skills 一键安装则大幅降低了新用户的使用门槛；多项安全和稳定性修复则保证了生产环境的可靠性。

对于已经在使用 OpenClaw 的用户，本次更新值得立即升级。对于企业用户而言，Gateway 兼容性的增强和 Teams 支持的完善，使得 OpenClaw 在团队协作场景中的可用性大幅提升。

建议升级前阅读 Breaking Changes 文档，确保配置文件兼容性。

技术没有捷径，但有方向