OpenClaw 3.24 版本发布：全面优化 Skills 部署体验

OpenClaw 近期回归了稳定的迭代节奏。

此次版本更新，与以往那种"修复若干细微问题"的更新截然不同。从更新日志的篇幅就能感受到本次改动的重量级程度。其中更有几项重要改进值得单独展开说明。

Skills 部署流程更加顺畅

这部分改进对普通用户的体验提升是最为直接的。

此前安装 Skills 时，用户经常会遇到这样的困扰：安装完成后无法运行，满屏红色错误提示，却无从下手解决。

本次更新实现了两个关键优化：

一键安装配方（Install Recipes）功能上线

OpenClaw 内置的多个常用 Skills（包括 coding-agent、gh-issues、openai-whisper-api、session-logs、tmux、trello、weather 等）现在支持自动检测依赖环境。系统会自动识别缺失的依赖项，并主动提示安装，用户无需再翻阅冗长的文档。

Skills 页面全新改版

此前的 Skills 页面采用卡片式布局，所有项目密密麻麻挤在一起，用户难以辨别哪些可用、哪些需要配置。

新版页面采用了标签分类设计：全部 / 已就绪 / 需配置 / 已禁用，每个标签旁都显示对应数量。点击任意 Skill 会弹出详情窗口，其中详细列出了所需配置项、API Key 获取方式、安装步骤等。

此外还有一个暖心细节：以往 Skill 配置不全会显示红色警示"missing（缺失）"，现在改为"needs setup（需配置）"。

别小看这一词之差——它彻底改变了交互的语气。系统不再是在指责你配置有误，而是在引导你下一步应该如何操作。

毕竟，龙虾这类工具的核心价值之一在于提供良好的情绪体验。沟通方式很重要。

macOS 端配置页面导航焕然一新

macOS 版本本次对配置页面的导航结构进行了重构。

此前采用横向胶囊按钮平铺展示，层级关系不够清晰。

现在改用可折叠的树形侧边栏，支持展开/折叠操作，配合缩进展示层级关系。这与 VS Code 的文件树使用体验一致。

虽然不是颠覆性的革新，但确实大幅提升了操作便捷度。

安全漏洞修复

本次更新修复了一个媒体文件访问绕过的安全漏洞——原文件访问路径存在别名机制（mediaUrl/fileUrl），攻击者可能利用这一漏洞突破 OpenClaw 的媒体访问限制，获取理论上不应被访问的文件。

目前该别名绕过已被完全封堵，无论是工具动作还是消息动作，都无法再通过该路径突破媒体访问边界。

这类安全漏洞往往难以被发现——即使文件被窃取，用户可能完全意识不到问题所在。

Microsoft Teams 支持实现质的飞跃

此前 OpenClaw 对 Microsoft Teams 的支持相比其他平台存在明显差距，被用户戏称为"后妈生的孩子"。

本次更新对 Teams 底层架构进行了全面重构——迁移至 Teams 官方 SDK，告别了之前的非官方实现方式。

带来的变化远不止技术层面：

全新的 AI 原生交互体验包括：流式响应（让用户能够实时看到回复逐字输出的过程，类似 ChatGPT 的交互体验，而非长时间等待后突然显示大段文本）、欢迎卡片集成快捷提示词、输入框显示"正在思考"的状态指示器、消息旁添加原生 AI 标签。

简而言之，在 Teams 中使用 OpenClaw 的体验现在更接近真正的 AI 助手，而非强行嵌入的外部功能。

此外还新增了消息编辑和删除功能。以往 Agent 发送的消息如有错误只能干看着，现在可以修正了。

这两项改进共同将 Teams 频道的支持体验从"勉强能用"提升到了"可以认真使用"的水准。

群聊相关问题修复

除上述重点更新外，本次日志还列出了一系列频道层面的问题修复，覆盖了主流平台：

• • WhatsApp 群组：修复了 Agent 将自己发送的消息重复处理的问题（此前会导致自我回复循环）
• • Telegram 论坛话题：修复了遇到 #General 主题时路由错误导致消息无法投递到正确话题的问题
• • Discord：修复了超时无响应问题——此前 Agent 处理请求超时后会悄然无声，现在会发送超时提示通知用户

这些问题单独看可能都不严重，但长期使用这些频道的用户会感受到实实在在的体验差异。

面向 AI 开发者的更新要点

通过 OpenAI 兼容接口调用 OpenClaw 的开发者请注意：本次新增了 /v1/models 和 /v1/embeddings 两个端点，显著提升了 RAG（检索增强生成）场景的兼容性。

当前 OpenClaw 最新版本支持 Node 22.14+ 运行，官方推荐使用 Node 24。

此前 Node 22.14 用户在升级时会遇到版本不兼容导致安装失败的问题，本次更新将版本检测提前——执行 openclaw update 前会先检查 Node 版本，不满足要求会直接提示升级，避免安装中途失败后留下一堆难以理解的错误信息。

完整更新日志

重大变更

网关 / OpenAI 兼容性：

• • 新增 /v1/models 和 /v1/embeddings 端点
• • 支持通过 /v1/chat/completions 和 /v1/responses 透传显式模型覆盖参数，兼容更多客户端和 RAG 应用场景

Agent / 工具：

• • /tools 接口现仅展示当前 Agent 实际可用的工具
• • 新增默认紧凑视图（可切换至详细模式）
• • 控制台新增「当前可用」实时区块，提问前即可确认哪些工具可用

Microsoft Teams：

