什么是Skill?给AI装插件到底是怎么回事

你有没有过这种经历——新手机买回来，功能就那么几个，用着用着觉得：”这手机要是能帮我XXX就好了。”然后你去应用商店一搜，嘿，还真有个APP专门干这个的，下载安装，啪，手机多了个功能。

AI 的 “Skill”（技能），本质上就是给AI装APP。

只不过这个”应用商店”叫 ClawHub，这个”APP”不是装在你的手机上，而是装在你的AI助手里。让你的AI从”只会聊天”变成”能查股票、能搜论文、能帮你管文件”。

一、为什么AI需要”装插件”？

1.1 AI本身不是万能的

现在的AI模型（比如Claude、GPT）确实很强大，但它们有个天然的局限——它们只认识文字。你说”帮我查一下腾讯今天的股价”，它只能回你一句正确的废话：”抱歉，我没有实时查股价的能力。”

这不是AI不够聪明，而是它被锁在了一个虚拟盒子里，看不见外面的世界，不知道今天股市涨跌，不知道你的本地文件里有什么，更不知道怎么操控你的浏览器去帮你订票。

1.2 插件就是AI的”手和脚”

Skill/插件的作用，就是给AI装上各种工具，让它能够：

• 🔍 上网搜索——能搜小红书、查百度、找YouTube视频
• 📊 查股票行情——实时获取股价、指数涨跌
• 📄 读写本地文件——帮你新建文档、整理文件夹
• 🌐 操控浏览器——自动填表、点击按钮、截图
• 📧 发邮件、发微信——帮你操作各种平台
• 📚 搜学术论文——查PubMed、arXiv等数据库

换句话说：没有插件的AI是个”思想上的巨人，行动上的矮子”。有了插件，它才能真正替你干活。

1.3 打个更形象的比喻

把AI助手想象成一个刚入职的聪明实习生：

• 脑子特别灵光，什么都能理解
• 但没有工位、没有工具、不知道公司有什么资源
• Skill就是给他分配工位、递上工具、告诉他去哪拿资料

这个实习生（AI）本身很聪明，但他需要：

• 给他一把钥匙（工具调用权限）
• 告诉他资源在哪（API接口）
• 告诉他怎么做这件事（指令说明）

Skill = 工具 + 使用说明 + 权限配置，三者打包在一起，就是一个完整的功能扩展包。

二、Skill到底是什么？深入技术原理

2.1 Skill的官方定义

根据 OpenClaw 官方文档的描述：

Skill 是一个包含 SKILL.md 文件的目录，告诉 AI 助手有哪些工具可以用、什么时候用、怎么用。

翻译成人话就是：Skill 是一个文件夹，里面装了一份”AI使用手册”。这个手册里写清楚了这个技能是干什么的、需要什么条件、怎么调用。

2.2 Skill的内部结构

一个 Skill 就是一个文件夹，至少包含以下内容：

hello-world/                  ← Skill的名字（文件夹名）
└── SKILL.md                  ← 核心文件：AI的使用说明书

SKILL.md 的内容长这样：

---
name: hello_world
description: 一个简单的打招呼技能
---

# Hello World Skill

当用户要求打招呼时，使用 `echo` 工具说："你好！我是你的AI助手。"

这里的 --- 包裹的部分叫 YAML frontmatter，是给系统看的元数据（metadata），包括：

• name：这个技能叫什么名字
• description：这个技能是干什么的，供AI理解

下面就是具体的使用说明——告诉AI在什么情况下该用这个技能，以及怎么用。

2.3 一个更复杂的Skill长什么样

真正有用的Skill，比如”查股票”：

---
name: stock-price-query
description: 实时查询A股、港股、美股行情，支持批量查询
metadata:
  {
    "openclaw": {
      "requires": { "bins": [] },    ← 需要什么外部程序
      "env": ["STOCK_API_KEY"]        ← 需要什么环境变量/API密钥
    }
  }
---

# 股票行情查询

## 什么时候用？
当用户询问股票价格、指数行情、涨跌情况时激活。

## 怎么用？
调用 `stock_price_query` 工具，传入股票代码列表。

2.4 Skill是怎么被AI发现和加载的？

OpenClaw 的官方文档写得很清楚，Skills 从三个位置加载（按优先级从高到低）：

优先级意味着什么？

假设你从 ClawHub 安装了一个叫 weather 的技能，但你想改一下它的说明文字——你只需要在自己的工作区 skills/ 目录下也创建一个 weather 文件夹并放入修改后的 SKILL.md。AI 会优先使用你本地的版本，而不是内置的原版。

