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 文件只需要：

---
name: hello-world
description: A simple skill that says hello
---

# Hello World Skill

When the user asks for a greeting, say "Hello from your custom skill!"

常用 Frontmatter 字段

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

门控机制：按条件加载 Skills

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

---
name: gemini
description: Use Gemini CLI for coding assistance
metadata:
  { "openclaw": { "requires": { "bins": ["gemini"], "env": ["GEMINI_API_KEY"] } } }
---

支持的门控条件

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

配置覆盖

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

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

创建你的第一个 Skill

1. 创建目录

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

2. 创建 SKILL.md

---
name: my-first-skill
description: My first OpenClaw skill
---

# My First Skill

When the user asks for help, follow these steps.

3. 刷新 OpenClaw

重启 Gateway 或在对话中让智能体刷新 skills。

ClawHub：Skills 市场

想要发现更多 Skills？访问 ClawHub！

ClawHub 是 OpenClaw 的公共 Skills 注册表，你可以：

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

常用命令：

clawhub install <skill-slug>
clawhub update --all

安全注意事项

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

总结

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

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

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

---

参考资料：

• OpenClaw 官方文档
• ClawHub Skills 市场