13. Skills 技能系统：给 AI 装上新本领

本节目标：搞懂 Skill 到底是什么、它和记忆/工具的区别，学会启用现成技能，并写出一个能跑的最小 Skill。

一句话定义

Skill（技能）就是一份给 AI 看的”操作说明书”。

你把它写好，AI 遇到对应任务时就会按里面的步骤来。它不像普通聊天提示词那样每次都要重说一遍，而是可复用、按需加载的模块。

Note

没有技能的 OpenClaw 只是个会聊天的网关。装上技能，它才开始”能干实事”——搜文件、剪网页、整理知识、定时汇报，都是技能在背后撑着。

它和记忆、工具有什么不同

新手容易混。三句话分清：

记忆（Memory） 存的是”你知道的事”，比如”我偏好用 TypeScript”。
工具（Tools） 给的是”你能调用的能力”，比如执行命令、读文件。
技能（Skills） 教的是”遇到这类事该怎么专业地做”，把经验和流程打包好。

打个比方。工具像你手边的锤子，记忆像你记在笔记本上的心得，技能则像一份”装修标准作业流程”——既告诉你何时用锤子，也告诉你怎么钉才牢。

技能是怎么加载的

OpenClaw 很省 token。启动时，它只把每个技能的名字和一句话描述放进上下文，并不把全部正文塞进去。

等你真碰到相关任务，AI 才去把那份 SKILL.md 的完整内容读进来。这叫”渐进式加载”。好处是装的技能再多，平时也不占地方。

技能来自三个位置，优先级从高到低：

工作区里的 skills/（某个智能体专用）
共享目录 ~/.openclaw/skills（所有智能体都能用）
随安装包内置的技能（兜底）

Tip

想装一个只给自己用的技能，丢进 ~/.openclaw/skills/ 就行。想给某个项目单独用，丢进该智能体的工作区 skills/。

内置技能大致有哪些类

OpenClaw 随安装包自带一批官方技能，社区在 ClawHub 上还共享了海量第三方技能。常见类别包括：

文件管理类：按内容搜文件、批量重命名、整理下载文件夹。
知识管理类：网页剪藏、笔记同步、文献整理。
日程与提醒类：日历同步、定时提醒、任务清单。
自动化类：定时采集、网站监控、流程编排。
工具类：截图、翻译、单位换算。

Note

具体技能数量和榜单一直在变，以 ClawHub 实时页面和 openclaw skills search 的返回为准。本教程不写死数字，避免过时。

怎么启用和关闭

技能大多装好即生效。你也能用命令行查看和管理：

# 搜索 ClawHub 上的技能
openclaw skills search "calendar"

# 安装一个技能（来自 ClawHub）
openclaw skills install @owner/<slug>

# 从 Git 仓库安装
openclaw skills install git:owner/repo

# 从本地目录安装
openclaw skills install ./path/to/skill --as custom-name

# 列出已安装技能
openclaw skills list

# 批量更新所有已安装技能（保持最新）
openclaw skills update --all

装好之后，AI 在合适的对话里会主动调用。你也可以直接对 AI 说”用某某技能帮我做”，它就会按说明书执行。

Tip

不确定某个技能是否被 AI 看到？跑 openclaw skills list --eligible，它会告诉你当前环境里哪些技能真正可见、可用。

自己写一个最小技能

别被”开发”两个字吓到。一个最小技能，其实就是一个文件夹加一个 SKILL.md 文件。

my-skill/
└── SKILL.md      # 唯一必需的文件

SKILL.md 的头部是一段 YAML，至少要有 name 和 description：

---
name: pdf-summary
description: 提取 PDF 文本并生成一段中文摘要，当用户要"总结/提炼 PDF"时使用
---

# PDF 摘要

## 使用场景
用户丢来一个 PDF，希望快速知道它讲了什么。

## 步骤
1. 用 pdfplumber 提取正文文本。
2. 若扫描件，先走 OCR。
3. 把文本交给模型，输出 200 字以内的中文摘要。

就这么简单。AI 看到 description 里的触发描述，遇到”总结这个 PDF”就会读这份文件，照着步骤做。

想再丰富一点，可以加可选目录：

my-skill/
├── SKILL.md        # 指令 + 元数据（必需）
├── scripts/        # 可执行的脚本
├── references/     # 参考资料、模板
└── assets/         # 图片、资源

references/ 里的资料只在技能被激活时才被读取，平时不占上下文。

几个书写要点

写 SKILL.md 时记住这几条，能少踩坑：

把”什么时候用”写进 description。AI 靠它判断要不要触发这个技能。
正文用大白话写步骤，别写虚话。能列有序列表就别写长段落。
一次性小事不需要做成技能。真正的技能是”会反复出现、流程固定”的那类活。
敏感操作（删文件、跑命令）在 description 里点明，让用户有心理预期。

Note

技能本身只是说明书，最终执行仍受 OpenClaw 的工具权限和审批策略约束。一个技能说”我可以删文件”，不代表它真能绕过你的安全设置。

本节的边界

这一章只讲”技能是什么、怎么装、怎么写最小一份”。ClawHub 这个官方市场的玩法、自定义插件的工程化细节，留到第 16 章再展开。

你现在已经能判断：遇到重复出现的流程，就把它写成一个 Skill。这是把 OpenClaw 调顺手的第一步。