三、Skill是怎么工作的？工作流程图解

3.1 完整调用链路

当你对AI说：”帮我查一下贵州茅台的股价”到AI返回结果，背后经历了以下步骤：

整个过程的关键在于：AI并不是”凭感觉”去调用工具的，而是严格按照 SKILL.md 里的说明来判断”这个情况下我该用什么工具、怎么用”。

3.2 Skill的加载时机

四、Skill和Plugin是什么关系？

4.1 简单说

4.2 Plugin比Skill更底层

Plugin 更多是底层能力扩展——比如让OpenClaw能接入 WhatsApp、Telegram、Discord 这些聊天平台，或者支持新的OAuth登录方式。

而 Skill 则是在这些底层能力之上的使用说明——教AI在什么场景下该怎么用这些能力。

4.3 它们可以组合使用

一个真实例子：

• Plugin：飞书插件（feishu）负责让OpenClaw能调用飞书API读写文档
• Skill：飞书文档Skill（feishu-doc）负责告诉AI：”当用户说’帮我写个飞书文档’的时候，你应该调用飞书插件的 feishu_doc 工具，构造这样的内容……”

Plugin 是工具本身，Skill 是工具的使用说明书。

五、Skill的安装和管理

5.1 ClawHub：AI的应用商店

OpenClaw 配套的 Skill 分发平台叫 ClawHub，你可以理解成AI技能的应用商店。

打开 https://clawhub.com，你可以：

• 🔍 搜索各种Skill（查股票、搜论文、发小红书……）
• ⬇️ 安装到本地
• 🔄 更新已有Skill
• 📤 发布自己写的Skill

5.2 安装命令

# 安装一个Skill
clawhub install stock-analysis

# 更新所有已安装的Skill
clawhub update --all

# 搜索Skill
clawhub search "股票"

5.3 Skill的存放位置

安装后，Skill会出现在你的 skills 目录里：

~/.openclaw/skills/           ← 本机共享的Skills（通过clawhub安装在这里）
~/.openclaw/workspace/skills/ ← 工作区专属Skills（只有当前AI能用）

六、Skill的条件门控：不是想用就能用

6.1 为什么要门控？

有些Skill需要特定条件才能使用，比如：

• 查股票需要 API密钥（否则无法连接数据源）
• 搜小红书需要 登录态
• 某些功能只有 macOS系统 才能用（Windows用不了）

这些条件叫做门控（Gating），写在Skill的 metadata 里。

6.2 门控的几种类型

metadata:
  {
    "openclaw": {
      "requires": {
        "bins": ["gemini"],        ← 必须有某个程序安装在电脑上
        "env": ["STOCK_API_KEY"],  ← 必须有某个环境变量
        "config": ["browser.enabled"] ← 必须在配置中启用了某个选项
      },
      "os": ["darwin"]  ← 只在macOS上生效
    }
  }

门控检查发生在Skill加载时，如果条件不满足，这个Skill就不会出现在AI的可用品列表里——AI根本不会知道有这个能力可用。

七、自定义Skill：自己动手给AI写说明书

7.1 创建一个Skill有多简单？

Step 1：创建文件夹

mkdir -p ~/.openclaw/workspace/skills/hello-world

Step 2：写一个 SKILL.md

---
name: hello_world
description: 一个简单的打招呼技能
---

# Hello World Skill

当用户要求打招呼时，使用 `echo` 工具说："Hello from my custom skill!"

Step 3：刷新OpenClaw

让你的AI助手重新加载，或者重启 Gateway 服务，OpenClaw会自动发现新目录并索引这个 Skill。

没错，就是这么简单。 你不需要写代码，只需要写一份”使用说明”，AI就能获得新能力。

7.2 写Skill的核心原则

1. 简洁明了：告诉AI做什么，而不是教它怎么当一个AI
2. 安全第一：如果Skill涉及执行命令，必须防止恶意注入
3. 本地测试：用 openclaw agent --message "use my new skill" 验证效果

八、一些常见的Skill类型

8.1 信息查询类

8.2 内容创作类

8.3 效率工具类

九、架构全景图

十、一句话总结

Skill 就是 AI 的”功能扩展包”。

它本质上是一个文件夹里装的”使用说明书”（SKILL.md），告诉你的AI助手：

• 在什么场景下应该做什么
• 需要用哪些工具
• 工具怎么调用

有了 Skill，AI 从一个只能”动动嘴皮子”的聊天对象，变成了真正能替你查股票、写文档、管文件、发小红书的私人助理。

下次有人问你”Skill是什么”，你直接告诉他：

“就是给AI装APP，听懂了吗？”