什么是 Skill?
Skill 是 OpenClaw 的核心扩展机制,它本质上是一个包含 SKILL.md 文件的文件夹。
Skill 的核心结构
my-skill/
├── SKILL.md # 必需:技能说明文件
├── scripts/ # 可选:脚本文件
├── config/ # 可选:配置文件
└── README.md # 可选:详细文档
SKILL.md 的基本格式
---
name: my-skill
description: 这是一个示例技能
---
# 技能说明
在这里描述技能的功能、使用方法和注意事项。
Skill 的加载位置与优先级
OpenClaw 从三个位置加载 Skill,优先级从高到低:
| 位置 | 路径 | 说明 |
|---|---|---|
| Workspace Skills | /skills | 当前工作区的技能(优先级最高) |
| Managed Skills | ~/.openclaw/skills | 本地管理的技能 |
| Bundled Skills | 安装包内置 | OpenClaw 自带的技能(优先级最低) |
冲突处理:如果同名 Skill 存在,优先级高的会覆盖低的。
多 Agent 场景下的技能共享
- Per-agent skills:/skills(仅该 Agent 可见)
- Shared skills:~/.openclaw/skills(所有 Agent 共享)
创建和配置 Skill
第一步:创建你的第一个 Skill
- 创建技能目录
# 进入工作区的 skills 目录
cd ~/.openclaw/workspace/skills
# 创建新技能文件夹
mkdir my-first-skill
cd my-first-skill
- 编写 SKILL.md
cat > SKILL.md <<'EOF'
---
name: my-first-skill
description: 我的第一个 OpenClaw 技能,用于演示 Skill 的基本结构
---
# 我的第一个 Skill
## 功能介绍
这是一个示例技能,用于展示 OpenClaw Skill 的基本结构和使用方法。
## 使用场景
当用户提到"我的第一个技能"或相关关键词时,激活此技能。
## 使用方法
1. 确认技能已正确加载
2. 根据用户需求执行相应操作
3. 返回结果给用户
- 这是示例技能,实际使用时需要根据需求修改
- 确保文件编码为 UTF-8
EOF


