OpenClaw 的 Skills 系统是其最强大的扩展机制之一。通过 Skills，你可以为 AI Agent 增加新能力——从调用外部 API 到控制本地工具，从图像生成到代码执行。
什么是 Skills？
OpenClaw 使用兼容 AgentSkills 规范的 Skill 目录来教 Agent 如何使用工具。每个 Skill 是一个包含 SKILL.md 文件的目录，SKILL.md 里有 YAML frontmatter 和使用说明。
OpenClaw 会加载内置 Skills 并叠加你的本地自定义 Skills。
Skills 加载位置与优先级
Skills 从三个地方加载（优先级从高到低）：
- 工作区 Skills：
<workspace>/skills（最高优先级） - 托管/本地 Skills：
~/.openclaw/skills - 内置 Skills：随安装包附带（最低优先级）
同名 Skill 时，高优先级的会覆盖低优先级的。
多 Agent 场景下的 Skills
在多 Agent 架构中，每个 Agent 有自己的工作区，因此：
- Agent 专属 Skills：存放在该 Agent 的
<workspace>/skills，只对该 Agent 可见 - 共享 Skills：存放在
~/.openclaw/skills，对同机器上的所有 Agent 可见 - 也可以通过
skills.load.extraDirs配置额外共享目录
ClawHub：Skills 公共仓库
ClawHub 是 OpenClaw 的公共 Skills 注册表，你可以在这里发现、安装、更新 Skills。
bash
# 安装一个 Skill
clawhub install <skill-slug>
# 更新所有已安装的 Skills
clawhub update --all
# 同步（扫描并发布更新）
clawhub sync --allSKILL.md 格式
每个 SKILL.md 至少需要包含：
markdown
---
name: my-skill-name
description: 这个 Skill 的功能描述
---
（技能使用说明和指令）可选的 frontmatter 字段：
homepage：技能官网 URLuser-invocable：是否作为用户斜杠命令暴露（默认true）disable-model-invocation：是否从模型提示中排除（默认false）command-dispatch：设为tool时，斜杠命令直接派发到工具，跳过模型
Skill 门控（按条件加载）
通过 metadata 字段实现条件加载：
markdown
---
name: gemini-skill
description: 使用 Gemini CLI 进行编程辅助
metadata:
{
"openclaw":
{
"requires": { "bins": ["gemini"], "env": ["GEMINI_API_KEY"] },
"primaryEnv": "GEMINI_API_KEY",
},
}
---metadata.openclaw.requires 支持的条件：
| 字段 | 说明 |
|---|---|
bins | PATH 中必须存在的命令 |
anyBins | 至少存在其中一个命令 |
env | 必须存在的环境变量 |
config | openclaw.json 中必须为真的配置路径 |
配置文件中启用/禁用 Skills
在 ~/.openclaw/openclaw.json 中管理 Skills：
json
{
"skills": {
"entries": {
"gemini-skill": {
"enabled": true,
"apiKey": "your-api-key",
"env": {
"GEMINI_API_KEY": "your-key-here"
}
},
"some-other-skill": { "enabled": false }
}
}
}Skills 自动热加载
默认情况下，OpenClaw 监听 Skill 目录变化，SKILL.md 文件修改后自动刷新 Skills 列表：
json
{
"skills": {
"load": {
"watch": true,
"watchDebounceMs": 250
}
}
}Token 消耗影响
Skills 注入到系统提示中的 Token 成本是确定性的：
- 基础开销（有至少 1 个 Skill 时）：195 字符
- 每个 Skill：97 字符 + name/description/location 字段长度
计算公式：
total = 195 + Σ (97 + len(name) + len(description) + len(location))
安全注意事项
- 将第三方 Skills 视为不可信代码，启用前务必仔细阅读
- 对不可信输入和高风险工具，优先使用沙箱运行
skills.entries.*.env和skills.entries.*.apiKey会将密钥注入到主机进程，注意保密
原文：Skills - OpenClaw | 来源：OpenClaw 官方文档