概述

一、从生活场景理解 Skill

想象你雇佣了一位私人助理：

这位助理：

  • 有一个聪明的大脑（Agent = AI 大脑）
  • 能说多国语言（Channel = 消息渠道）
  • 有基本的做事能力（Tool = 工具）
但是——
如果不让这位助理知道"什么时候该做什么事"，
他/她就只能等着你吩咐，每件事都要你详细指导。

Skill 就是给 AI 编写的"工作手册"，告诉它：

  • 什么时候该做什么
  • 怎么做这件事
  • 做完之后怎么汇报

二、Skill 的本质

Skill = 说明书 = SOP（标准作业流程）

对比项说明
Plugin给 OpenClaw 装上的"手脚"
Tool具体的"工具"本身
Skill什么时候、怎么用这些工具的"说明书"

三、为什么需要 Skill

没有 Skill 的 AI

你：请帮我画一张图
AI：好的，我来画图...（但不知道怎么调用画图工具）
你：请帮我查下这个数据
AI：好的，我来查...（不知道该用什么工具、怎么查）

有 Skill 的 AI

Skill 说：

  • 当用户说"画图"时
  • 调用 MiniMax 图片生成 API
  • 传递用户描述作为 prompt
你：请帮我画一张图
AI：好的，我来调用画图工具
（按照 Skill 的说明，调用了正确的 API）
→ 生成图片 → 发给你

四、Skill 和 Plugin 的核心区别

对比项PluginSkill
本质代码，让平台连通文档，告诉 AI 怎么用
谁来"读"系统读取AI 读取
需要编程吗需要（开发能力）不需要（写文档）
存放在哪插件目录skills/ 目录
格式JavaScript/TypeScriptMarkdown（.md）

五、Skill 文件的结构

Skill 就是一个 Markdown 文件，放在 ~/.openclaw/workspace/skills/ 目录下。

skills/
├── 图片生成/          # 技能文件夹
│   └── SKILL.md       # 技能说明文件 ← 核心
├── 数据分析/
│   └── SKILL.md
├── 日历管理/
│   └── SKILL.md
└── README.md          # 说明文件

六、SKILL.md 里写什么

```markdown # 图片生成技能

触发条件

当用户说"画图"、"生成图片"、"文生图"时触发

基础信息

  • 功能：调用 MiniMax API 生成图片
  • API 地址：https://api.minimaxi.com/v1/image_generation
  • 认证方式：Bearer Token

调用示例

（告诉 AI 怎么调用）

返回格式

（告诉 AI 结果怎么解析） ```

核心就是回答三个问题： 1. 什么时候触发？ → 触发条件 2. 怎么调用工具？ → API 格式和参数 3. 结果怎么用？ → 返回值解析

七、OpenClaw 自带的 Skills

你系统里已经安装的 Skills：

Skill功能触发词
minimax-image-generation文生图、图生图"画图"、"生成图片"
deepseek-analysis深度数据分析"深度分析"、"分析一下"
searxng网络搜索"搜索一下"、"查一下"
feishu-calendar日历管理"创建日程"、"明天几点有会"
feishu-task飞书任务管理"创建任务"、"待办"

八、Skill 的工作原理

用户发消息
    ↓
AI 理解意图
    ↓
匹配 Skill（搜索关键词）
    ↓ 找到
读取 SKILL.md
    ↓
按说明调用工具（API）
    ↓
返回结果给用户

九、自己写 Skill 能做什么

Skill用途触发示例
生图 Skill生成商品图、海报"画一张工作服海报"
数据分析 Skill分析销售数据"分析本周销售数据"
报表 Skill生成 Excel 报表"生成月度报表"
客服 Skill自动回复常见问题"退货政策是什么"
推荐 Skill根据用户画像推荐产品"推荐适合建筑行业的服装"

十、下一步学什么

  • 5.2 现有 Skills 一览 → 看看哪些可以直接使用
  • 5.3 编写你的第一个 Skill → 动手写一个简单的 Skill

Skill 是让 AI 从"会聊天"到"会做事"的关键！

常见问题

Q: Skill 开发需要学什么语言？
A: 主要是 JavaScript/TypeScript，JSON 格式要熟悉。