• • 迁移至官方 Teams SDK
• • 引入 AI Agent 交互最佳实践：单聊流式回复、带快捷提示词的欢迎卡片、反馈与反思机制、友好状态提示、输入指示器、原生 AI 标签
• • 支持编辑和删除已发送消息
• • 未指定明确目标时自动回退至线程内操作

Skills / 安装元数据：

• • 为内置 Skill（coding-agent、gh-issues、openai-whisper-api、session-logs、tmux、trello、weather）添加一键安装配方
• • CLI 和控制台检测到依赖缺失时可直接提示安装

控制台 / Skills：

• • 新增状态筛选标签页（全部 / 已就绪 / 需配置 / 已禁用，各附数量统计）
• • 原内联 Skill 卡片改为点击弹出详情对话框，包含依赖说明、启用开关、安装操作、API Key 输入、来源元信息及主页链接

Slack / 交互式回复：

• • 恢复直接投递的富文本回复对等支持
• • 自动将末尾简单的 Options: 列表渲染为按钮或下拉选择
• • 优化 Slack 交互设置默认值
• • 将回复控件与插件交互处理器隔离

CLI / 容器：

• • 新增 --container 参数和 OPENCLAW_CONTAINER 环境变量
• • 支持在已运行的 Docker 或 Podman OpenClaw 容器内执行 openclaw 命令

Discord / 自动线程：

• • 新增可选的 autoThreadName: "generated" 命名模式
• • 新建自动线程后可异步调用 LLM 生成简洁标题进行重命名
• • 原有基于消息内容的命名方式保留为默认行为

插件 / 钩子：

• • 新增 before_dispatch 钩子，携带规范化的入站元数据
• • 已处理的回复现经由标准末端投递路径转发，保留 TTS 和路由投递语义
• 

控制台 / Agent：

• • Agent 工作区文件列表改为可展开的 <details> 折叠行
• • 支持懒加载行内 Markdown 预览
• • 新增完整的 .sidebar-markdown 样式，覆盖标题、列表、代码块、表格、引用块及 details/summary 元素

控制台 / Markdown 预览：

• • 重新设计 Agent 工作区文件预览对话框
• • 采用磨砂玻璃背景、固定尺寸面板和样式化标题栏
• • 集成 @create-markdown/preview v2 系统主题，支持富文本 Markdown 渲染
• • 自动适配应用的亮色 / 暗色设计变量

macOS 应用 / 配置：

• • 将横向胶囊式子导航替换为可折叠树形侧边栏
• • 使用展开箭头和缩进子项行进行层级导航

CLI / Skills：

• • 将依赖缺失的提示文案从「missing（缺失）」软化为「needs setup（需配置）」
• • 在 openclaw skills info 输出中补充 API Key 配置引导

macOS 应用 / Skills：

• • 在 API Key 编辑对话框中新增「获取密钥」主页链接和存储路径提示
• • 保存确认消息中显示配置文件路径

控制台 / Agent：

• • 默认 Agent 模型选择下拉框新增「未设置」占位项

运行时 / 安装：

• • 将 Node 22 的最低支持版本降至 22.14+（官方仍推荐 Node 24）
• • 避免 npm 安装和自更新时将 Node 22.14 用户锁定在旧版本上

CLI / 更新：

• • 在执行 openclaw update 全局安装前，预先检查目标 npm 包的 engines.node 字段
• • Node 版本不满足时直接给出明确的升级提示，而非强行安装后失败

问题修复

出站媒体 / 本地文件：

• • 将出站媒体访问权限与已配置的文件系统策略对齐
• • workspaceOnly 关闭时，宿主机本地文件和入站媒体路径可正常发送
• • 严格工作区模式下的 Agent 仍保持沙箱隔离

安全 / 沙箱媒体分发：

• • 关闭 mediaUrl/fileUrl 别名绕过漏洞
• • 防止出站工具动作和消息动作突破媒体根目录限制

网关 / 重启哨兵：

• • 重启后通过心跳唤醒被中断的 Agent 会话
• • 出站投递遇到瞬时失败时自动重试一次
• • 唤醒路径保留显式线程 / 话题路由

Docker / 初始化：

• • 解决 Docker 全新安装时在网关启动前就失败的问题
• • 避免 openclaw-cli 共享网络命名空间的循环依赖

网关 / 频道：

• • 保持频道按顺序启动，同时隔离单个频道的启动失败

嵌入式运行 / 密钥：

• • 未解析的 SecretRef 配置不再导致嵌入式 Agent 运行崩溃

WhatsApp / 群组：

• • 追踪网关近期发送的消息 ID，仅抑制匹配的群组消息回声
• • 保留关联账号 fromMe 流量中的 /status、/new、/activation 等所有者指令

WhatsApp / 回复机器人检测：

• • 恢复隐式群组回复检测
• • 确保关联账号群聊中基于回复的 @ 提及能再次触达机器人

Telegram / 论坛话题：

• • 修复 Telegram 省略论坛元数据时 #General 话题的路由恢复问题

Discord / 网关监管：

• • 将网关错误处理集中到一个生命周期托管的监管器

Discord / 超时：

• • 入站 Discord Worker 在回复开始前超时时，发送可见的超时提示

ACP / 直接对话：

• • 确保最终 TTS 未产生音频时仍投递一条终态 ACP 结果

Telegram / 出站错误：

• • 保留可操作的 403 错误详情
• • 将「机器人不在群组内」归类为永久投递失败

Telegram / 图片：

• • 预检 Telegram 图片尺寸和宽高比规则
• • 图片元数据无效时自动回退为文件发送

Slack / 运行时默认值：

• • 精简 Slack 私信回复开销
• • 恢复 Codex 自动传输
• • 收紧 Slack 和网络搜索的运行时默认配置