OpenClaw Skill 基本概念

如果把 OpenClaw 看成一个能真正执行任务的 AI 助手，那么 Skill 就是交给它的操作说明书。AI 能理解你的需求，但要去查 GitHub、发邮件、操作浏览器、运行命令或调用接口时，它还需要知道该用什么工具、按什么步骤做、遇到异常怎么处理。

第1张：Skill 是 AI 的操作说明书

Skill 的价值，就是把一次成功经验写成可复用流程。它通常是一个文件夹，核心文件叫 SKILL.md：上半部分写名称和 description，下半部分用 Markdown 写清楚使用场景、执行步骤、命令示例、输出要求和安全边界。

第2张：为什么需要 Skill

真正影响触发效果的是 description。它不是宣传语，而是给 AI 的判断条件。写得越具体，AI 越容易在正确场景调用它；写得太泛，就容易漏触发或误触发。一个好描述应该说明任务对象、触发场景和动作目标。

第3张：一个 Skill 长什么样

OpenClaw 会从多个位置加载 Skill，包括工作区、项目目录、个人目录、托管目录、内置目录和额外目录。同名 Skill 同时出现时，高优先级位置会覆盖低优先级版本，所以修改前要先确认技能来自哪里。

第4张：位置决定优先级

创建第一个 Skill 并不复杂。先建立以技能名命名的目录，再写 SKILL.md，填好 name 和 description，把步骤、命令和结果整理方式写清楚。保存后重启网关、重新开始会话或热重载，再用真实请求测试是否按预期运行。

第5张：创建第一个 Skill

SKILL.md 正文应该像操作手册，而不是产品介绍。它要直接告诉 AI：什么时候用，先做什么，执行什么命令，结果怎样整理，哪些情况需要提醒用户，哪些边界不能越过。说明越具体，执行时越少猜测。

第6张：description 是触发开关

日常维护时，skills list、skills show、doctor、gateway restart 和 skills reload 很常用。斜杠命令 /skill 也很适合调试固定流程，它能绕过自然语言触发判断，直接调用指定技能并观察结果。

第7张：正文要像操作手册

社区 Skill 能节省大量时间，但安装前必须先看安全边界。要特别留意远程下载脚本、读取密钥、执行系统命令和混淆代码。稳妥做法是先小范围测试，再放进主流程。

第8张：常用命令负责维护

高质量 Skill 的标准不是写得长，而是触发准确、依赖明确、命令安全、输出稳定。不要把用户输入直接拼进危险命令，不要把密钥写进文件，也不要加载一堆用不到的技能消耗上下文。

第9张：社区 Skill 先看安全

当重复任务都有自己的 Skill，OpenClaw 就不只是一个会回复的助手，而会变成一套按你工作习惯持续运行的自动化系统。技能越清晰，AI 越像可靠的协作者。

第10张：好 Skill 可以沉淀工作流