说真的,每次跟人聊起 OpenClaw 的扩展体系,绕不开的就是 Agent-Skills 和 Plugins 这两条路线。不少朋友问我的问题都是「我该先学哪个?」「哪个生态更好?」——其实这个问题没有标准答案,但有清晰的选型逻辑。
今天这篇,我基于 2026年8月 的最新版本(v2026.5.x 系列已经稳定,v2026.6+ 正在持续迭代),把两条路线的差异、生态、实测表现、适用场景一次性拆开讲透。文末还给你整理了选型决策树和 FAQ,建议收藏慢慢看。
一、先搞清楚:Skills 和 Plugins 到底是什么
在展开实测之前,先上一张速览表,把两者的核心差异摆出来:
| 维度 | Agent-Skills | Plugins |
| 形态 | 纯文本 Markdown 包 | Node.js 代码包 |
| 核心配置 | SKILL.md(prompt 模板) | manifest.json + npm 运行时 |
| 加载方式 | git-friendly,文本即可分发 | 需要 npm 安装,runtime 加载 |
| 适合解决的问题 | 业务流程固化、prompt 工程 | 底层能力扩展、新工具/Channel 接入 |
| 开发门槛 | 低(懂 Markdown 即可) | 中(要 Node.js/TypeScript) |
| 执行确定性 | 依赖模型生成 | 直接 API 调用,确定性高 |
| 当前官方定位 | 稳定补充 | 未来核心方向 |
记住这张表,后面所有判断基本都从这几点出发。
二、Plugins 的 manifest.json 到底怎么写
理解 Plugins 的第一步,就是看懂 manifest.json。一个典型的 manifest.json 声明如下:
{
"name": "firecrawl-search",
"version": "1.0.0",
"capabilities": {
"tools": ["firecrawl_scrape", "firecrawl_search"],
"providers": [],
"channels": []
},
"runtime": "node"
}
这玩意说白了就是 Plugin 的「身份证」:声明自己能提供哪些 tool、哪些 provider、哪些 channel。OpenClaw Gateway 在启动时会扫描所有 Plugin 的 manifest,把里面的能力注册到全局路由表里。
v2026.5.x 引入了 plugins.installs.json 持久化注册表,替代原来的 plugins.installs 内存状态。这意味着插件列表会在 Gateway 重启后保留,不会像之前那样每次启动都需要重新安装。说真的,这个改动对运维同学是真香——以前每次重启都要手动 claw plugin install 一遍,现在直接落盘。
同时,v2026.5.2 新增的 Crestodian 机制 为插件安装引入了审批和审计流程,企业用户可以控制哪些插件可以被安装,提升了安全性。简单理解:Crestodian 就是一个「插件市场的门禁系统」,未审批的插件不允许加载。
关键区别:Skills 纯文本、git-friendly;Plugins 需要 npm 环境和运行时加载,配置通过 gateway config 或 plugins.entries.* 管理。
三、生态现状(截至 2026-08)
根据 OpenClaw release notes 和 clawhub.ai 的最新数据:
Plugins 生态处于高速迭代期。 v2026.5.0 捆绑了 xAI Grok 4.3 provider、NVIDIA provider、People Wiki 插件;v2026.5.2 新增 Crestodian(插件市场 + 安装/卸载审批)、File Transfer Plugin(默认 deny 策略,16MB 上限);v2026.5.3-beta 继续 Plugin SDK 强化。官方明确将 Plugins 定为未来核心方向。
进入 2026 年下半年,Plugin SDK 的 API 稳定性明显提升,社区贡献的 plugin 数量也在持续增长。v2026.6+ 的几个版本主要在做 Plugin 注册中心的去中心化、跨 Gateway 共享 plugin 元数据、SDK 类型补全等方向(具体功能以官方 release notes 为准)。说白了,核心团队对 Plugins 的投入是肉眼可见的——拿捏的资源配比摆在那。
值得注意的是,Plugins 生态的增长速度正在加快。从 v2026.4.14 到 v2026.5.2 的版本迭代中,平均每个版本都带来 3-5 个新插件或 provider 的支持。这种迭代节奏在 OpenClaw 的历史上是前所未有的,说明核心团队正在将大量工程资源投入到 Plugins 基础设施中。
生态对比速览表
| 指标 | Plugins | Agent-Skills |
| 官方版本迭代速度 | 高(每月多次小版本) | 低(数月一次) |
| 社区贡献活跃度 | 持续增长 | 较低 |
| 主流数量级 | 数十到上百(持续扩张) | 约 16 个 |
| 战略定位 | 核心方向 | 稳定补充 |
| 代表项目 | xAI Grok 4.3 provider、NVIDIA provider、File Transfer Plugin | agent-reach、x-tweet-fetcher、seo-traffic-monetizer |
| 入门成本 | 中-高 | 低 |
Agent-Skills 生态相对稳定但不温不火。 ClawHub 上有 agent-reach、web-access、x-tweet-fetcher、browser-chromium、seo-traffic-monetizer 等约 16 个可用 skill,但社区贡献率低,版本更新慢。Skills 的价值在于特定场景的 prompt 固化,而非通用功能扩展。
这种生态差异的根因在于两者的开发门槛不同。编写一个高质量的 Agent-Skill,你只需要:
- 理解 OpenClaw 的 skill 机制
- 掌握 Prompt Engineering 的最佳实践
- 能够用 Markdown 编写规范文档
而开发一个 Plugin,你需要:
- 熟悉 Node.js/TypeScript
- 理解 OpenClaw Plugin SDK 的 API
- 掌握 npm 包的开发和发布流程
- 能够处理运行时错误和边界情况
显然,前者的门槛要低得多,这也是为什么 Skills 数量虽然少,但每个 Skill 的功能往往非常垂直和深入——因为开发者有精力把一个场景做透。
四、实测:任务执行差异
我用同一个需求分别测试两套机制:「抓取 Twitter 帖子并提取关键信息」。这个需求既能跑在 Skill 上(x-tweet-fetcher),又能映射到 Plugin 的 tool 调用场景,对比价值拉满。
4.1 通过 Agent-Skill(x-tweet-fetcher)
发送 /x tweet-fetcher ,skill 解析 SKILL.md 中的 prompt 模板,调用内嵌的 fetch 逻辑,输出格式化结果。全程文本流,配置简单,但能力上限受限于 prompt 设计的覆盖范围。
具体流程如下:
- 用户输入触发命令 → OpenClaw 识别 skill 名称
- 加载 x-tweet-fetcher/SKILL.md → 提取 prompt 模板
- 将 URL 和用户意图注入模板 → 生成完整的 prompt
- 模型执行 prompt → 调用内置的 fetch 逻辑
- 输出格式化结果 → 用户获得结构化信息
这个流程的优势是透明可控。你可以随时打开 SKILL.md,修改 prompt 模板的行为逻辑,无需重启 Gateway,skill 会自动重新加载。但劣势也很明显:整个过程依赖模型的理解和生成能力,存在一定的不确定性,同一个 prompt 在不同模型上可能有不同的输出质量。说白了,Skill 是「模型驱动」——模型的发挥决定上限。
4.2 通过 Plugin(假设存在 dedicated twitter plugin)
调用 twitter_fetcher 工具(如果注册了的话),直接执行 API 调用,返回结构化 JSON。理论上更高效,但目前 OpenClaw 官方 channel 主要是 Telegram/Discord/Slack 等,Twitter API 工具仍需通过 skill 或 exec 实现。
Plugin 的执行流程完全不同:
- 用户输入命令 → OpenClaw 路由到对应的 tool
- Plugin runtime 接收请求 → 构造 Twitter API 调用
- 直接发起 HTTP 请求 → 获取原生 JSON 响应
- 可选:通过 Plugin 内置的 parser 进行数据清洗
- 返回结构化数据 → 用户获得确定性结果
这个流程的优势是确定性——同样的请求,无论调用多少次,只要 Twitter API 返回的数据结构不变,输出结果就是稳定可预测的。但劣势是开发成本高:如果没有现成的 Twitter Plugin,你需要自己开发、测试、部署。Plugin 是「代码驱动」——能力上限取决于代码本身。
结论:Plugins 适合底层能力扩展,Skills 适合业务流程固化。两者不是替代关系,而是上下层配合。
五、典型应用场景对比
5.1 内容采集场景
SEO 进化猎手是一个典型的 Skill 驱动场景。它的工作流程是:
- 发现:扫描 GitHub trending、项目,发现新兴 AI 工具
- 诊断:分析目标项目的 SEO 能力缺口(Gap 诊断)
- 评估:根据 Gap 驱动评分模型计算落地优先级
- 执行:克隆项目、验证功能、写入 registry
整个流程涉及多个外部 API 调用和文件操作,但所有行为规范都固化在 SKILL.md 中。如果用 Plugin 来实现类似功能,你需要为每个步骤开发独立的工具,这显然是大材小用——而且这套流程本身就是 prompt 工程驱动的,模型对「什么算 SEO 缺口」的理解,比硬编码规则更灵活。
这就是 Skill 的天花板场景:业务策略密集、外部 API 多、决策路径需要语义理解。
5.2 渠道接入场景
渠道接入(Channel)几乎只能靠 Plugin 来做。原因很简单:
- Telegram/Discord/Slack 接入:需要长期维护 WebSocket 长连接、处理消息重连、消息格式适配(不同平台的 markdown、emoji 长度限制、消息分片规则都不一样)。这种长生命周期 + 平台特性的活儿,用 Skill 来做既不优雅也不现实。
- 自定义 channel:比如接入企业内部 IM、客服系统、邮件收件箱,本质上都需要一个常驻进程来收发消息,而 Plugin 恰好是 OpenClaw 推荐的 channel 承载方式(manifest.json 里的
channels 字段就是干这个的)。
反过来,如果你只是想让模型「按某种格式回复消息」「在某个场景下输出特定的 prompt 结构」,这种业务逻辑层的封装,写成 Skill 更合适。
简单总结:
- Skill 干「怎么想怎么说」——业务策略、prompt 模板、决策流程
- Plugin 干「怎么连怎么调」——网络通信、API 调用、长连接、文件传输
5.3 两者配合的真实场景
拿一个完整的「SEO 自动化监控」举例,理想状态是混合用:
- Plugin 负责:定时抓取 SERP 数据、调用 Ahrefs/Semrush API、读写本地数据库、推送告警到 Slack
- Skill 负责:定义「什么算一次 SEO 异常」「如何根据数据生成诊断报告」「告警文案该用什么语气」
这种分层架构的好处是:Plugin 干脏活累活(确定性高、性能可控),Skill 干需要语义理解的活(灵活、可调 prompt)。这是当前 OpenClaw 生态里最主流的生产级用法,纯靠任何单一机制都不够。
六、选型决策树:到底用哪个?
老实讲,没有「Skills 比 Plugins 好」或者反过来的结论。选型的核心是「你要解决的问题属于哪一层」。下面是我自己用的决策流程:
你的需求是什么?
│
├─ 需要连接新的外部系统/API(数据库、IM、文件系统、SaaS)
│ └─ 是 → 写 Plugin(manifest.json + Node.js)
│
├─ 需要长期维护长连接(WebSocket、消息队列、长轮询)
│ └─ 是 → 写 Plugin
│
├─ 已有 API,但希望固化某种「工作流/分析思路」
│ └─ 是 → 写 Skill(SKILL.md + prompt 模板)
│
├─ 团队里只有产品/运营同学,没有 Node.js 工程师
│ └─ 是 → 先写 Skill(Markdown 即可上手)
│
├─ 需要确定性的结构化输出(报表、JSON、固定 schema)
│ └─ 是 → 优先写 Plugin,Skill 仅作语义补充
│
└─ 还在探索阶段,需求会频繁变
└─ 是 → 先用 Skill 快速验证,验证清楚后再迁移到 Plugin
几条朴素的建议
- 个人开发者 / 小团队:先用 Skill 把流程跑通,确认有价值了再考虑 Plugin 化。
- 企业级 / 生产环境:优先 Plugin,辅以 Skill 做策略层;Crestodian 审批流务必启用。
- 混合架构是常态:不要硬选一个,Skill + Plugin 分层是大多数成熟项目的标配。
- 关注版本节奏:Plugins 现在是官方核心方向,新功能先看 Plugin SDK changelog。
常见误区(避坑指南)
- ❌「Skills 不值钱,因为它不是代码」 → 错。真正值钱的反而是把场景做透的 SKILL.md。
- ❌「Plugin 一定比 Skill 强」 → 错。用 Plugin 套业务策略是大材小用。
- ❌「我先写 Skill,以后再转 Plugin」 → 提前想好 schema,转的时候没那么痛。
- ❌「Plugin 越多越好」 → 错。Plugin 之间可能存在 tool 命名冲突,加载顺序、依赖关系要梳理清楚。
- ❌「忽略 v2026.5.x 的持久化机制」 → 错。
plugins.installs.json 是新版本默认行为,老的内存态配置可能直接失效。
FAQ
Q1:Agent-Skill 和 Plugin 能同时用吗?
可以。OpenClaw 的 Gateway 同时加载两者,Skill 可以调用 Plugin 提供的 tool,Plugin 也可以在某些 hook 里读取 Skill 的 prompt 上下文。生产环境里两者配合用才是常态,强行二选一会把自己坑得很惨。
Q2:我不会 Node.js,能玩 Plugins 生态吗?
能,但只能作为使用者——安装、配置、调用别人写好的 Plugin。要自己开发 Plugin,TypeScript 是基本门槛。不过好消息是 v2026.5.x 的 Plugin SDK 已经稳定了不少,照着官方 examples 抄比之前友好很多。
Q3:Skills 会被 Plugins 取代吗?
短期不会。官方明确表示两者是互补关系。但从资源投入来看,Plugins 是战略重心,Skills 更多是「轻量补充」。如果你想长期参与 OpenClaw 生态,学 Plugin 开发是更划算的选择。
Q4:Crestodian 审批机制怎么用?
v2026.5.2 引入。在 Gateway 配置里启用后,插件安装/卸载都需要走审批流。适合企业内多人协作的场景,避免某个成员误装来源不明的插件。具体配置项以官方文档为准。
Q5:ClawHub 上能直接发布自己的 Skill/Plugin 吗?
可以。Skill 直接通过 git 仓库 + SKILL.md 注册;Plugin 通过 npm 包 + manifest.json 注册。建议发布前先在本地 Gateway 跑通,再用 clawhub publish(具体命令以官方文档为准)走发布流程。
Q6:File Transfer Plugin 的 16MB 上限能调吗?
可以。v2026.5.2 引入的 File Transfer Plugin 默认走 deny 策略(安全优先),上限 16MB 写死在配置里。如需调整,修改对应 plugin 的 manifest 里的限制字段即可(具体字段名以官方 manifest 文档为准)。
【标签】
- Agent-Skills
- Plugins
- OpenClaw
- ClawHub
- Plugin SDK
- Crestodian
- manifest.json
- SKILL.md
- xAI Grok
- NVIDIA provider
- File Transfer Plugin
- SEO 进化猎手
- OpenClaw 扩展生态
- 选型决策
【相关阅读】
来源华强北商行 · 数码科技资讯