OpenClaw Skills 完全指南：让你的 AI 助手拥有超能力

作者：CSDN博客
目录

OpenClaw Skills 完全指南：让你的 AI 助手拥有超能力

什么是 Skills？Skills 的三大来源Skills 的基本结构

常用 Frontmatter 字段

门控机制：按条件加载 Skills

支持的门控条件

配置覆盖创建你的第一个 Skill

1. 创建目录2. 创建 SKILL.md3. 刷新 OpenClaw

ClawHub：Skills 市场安全注意事项总结

OpenClaw Skills 完全指南：让你的 AI 助手拥有超能力

你是否想过让你的 AI 助手拥有更多能力？比如自动查询天气、操作飞书文档、控制智能家居？OpenClaw 的 Skills 系统正是为此而生！本文将带你全面了解 Skills 是什么、如何使用、以及如何创建自己的 Skills。
什么是 Skills？

Skills 是 OpenClaw 使用的一种技能扩展机制，它教会 AI 智能体如何使用各种工具。每个 Skill 是一个包含 SKILL.md 文件的目录，这个文件使用 YAML frontmatter 作为元数据，Markdown 作为指令。
简单来说，Skills = AI 的技能包。
通过 Skills，你可以：

让 AI 学会使用特定的 API 或工具为特定任务提供专门的指导分享你的技能给社区其他用户

Skills 的三大来源

OpenClaw 从三个位置加载 Skills：

位置	路径	优先级	说明
工作区 Skills	<workspace>/skills	最高	当前工作区专属
托管/本地 Skills	~/.openclaw/skills	中等	所有智能体共享
内置 Skills	随安装包发布	最低	OpenClaw 自带

优先级规则：如果同名 Skills 存在于多个位置，工作区 > 托管/本地 > 内置。
Skills 的基本结构

一个最小的 SKILL.md 文件只需要：

1. ---
2. name: hello-world
3. description: A simple skill that says hello
4. ---
6. # Hello World Skill
8. When the user asks for a greeting, say "Hello from your custom skill!"

复制代码

常用 Frontmatter 字段

name：Skills 名称（必填）description：Skills 描述（必填）homepage：主页 URLuser-invocable：是否可作为斜杠命令使用（默认 true）metadata：额外的元数据配置

门控机制：按条件加载 Skills

OpenClaw 支持条件加载，只有在满足条件时才启用某个 Skill。

1. ---
2. name: gemini
3. description: Use Gemini CLI for coding assistance
4. metadata:
5.   { "openclaw": { "requires": { "bins": ["gemini"], "env": ["GEMINI_API_KEY"] } } }
6. ---

复制代码

支持的门控条件

bins：需要存在的命令行工具env：需要设置的环境变量config：需要在配置中启用的选项os：支持的操作系统（darwin/linux/win32）

配置覆盖

你可以在 ~/.openclaw/openclaw.json 中配置 Skills：

1. {"skills":{"entries":{"hello-world":{"enabled":true,"env":{"API_KEY":"your-api-key"}}}}}

复制代码

创建你的第一个 Skill

1. 创建目录

1. mkdir-p ~/.openclaw/workspace/skills/my-first-skill

复制代码

2. 创建 SKILL.md

1. ---
2. name: my-first-skill
3. description: My first OpenClaw skill
4. ---
6. # My First Skill
8. When the user asks for help, follow these steps.

复制代码

3. 刷新 OpenClaw

重启 Gateway 或在对话中让智能体刷新 skills。
ClawHub：Skills 市场

想要发现更多 Skills？访问 ClawHub！
ClawHub 是 OpenClaw 的公共 Skills 注册表，你可以：

浏览社区贡献的 Skills安装其他开发者分享的 Skills发布你自己的 Skills

常用命令：

1. clawhub install<skill-slug>
2. clawhub update --all

复制代码

安全注意事项

将第三方 Skills 视为不受信任的代码，启用前请阅读内容对于不受信任的输入和高风险工具，优先使用沙箱隔离敏感信息应通过配置注入，而不是写在 SKILL.md 中

总结

Skills 是 OpenClaw 的核心扩展机制，让你可以：

扩展能力 - 为 AI 助手添加新技能智能加载 - 根据条件自动激活社区分享 - 在 ClawHub 分享和发现新 Skills

现在就试试创建你的第一个 Skill 吧！

---

参考资料：

OpenClaw 官方文档ClawHub Skills 市场

原文地址：https://blog.csdn.net/weixin_42681866/article/details/158811785