夜雨聆风OpenClaw 于3月25日正式发布v2026.3.24版本，本次更新聚焦OpenAI生态兼容、多平台交互体验升级、Control UI全面重构三大核心方向，同时修复了20+项跨平台适配与安全漏洞，进一步提升了系统的稳定性和易用性。此外，版本还降低了Node运行时门槛，优化了容器化部署体验，让不同环境的用户都能便捷使用。
本次更新由steipete主导发布，共有12位开发者参与贡献，包含10次核心提交，在保持功能迭代的同时，实现了对旧版本的平滑兼容，是一次兼顾功能增强与体验打磨的重要更新。
一、核心更新内容：多维度升级，适配更多使用场景
本次更新的Changes板块涵盖网关兼容、多平台适配、UI交互、CLI工具、运行时优化等多个维度，重点解决了开发者在RAG开发、跨平台协作、技能管理中的痛点问题。
1. OpenAI生态深度兼容，拓展RAG与客户端适配性
新增/v1/models和/v1/embeddings接口，同时支持在/v1/chat/completions和/v1/responses中显式转发模型覆盖参数，让OpenClaw能无缝对接更多基于OpenAI标准开发的客户端工具和RAG应用，无需额外的适配开发，大幅提升了生态兼容性。
2. 多平台交互体验全面升级，覆盖Teams/Slack/Discord/WhatsApp
Microsoft Teams：迁移至官方SDK，新增流式一对一回复、带提示启动器的欢迎卡片、反馈反思、输入状态指示、原生AI标签等UX最佳实践；同时支持消息编辑/删除，无明确目标时自动在线程中降级展示。
Slack：恢复直送消息的富文本回复一致性，自动将尾部
Options:行渲染为按钮/选择器，优化交互式设置默认值，隔离回复控件与插件交互处理器。Discord：新增
autoThreadName: "generated"可选配置，自动创建的线程可由LLM异步生成简洁标题，保留原有消息命名作为默认方案。WhatsApp：优化群聊回声抑制，仅屏蔽网关发送的匹配消息ID，保留群主的
/status//new//activation命令；恢复群聊中基于回复的机器人提及检测。
3. 技能管理体系重构，一键安装+可视化配置
为内置技能（coding-agent、gh-issues、openai-whisper-api等）添加一键安装配方，CLI和Control UI会自动检测缺失的依赖并提供安装选项，无需手动配置环境。同时优化技能状态管理，新增All/Ready/Needs Setup/Disabled带计数的状态筛选标签，点击技能卡片可打开详情弹窗，展示依赖要求、开关、安装操作、API密钥输入、源码元数据和主页链接，让技能管理更直观。
4. Control UI全方位打磨，交互与渲染体验升级
本次UI更新是重点板块，由@BunsDev主导完成，多项优化让操作更高效：
代理工作区文件行改为可展开的
<details>组件，支持懒加载内联Markdown预览；重构Markdown预览弹窗，采用磨砂背景、自适应面板，集成
@create-markdown/previewv2系统主题，支持明暗模式自动切换，完美渲染标题、表格、代码块、引用等元素；macOS端将水平药丸式导航替换为可折叠树形侧边栏，提升大屏操作效率；
代理模型选择下拉框新增Not set占位符，避免空值误选；
新增“Available Right Now”实时板块，直观展示当前可用的工具和技能。
5. CLI与容器化部署优化，提升开发与运维效率
新增
--container参数和OPENCLAW_CONTAINER环境变量，可直接在运行中的Docker/Podman容器内执行openclaw命令；优化技能信息输出，将“missing”缺失依赖标签改为更友好的“needs setup”，并在
openclaw skills info中展示API密钥获取地址、CLI保存命令、存储路径等指引；macOS端API密钥编辑弹窗新增“Get your key”主页链接和存储路径提示，保存时显示配置文件路径，降低配置门槛。
6. 运行时与更新机制优化，兼容更多环境
降低Node.js版本要求，将Node 22的最低支持版本降至
22.14+，同时仍推荐使用Node 24，避免Node 22.14用户被卡在旧版本；openclaw update命令新增预检查，在全局包安装前验证目标npm包的engines.node配置，若Node版本过时会给出清晰的升级提示，而非直接执行不支持的安装。
7. 插件与钩子增强，拓展自定义开发能力
新增before_dispatch钩子，携带标准的入站元数据，同时将处理后的回复路由至常规的最终交付路径，保留TTS和路由交付语义，让开发者的自定义插件能更灵活地介入消息处理流程，且不破坏原有功能逻辑。
二、技术细节：底层优化+安全加固，提升系统稳定性
本次更新的Fixes板块针对沙箱安全、网关稳定性、跨平台适配、容器部署等底层问题进行了深度修复，同时解决了多个长期存在的bug，技术层面的优化主要体现在以下几点：
1. 沙箱安全加固，防止媒体路径逃逸
对齐出站媒体访问与配置的文件系统策略，
workspaceOnly关闭时允许访问主机本地文件和入站媒体路径，开启时严格隔离沙箱内代理；封堵
mediaUrl/fileUrl别名绕过漏洞，确保出站工具和消息操作无法突破媒体根目录限制，提升系统安全性。
2. 网关稳定性优化，解决启动与重连问题
网关重启哨兵通过心跳唤醒中断的代理会话，而非仅发送重启通知，瞬态失败时重试一次出站交付，并保留线程/主题路由信息，确保回复准确发送至Telegram主题或Slack线程；
通道启动改为串行执行，同时隔离单个通道的启动失败，避免一个损坏的通道阻塞后续所有通道启动；
集中化Discord网关错误处理，通过生命周期管理的监督器统一分类错误，避免启动、运行、关闭阶段的错误导致进程崩溃。
3. 容器化部署修复，解决Docker初始化失败
优化Docker启动流程，将初始化时的配置写入操作路由至openclaw-gateway，避免openclaw-cli共享网络命名空间循环，解决全新Docker安装时网关未启动导致的初始化失败问题。
4. 跨平台适配bug修复，解决多端使用痛点
Telegram：修复论坛元数据缺失时
#General主题（ID=1）的路由问题，支持原生命令、交互式回调、入站消息上下文和降级错误回复；预检查图片尺寸和宽高比规则，元数据无效时自动降级为文档发送，解决PHOTO_INVALID_DIMENSIONS上传失败；保留403错误详情（成员限制/屏蔽/踢出），将“机器人非群成员”标记为永久交付失败，避免无效重试。Discord：工作线程超时前发送可见的超时回复，包含自动创建的线程目标和排队运行顺序，提升用户感知。
嵌入式运行：解决未解析的
SecretRef配置导致嵌入式代理运行崩溃的问题，缺失时回退至已解析的运行时快照。
5. 音频与文本交付优化，提升ACP直聊体验
当最终TTS无法生成音频时，仍会交付终端ACP结果（即使文本已流式传输），同时跳过冗余的空文本最终合成，避免无效的资源消耗。
三、完整升级方式：多安装类型适配，平滑升级不丢配置
OpenClaw v2026.3.24支持全局安装、源码安装、容器安装、Control UI一键更新等多种升级方式，且更新前无需手动卸载旧版本，官方提供了安全的原地升级流程，更新前建议先快照定制配置：
# 快照配置、凭证、工作区cp -r ~/.openclaw/openclaw.json ~/openclaw-config-backup/cp -r ~/.openclaw/credentials/ ~/openclaw-creds-backup/cp -r ~/.openclaw/workspace ~/openclaw-workspace-backup/
方式1：推荐！一键安装脚本（全局/新用户）
适用于全局安装用户和新用户，脚本会自动检测现有安装、原地升级，并运行openclaw doctor修复配置问题，跳过新手引导添加--no-onboard：
# macOS / Linux / WSL2curl-fsSL https://openclaw.ai/install.sh | bash# 跳过新手引导curl-fsSL https://openclaw.ai/install.sh | bash-s----no-onboard# Windows (PowerShell)iwr -useb https://openclaw.ai/install.ps1 | iex# 跳过新手引导& ((scriptblock)::Create((iwr -useb https://openclaw.ai/install.ps1))) -NoOnboard
方式2：npm/pnpm全局升级（已手动管理Node的用户）
适用于已通过npm/pnpm全局安装的用户，直接升级至最新版本：
# npmnpm i -g openclaw@latest# pnpmpnpm add -g openclaw@latest# 修复sharp构建错误（可选）SHARP_IGNORE_GLOBAL_LIBVIPS=1npm install -g openclaw@latest
方式3：源码安装升级（开发者/贡献者）
适用于通过git clone源码安装的用户，官方推荐使用openclaw update命令，自动完成拉取、重构、依赖安装和重启：
# 首选自动更新openclaw update# 手动更新（等效）git pullpnpm installpnpm buildpnpm ui:buildopenclaw doctor
方式4：Control UI/RPC一键更新（可视化操作）
适用于习惯使用图形界面的用户，在Control UI中执行更新并重启，底层会运行与openclaw update相同的源码更新流程，更新完成后自动重启网关，并向最后活跃的会话发送更新报告，若重构失败会中止更新并恢复原版本。
方式5：容器化部署升级（Docker/Podman）
结合本次新增的--container参数，容器内用户可直接执行：
# 容器内运行更新命令openclaw --container update# 或重启容器拉取最新镜像docker restart openclaw-container
升级后必执行：验证与重启
无论哪种升级方式，完成后建议执行以下命令验证并重启网关，确保更新生效：
# 检查配置问题并迁移旧配置openclaw doctor# 重启网关openclaw gateway restart# 验证网关健康状态openclaw health# 查看网关日志（可选）openclaw logs --follow
四、版本兼容说明
Node.js版本：支持Node 22.14+（最低）、Node 24（推荐），更新后无需手动升级Node，若版本过低
openclaw update会给出清晰的升级提示；安装类型兼容：全局安装、源码安装、容器安装均可平滑升级，无强制迁移要求；
配置兼容：旧版配置文件会被
openclaw doctor自动迁移，无需手动修改；插件兼容：新增的
before_dispatch钩子为增量更新，旧版插件无需修改即可正常运行。
五、总结
OpenClaw v2026.3.24是一次兼顾功能与稳定性的高质量更新，既通过OpenAI接口兼容、多平台UX优化、技能一键管理降低了使用门槛，又通过沙箱安全加固、网关底层优化、跨平台bug修复提升了系统可靠性。同时，版本对Node运行时和部署方式的兼容优化，让不同使用场景的开发者都能轻松升级。
本次更新的贡献者包括@vincentkoc、@BunsDev、@davidguttman等12位开发者，感谢社区的积极参与和贡献。如果你在使用过程中遇到问题，可前往OpenClaw GitHub仓库提交Issue，也可在社区交流群分享使用体验。
后续OpenClaw将持续聚焦AI代理生态适配和跨平台协作体验，敬请期待更多更新！
# 1. 安装微信插件（龙虾标准命令）openclaw plugins install @tencent-weixin/openclaw-weixin# 2. 启用插件openclaw config set plugins.entries.openclaw-weixin.enabled true# 3. 触发登录（生成二维码）openclaw channels login --channel openclaw-weixin
附：OpenClaw v2026.3.24官方发布页官方文档：OpenClaw安装与更新指南
