OpenClaw 3.24发布：彻底解决最重要的Skills安装障碍！

OpenClaw 又回到了熟悉的日更节奏。

这次更新，跟之前那种「修了几个无关痛痒的小 Bug」完全不是一回事。

光是更新日志的长度，就能感受到这次变动的分量。

而且里面有几件事，值得单独拎出来说一说。

Skills 装起来更丝滑了

这块改动，对大部分普通用户来说可能是感受最直接的。

之前装 Skills，你可能碰到过这种情况：装完了，跑不起来，一堆红字报错，但是根本不知道缺什么。

这次做了两件事。

一件是加了一键安装配方（Install Recipes）。

OpenClaw 内置的几个常用 Skills（包括 coding-agent、gh-issues、openai-whisper-api、session-logs、tmux、trello、weather 等）现在装的时候，系统会自动检测你缺哪些依赖，缺了直接提示你装，不用自己去翻文档。

另一件是控制台的 Skills 页面整个重做了。

以前那个页面，就是一排卡片，密密麻麻堆在一起，你也不知道哪个能用、哪个缺配置。

现在改成了分标签：全部 / 已就绪 / 需配置 / 已禁用，旁边还带数量。

每个 Skill 点进去是一个详情弹窗，里面写清楚了它需要什么、怎么配、在哪儿找 API Key、甚至怎么安装。

还有一个小细节：以前 Skill 缺配置会标红，显示「missing（缺失）」。

现在改成了「needs setup（需配置）」。

就这一个词的改动，语气完全不一样了。

不是在责怪你配错了，是在告诉你下一步该干啥。

毕竟，龙虾最大的价值之一，是情绪价值。高情商说话很重要。

控制台的侧边栏

不再让你找不到东西了

macOS 版本这次把配置页的导航方式换了。

之前是横向的胶囊按钮，一排排平铺，点来点去，层级不清晰。

现在改成了可折叠的树形侧边栏，有展开箭头、有缩进层级，一眼就能看出大类和子类的关系。

就跟你用 VS Code 的文件树是一个感觉。

不是什么革命性的改变，但是用起来顺手很多。

安全方面，堵上了一个挺大的漏洞

这次修复了一个媒体文件访问绕过的安全漏洞——原本的文件访问路径有个别名（mediaUrl/fileUrl），攻击者可以通过这个别名跳出 OpenClaw 的媒体访问限制，拿到理论上不应该拿到的文件。

这次把这个别名绕过彻底关掉了，工具动作和消息动作都不能再通过这个路径突破媒体访问边界。

这种安全漏洞，通常不会有人来跟你主动汇报。

你就是莫名其妙地文件被读取了，都不一定知道从哪里出去的。

Microsoft Teams，终于补上了短板

一直以来，OpenClaw 对 Microsoft Teams 的支持，跟其他频道比起来，就像是后妈养的。

这次，OpenClaw 把 Teams 的底层彻底翻新了一遍——迁移到了 Teams 官方 SDK，不再用之前那套非官方路子。

但变化不止这些。

这次跟着一起上的，还有 AI 原生的交互体验：流式回复（就是你能看着回答一点一点打出来，像和 ChatGPT 聊天一样，而不是等半天突然蹦出一大段）、欢迎卡片加入了快捷提示词、输入中会显示「正在思考」的状态指示器、消息旁边还有原生的 AI 标签。

说得直白点，就是你在 Teams 里用 OpenClaw，终于开始有点像个真正的 AI 助手的感觉了，而不是硬塞进去的外来物。

另外，这次还加了消息编辑和删除。

以前 Agent 发出去的消息，发错了只能干瞪眼。现在可以改了。

这两件事加在一起，基本上是把 Teams 频道从「能用凑合用」提升到了「可以认真用」的档次。

顺手修了一堆群聊 Bug

除了上面这些，这次日志里还有一整排频道层面的修复，几乎把主要平台都覆盖了。

WhatsApp 群组里，OpenClaw 之前会把自己发出去的消息重复处理一遍，相当于自己回复自己，现在修复好了。

Telegram 论坛话题，遇到 #General 主题时路由会出错，消息发不到正确的话题下，现在能正确处理了。

Discord 的超时问题也修复了——之前如果 OpenClaw 在处理你的请求时超时，它会就这么悄无声息地不回应，现在会给你发一条超时提示，告诉你它没处理完。

这些 Bug 单独拿出来说，可能每个都不大。

但如果你每天都在用这些频道，积累下来的体验差距，是实实在在的。

值得 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 标签。

Microsoft Teams：支持编辑和删除已发送消息，未指定明确目标时自动回退至线程内操作。

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 配置引导（如何获取 Key、CLI 保存命令、存储路径）。

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 会话（不再仅发送尽力而为的重启通知）；出站投递遇到瞬时失败时自动重试一次；唤醒路径保留显式线程 / 话题路由，确保回复落到正确的 Telegram 话题或 Slack 线程。

Docker / 初始化：通过将启动前的初始化配置写入操作路由至 openclaw-gateway，避免 openclaw-cli 共享网络命名空间的循环依赖，解决 Docker 全新安装时在网关启动前就失败的问题。

网关 / 频道：保持频道按顺序启动，同时隔离单个频道的启动失败，确保某个频道异常不再阻塞后续频道的启动。

嵌入式运行 / 密钥：未解析的 SecretRef 配置不再导致嵌入式 Agent 运行崩溃，改为回退至已解析的运行时快照。

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

WhatsApp / 回复机器人检测：恢复隐式群组回复检测——通过解包 botInvokeMessage 载荷并从 creds.json 读取 selfLid，确保关联账号群聊中基于回复的 @ 提及能再次触达机器人。

Telegram / 论坛话题：修复 Telegram 省略论坛元数据时 #General 话题（topic 1）的路由恢复问题，覆盖原生指令、交互回调、入站消息上下文及回退错误回复。

Discord / 网关监管：将网关错误处理集中到一个生命周期托管的监管器，使早期、运行中和销毁阶段的 Carbon 网关错误得到统一分类，不再作为进程级崩溃抛出。

Discord / 超时：入站 Discord Worker 在回复开始前超时时，发送可见的超时提示，涵盖已创建的自动线程目标和排队运行的顺序。

ACP / 直接对话：即使块文本已提前流式发送，最终 TTS 未产生音频时仍确保投递一条终态 ACP 结果；跳过多余的空文本终态合成请求。

Telegram / 出站错误：保留可操作的 403 错误详情（含成员关系 / 封禁 / 踢出信息）；将「机器人不在群组内」归类为永久投递失败，避免 Telegram 持续重试无效对话。

Telegram / 图片：预检 Telegram 图片尺寸和宽高比规则，图片元数据无效或不可用时自动回退为文件发送，解决 PHOTO_INVALID_DIMENSIONS 报错导致图片上传失败的问题。

Slack / 运行时默认值：精简 Slack 私信回复开销；恢复 Codex 自动传输；收紧 Slack 和网络搜索的运行时默认配置，涉及私信预览线程、缓存作用域、警告去重及网络搜索显式开启逻辑。

鉴于几天前 OpenClaw 3.22 的更新大翻车导致龙虾大规模崩溃，再次提醒您，谨慎升级部署于生产环境的主力龙虾。

参考资料：

https://github.com/openclaw/openclaw/releases

文章来自于微信公众号 “新智元”，作者 “新智元”