乐于分享
好东西不私藏

OpenClaw 5.19 更新解读:插件、Skills、Codex 与 Gateway 全线补强

OpenClaw 5.19 更新解读:插件、Skills、Codex 与 Gateway 全线补强

如果只看功能列表,OpenClaw 5.19 会显得有点散:Gateway、ACPX、插件、Skills、Browser、Android、Telegram、QA-Lab、Provider 修复都在动。

但把这些更新串起来看,它真正想解决的是同一个问题:个人 Agent 不只是“能对话”,还要能长期运行、能被扩展、能被验证、能在真实通道里稳定交付。

所以 5.19 的重点不是“又加了几个小功能”,而是 OpenClaw 正在从个人助手原型,继续往可维护的 Agent 底座推进。
00 / 先给结论

最核心变化

插件 SDK 化、Skills 可共享化、Gateway 启动链路可观测化、Codex 插件管理进入聊天界面。
真正价值

它不是让 Agent “更会说”,而是让 Agent更好接工具、更好重启、更好调试、更好发布
升级注意

Node.js 22 最低支持线提高到22.19,插件和部分 Skills 也有迁移与弃用信号。
01 / Gateway

Gateway 继续补运行底座:重启、探针、配置、性能证据

OpenClaw 的 Gateway 是整个系统的入口。它连着模型、插件、Skills、消息通道和本地运行时。只要你把它当作常驻个人 Agent 来用,Gateway 的启动速度、可观测性和故障恢复就非常关键。

5.19 对 Gateway/ACPX 的启动追踪做了更细的成本归因:启动探针、配置、运行时、资源数量等成本都会进入 restart traces。同时,启动日志、插件服务启动和 channel sidecar 启动被进一步重叠执行,在保持/readyzsidecar gating 的前提下减少 ready 延迟。

这类更新看起来不性感,但对长期部署最重要。个人 Agent 的体验经常不是败在模型能力,而是败在重启慢、日志不清楚、插件半加载、通道 ready 不稳定。
启动链路更透明

Gateway/ACPX restart traces 开始拆分启动探针、配置、运行时和资源计数成本,方便定位“到底卡在哪里”。

重启体验更工程化

新增pnpm test:restart:gateway基准工具,用于重复测试 ready、downtime、trace 和资源斜率。

配置编辑更安全

配置查询能暴露 reload metadata,让工具区分字段是需要重启、可热加载,还是无变化。

02 / Plugins

插件系统开始像 SDK:不是“能接”,而是“能规范地接”

这次插件相关的变化很关键。OpenClaw 新增defineToolPlugin,并加入openclaw plugins initbuildvalidate。这意味着插件开发开始有更清晰的工程路径:初始化模板、生成 manifest、声明工具、创建上下文工厂、校验契约。

对 Agent 生态来说,插件不是锦上添花。它决定了一个本地 Agent 能不能接企业内部系统、私有数据库、浏览器控制、消息通道、业务 API。

很多 Agent 项目一开始都能“手搓工具”,但一旦进入多插件、多用户、多版本,就会遇到 manifest 不统一、权限不清楚、上下文注入混乱、弃用 API 无法迁移的问题。5.19 明确提到 plugin SDK/API deprecation paths,本质是在给插件生态留可持续演进空间。

  • 新增 typed simple tool plugins,降低插件开发和维护成本。
  • 插件 manifest metadata 可以生成,减少手写配置带来的不一致。
  • 消息插件和 subagents 的部分旧接口开始标记弃用,说明 API 边界在收紧。
  • admin HTTP RPC 支持可信客户端发起并等待 Web QR 登录流程,适合真实账号通道接入。
03 / Skills

Skills 不再只是提示词:开始变成可安装、可更新、可共享的能力模块

5.19 给 Skills 加了不少内容:meme-maker、node inspector debugging、diagram generation、throwaway spike workflow、Python debugging 等。单看每个 Skill 都不算特别大,但组合起来说明 OpenClaw 正在把 Skills 变成可复用的工作流资产。

更关键的是,openclaw skills installopenclaw skills update现在可以通过--global面向 shared managed skills。也就是说,Skills 不只是某个项目目录里的临时提示词,而开始接近“可全局安装、可集中更新”的能力包。

Python 调试

