OpenClaw Skill完全指南小龙虾“技能”从入门到精通

OpenClaw的Skill（技能）是一种模块化扩展包，为AI助手添加特定领域的专业知识、工作流和工具。你可以把Skill理解为：领域专家的知识库（让AI掌握某个特定领域的专业知识）、可复用的工具箱（包含脚本、模板、参考资料等资源）、结构化的工作指南（指导AI如何完成特定类型的任务）。Skill把“程序性知识”封装起来，让AI变成一个“熟练掌握特定技能的专家”。

一、为什么需要Skill

默认情况下，OpenClaw使用的AI模型拥有通用知识，但缺乏具体的操作流程（比如“如何旋转PDF”）、缺乏专业工具的使用方法（比如curl命令、API调用方式）、缺乏领域特定的最佳实践（比如安全审计步骤、代码审查清单）。Skill把这些问题都解决了。

二、Skill的工作原理

当你问OpenClaw“今天北京天气怎么样？”时，背后发生的事情：第一步，OpenClaw读取所有已安装Skill的description字段，找到天气相关的Skill；第二步，将该Skill的SKILL.md内容加载到AI的上下文；第三步，AI根据Skill中的指导，使用正确的工具获取天气；第四步，AI用自然语言告诉你结果。如果没有Skill，AI只能靠猜测回答；有了Skill，AI知道确切的数据来源和查询格式，结果可靠。

三、Skill的目录结构

skill-name/ ├── SKILL.md                 # 必需：技能定义和说明（YAML frontmatter + Markdown正文） ├── scripts/                 # 可选：可执行代码（Python脚本、Shell脚本等） ├── references/              # 可选：参考资料（按需加载的API文档、schema等） └── assets/                  # 可选：输出资源（模板、图片等，不加载到上下文）

SKILL.md是每个Skill必须包含的核心文件，分为两部分：YAML Frontmatter（元数据头）和Markdown正文。

四、SKILL.md结构详解

1. YAML Frontmatter

— name: weather description: “获取当前天气状况及预报” metadata:   openclaw:     emoji: “☔”     requires:       bins: [“curl”] —

name：Skill的名称。 description：非常重要！OpenClaw根据这个判断何时使用该Skill，应包含Skill能做什么、什么情况下使用、什么情况下不用。metadata：额外配置，如UI图标、依赖的命令行工具。

2. Markdown正文

在Skill被触发后才加载到AI上下文中，包含：何时使用（明确的使用场景和触发短语）、命令和工具（具体的操作步骤、命令、代码示例）、配置说明（环境变量、配置文件等）、常见问题（故障排除、注意事项）、参考资料链接（指向references/中的详细文档）。

五、创建Skill的流程

Step 1：理解应用场景。先明确技能的具体用途——用户会问什么问题？需要完成什么类型的任务？有哪些变体和边界情况？Step 2：规划资源内容。分析需要哪些可复用资源。Step 3：初始化Skill（使用工具）。OpenClaw提供了init_skill.py脚本自动生成模板目录。它会自动创建正确的目录结构、带frontmatter的SKILL.md模板、资源目录和示例文件。Step 4：编辑Skill。修改SKILL.md的Frontmatter——description要具体、说明用途、触发条件、不适用场景；编写Body——明确使用场景，提供操作指南，包含代码示例，链接参考资料。Step 5：打包Skill。运行打包脚本scripts/package_skill.py，会自动验证Skill（检查frontmatter、命名、结构、描述质量）并创建.skill文件（zip压缩包）。

六、如何安装和使用Skill

从ClawHub安装：openclaw skills search weather（搜索）、openclaw skills info weather（查看详情）、openclaw skills install weather（安装）。手动安装：下载.skill文件后运行openclaw skills install ./skills/my-skill.skill。查看已安装的Skill：openclaw skills list列出所有，openclaw skills info weather查看详情。Skill安装后OpenClaw自动调用，无需手动启用。当用户消息匹配Skill的description时，OpenClaw会自动加载Skill的元数据、确定是否触发、加载SKILL.md body、必要时加载references文件，然后AI根据Skill指导完成任务。卸载：openclaw skills uninstall weather。更新：openclaw skills outdated检查更新，openclaw skills update –all更新所有，openclaw skills update weather更新特定Skill。

🔗 多Skill协同与优先级多个Skill可以协同工作。例如：“帮我分析上月销售数据的PDF报告”会触发pdf-extractor提取文本→bigquery查询销售数据→data-viz生成图表→report-builder组装成新PDF。可以在description中互相引用，如“requires skill:pdf-extractor for OCR”。如果多个Skill都可能触发，OpenClaw会选择语义匹配度最高的；如果平局，使用较具体的描述（更长的description优先）。

七、最佳实践Tips

description要具体，不要写“很有用的工具”，要写“用于旋转PDF、合并文档、提取文本”。使用祈使句编写Body，简洁明了，优先展示代码示例而非大段描述。定期用openclaw skills outdated检查Skill更新，保持最新功能和修复。如果你发现某个使用场景反复手动操作，就值得为它写一个Skill。Skill是OpenClaw的核心能力——用好它，小龙虾才能真正变成你的领域专家。

点击在看，分享给更多养虾人。