夜雨聆风OpenClaw 刚刚推送了 2026.3.24 正式版。这不是一个"某个大功能炸场"的版本，而是三条线同时推进的扎实更新：接入更广（OpenAI 兼容层补全、Teams 全面重构、容器原生支持）、配置更顺手（Skills 管理体验翻新、Control UI 升级、macOS 侧边栏重构）、运行更稳（多平台 bug 修复、channel 启动隔离、session 恢复链路补强）。如果你正在用 OpenClaw 搭建自己的 AI 助手生态，这次值得仔细看。
一、OpenAI 兼容层补全：让更多工具直接接入
对于用 OpenClaw 接入第三方工具或自建 RAG 系统的用户，这次的改动直接降低了集成门槛。
此前，OpenClaw 的 Gateway 层缺少部分标准端点，导致一些期望完整 OpenAI API 兼容的客户端无法直接对接。本次补全了：
** /v1/models**：客户端现在可以直接查询 OpenClaw 上可用的模型列表，和查询 OpenAI 一样自然。** /v1/embeddings**：向量嵌入接口正式支持，RAG 流水线再也不需要绕路。模型显式覆盖透传：通过 /v1/chat/completions和/v1/responses发起请求时，如果请求体里指定了model字段，OpenClaw 现在会直接透传，而不是忽略或替换为默认值。
原本只支持 OpenAI SDK 的应用，换一个 base_url 就能无缝接入 OpenClaw——无论是 LangChain、LlamaIndex，还是各类向量数据库客户端。
二、Microsoft Teams 全面重构：从"能用"到"好用"
本次对 Microsoft Teams 集成进行了近乎完全的重写，是这个版本含金量最高的改动之一。
底层迁移到官方 Teams SDK，解决了走非官方路径导致的各类底层 bug。在此之上，跟进了微软最新的 AI Agent UX 最佳实践：
流式回复：1 对 1 对话支持实时流式输出，告别"等待 → 一次性弹出一大段"的割裂感。 欢迎卡片 + 提示词启动器：首次对话时展示欢迎卡片并附上推荐开场提示词，降低上手成本。 反馈与反思机制：集成微软推荐的 AI Agent 反馈模型，对话更有来回感。 打字指示器：AI 输出时显示"正在输入"动画，体验与真人对话拉齐。 原生 AI 标签：消息气泡标注为 AI 生成，符合微软 Copilot 内容披露规范。
此外，Teams 集成新增了消息编辑和删除能力——机器人发出的消息现在可以修改或撤回，线程内也有对应的兜底逻辑。
三、Skills 技能管理体验大翻新
Skills 是 OpenClaw 扩展 AI 能力的核心机制，这次对管理体验做了系统性梳理。
一键安装 Recipes
7 个内置技能（coding-agent、gh-issues、openai-whisper-api、session-logs、tmux、trello、weather）现在都内置了"安装配方"——缺少依赖时，CLI 和 Control UI 会直接提示你一键安装，而不是丢给你一条报错让你自己查文档。
Control UI 新增状态过滤
技能列表新增四个状态标签页：All / Ready / Needs Setup / Disabled，每个标签附带计数，一眼就能看出哪些技能还没配置好。
详情弹窗更实用
点进一个 Skill，会弹出详情对话框，集成了：依赖检查、开关控件、一键安装按钮、API Key 输入框、来源元数据和主页链接。过去要翻文档才能搞清楚怎么配，现在在界面里就能搞定。
措辞也更友好：缺少依赖从"missing（缺失）"改成了"needs setup（待配置）"，同时附上获取 API Key 的引导和存储路径说明。
四、Agent 工具可见性提升
/tools 命令做了改进：现在只展示当前 Agent 实际可调用的工具，而不是全局工具列表，并新增紧凑默认视图（可选展开详细模式）。Control UI 里新增"Available Right Now（当前可用）"区块，在发起请求之前就能确认工具是否可用，避免任务中途因工具不可达而失败。
另外，Agent model selector 新增了"Not set"占位项——这是个小细节，但它反映出这次更新在配置语义清晰度上的持续打磨。
五、Docker/容器原生支持
新增 --container 参数和 OPENCLAW_CONTAINER 环境变量，可以在正在运行的 Docker 或 Podman 容器里直接执行 openclaw 命令，适合 CI/CD 流水线或自动化脚本对容器化实例进行操作的场景。
同时修复了全新 Docker 安装时的经典坑：openclaw-cli 在 gateway 还未就绪时会失败。现在 setup 阶段的写操作会路由到 openclaw-gateway，不再依赖未就绪的共享网络，首次安装成功率大幅提升。
六、Discord 自动线程，LLM 生成标题
新增 autoThreadName: "generated" 选项：开启后，自动创建的新线程会异步由 LLM 生成简洁标题，比默认的"基于第一条消息命名"更准确。原有命名方式依然作为默认值保留，这是可选增强。
七、插件系统：新增 before_dispatch Hook
新增 before_dispatch 钩子类型，在消息分发给 Agent 之前触发，携带标准化的入站元数据。通过它处理的回复会走正常的最终交付路径，包括 TTS 和路由投递语义——插件可以在第一时间拦截、修改或直接响应消息，无需绕道。
八、Slack 交互回复能力增强
Slack 这次不只是修 bug，还补强了交互能力：
恢复 direct deliveries 的 rich reply 完整性，之前这块有回归，现在补回来了。 自动把简单的 Options:行渲染成 buttons/selects，不需要手动配置交互组件。改进了 Slack interactive setup 默认值，并将 reply controls 与 plugin interactive handlers 独立隔离，减少互相干扰。
对于用 Slack 做多渠道 Agent 交互入口的团队，这块的改动对日常使用体验影响明显。
九、这次还补了不少"不显眼但很关键"的工程体验
Control UI：agent workspace 和 markdown 预览全面升级
Agent workspace 的文件列表从平铺改成了可展开的 <details> 组件，支持懒加载内联 Markdown 预览。预览对话框接入了 @create-markdown/preview v2 system theme，支持 headings、tables、code blocks、callouts、blockquotes 等完整 Markdown 渲染，并随应用的明/暗主题自动切换。
macOS app：配置界面重构为可折叠树形侧边栏
macOS 配置界面从横向 pill 导航改成了带折叠箭头和缩进层级的树形侧边栏。API Key 编辑对话框新增了"Get your key"主页链接和存储路径提示，保存时也会在确认消息里显示配置文件路径。对桌面端用户来说，这次配置体验的改善感知非常直接。
Gateway restart sentinel：session 恢复更可靠
这条修复比表面看起来重要：重启后，OpenClaw 现在会通过 heartbeat 主动唤醒被中断的 agent session，而不只是发一条"已重启"通知；outbound 投递遭遇瞬时失败时会自动重试一次；同时，thread/topic 路由在恢复路径中得到了保留，回复会正确落到对应的 Telegram topic 或 Slack thread，不会串线。对于长对话或多线程渠道场景，这条修复影响很实际。
十、多平台稳定性修复
挑几个有代表性的：
WhatsApp：修复了群聊中机器人自发消息被错误触发回复的问题，同时修复了通过 reply-to-bot 方式在群里提及机器人失效的 bug。 Telegram：修复了论坛频道 #General主题（topic_id = 1）路由失效；修复了因图片尺寸/比例不符规范导致上传报错的问题，现在会自动降级为文件发送。Discord：修复了 worker 超时没有任何提示的问题，超时时会返回可见的提示消息；修复了 gateway 错误在拆卸阶段被误判为进程级崩溃的问题。 安全：关闭了通过 mediaUrl/fileUrl别名绕过媒体根目录限制的沙箱逃逸路径；Channel 启动现在独立隔离，一个 Channel 失败不再阻塞其他 Channel。
十一、Node 版本要求调整
Node 22 的最低受支持版本调整为 **22.14+**，同时继续推荐 Node 24。
openclaw update 现在会在执行全局安装前预检目标包的 engines.node 字段——Node 版本不符合要求时，直接给出清晰的升级提示，不再静默安装后让你面对莫名其妙的报错。
总结
OpenClaw v2026.3.24 是三条线同时推进的版本：
接入更广：OpenAI 兼容层补全、Teams AI 原生重构、Slack 交互增强、容器原生支持，让 OpenClaw 作为统一 AI 接入网关的定位更加稳固。
配置更顺手：Skills install recipes、状态过滤、详情页、macOS 侧边栏重构、Control UI markdown 预览升级，搭建自己的 AI 工具链的摩擦进一步降低。
运行更稳：Channel 启动隔离、Docker setup 修复、restart sentinel session 恢复、SecretRef fallback、安全沙箱补洞，跨平台多渠道部署的可靠性明显提升。
# 升级命令
npm install -g openclaw@latest
# 或
pnpm add -g openclaw@latest
Release Notes 原文：https://github.com/openclaw/openclaw/releases/tag/v2026.3.24