新增 Python debugging skill,覆盖pdbbreakpoint()、post-mortem inspection 和debugpyremote attach。
Node 调试

新增 node inspector debugging,用于更贴近前端/Node 工程的调试流程。
图表与探索

新增 fused diagram generation、throwaway spike workflow,让 Agent 更适合临时验证、画结构、做探索。
会话热更新

修复已存在会话无法感知 skill root 变化的问题,改 Skills 后不用总是重新开会话。
04 / Codex

Codex 集成变清晰:OpenClaw 不是替代 Codex,而是在编排 Codex

5.19 加入了/codex plugins list/codex plugins enable/codex plugins disable。这代表用户可以在聊天中管理 Codex 原生插件,而不是手动改配置文件。

另一个更微妙的变化是 Codex app-server 的 prompt scope:OpenClaw 会按 runtime surface 限定自己的提示引导,让原生 Codex 保留 Codex 自己的 base/personality instructions,OpenClaw 只贡献运行时上下文、交付引导和明确限定的命令提示。

这说明 OpenClaw 对 Codex 的定位更像“编排层”:不是粗暴接管 Codex,而是把 Codex 放进自己的 Agent 运行体系里。

这对 AI 编程工具的形态很有启发:未来可能不是单一 CLI 谁替代谁,而是一个本地 Agent 底座同时编排 Codex、浏览器、Skills、插件、消息通道和企业内部 API。

05 / Browser & Channels

浏览器自动化、移动端语音和消息通道也在补真实世界问题

浏览器自动化这次也有实用更新。Browser snapshot 会暴露 pending 和 recently handled modal dialogs;当动作触发弹窗时返回blockedByDialog;并允许通过browser dialog --dialog-id回答待处理弹窗。

这类能力很小,但在真实网页里非常重要。网页 Agent 经常不是输在“不会点击”,而是输在 confirm、alert、登录弹窗、超时执行和状态不可见。

Browser evaluate 支持超时控制

openclaw browser evaluate --timeout-ms可以拉长页面函数执行和请求超时预算。

Android Talk Mode 转向实时语音会话

Android 端 Talk Mode 切到 realtime Gateway relay voice sessions,支持流式麦克风输入、实时音频播放、工具结果桥接和屏幕转录。

Telegram 通道继续细修

包括 DM draft previews、forum topic 队列隔离、后续消息 abort signal 修复等,更偏消息通道稳定性。

06 / QA-Lab

QA-Lab 大量增强:Agent 也需要“发布前证据”

5.19 的 QA-Lab 更新非常多,包括 first-hour 20-turn、可选 100-turn runtime parity scenarios、Codex-vs-Pi 标准层、runtime tool fixture coverage、live-only canary、personal-agent approval-denial、no-fake-progress 等。

这背后的方向很清楚:Agent 系统不能只靠“演示能跑”。当它接入本地文件、插件、消息通道、记忆、Codex runtime 之后,必须有更细的发布前证据。

  • 验证 Codex 与 Pi runtime 的工具行为是否漂移。
  • 检查动态工具、原生 workspace 工具、插件工具的覆盖情况。
  • 验证拒绝本地读取时能否干净停止,避免假进度。
  • 通过 share-safe diagnostics 场景,让诊断信息可交接但不泄露原始个人内容。
07 / 升级提醒

可以升级,但先看这几个点

5.19 不是风险很高的大破坏版本,但它确实有一些工程边界变化。尤其是自建 Gateway、跑 systemd user service、接自定义插件和 Skills 的用户,升级前最好先确认环境。

  • Node.js 22 最低线提高到 22.19。如果你用 nvm 管理 Node,先检查 Gateway 服务实际使用的 Node 版本。
  • 如果使用自定义插件,注意interactive/ Slack directive producer API 等旧接口的弃用信号。
  • 如果使用 Obsidian Skill,官方改为依赖注册的obsidianCLI,而不是第三方obsidian-cli
  • Docker/Podman 本地镜像构建新增OPENCLAW_IMAGE_APT_PACKAGESOPENCLAW_IMAGE_PIP_PACKAGES,更适合把系统包和 Python 包纳入自定义镜像。
  • 如果曾遇到 Skills 改了但旧会话不生效,这次已经有针对性修复,可以重点验证。