#17 OpenClaw 自定义 Skill 开发入门

想让 OpenClaw Agent 学会新技能？Skill（技能）系统让你可以轻松扩展 Agent 的能力，从简单的脚本到复杂的自动化流程，都可以封装成 Skill。

什么是 Skill？

Skill 是 OpenClaw 的能力扩展机制。每个 Skill 是一个独立的文件夹，包含：

• SKILL.md：技能的说明文档，定义触发条件和使用方法
• scripts/：可选的脚本目录，存放自动化脚本
• references/：可选的参考文件目录

当 Agent 收到相关请求时，会自动读取 SKILL.md 并按照指引执行。

Skill 目录结构

一个标准的 Skill 目录结构如下：

my-skill/
├── SKILL.md （必填：技能说明）
├── scripts/ （可选：脚本文件）
│ └── run.sh
└── references/ （可选：参考文件）
└── api-docs.md

SKILL.md 是核心文件，Agent 通过它了解这个技能能做什么、什么时候触发、怎么执行。

SKILL.md 编写规范

SKILL.md 需要包含以下关键信息：

1. 技能名称和描述：告诉 Agent 这个技能是什么

2. 触发条件：什么情况下应该激活这个技能。例如"当用户问天气时"或"当需要生成封面图时"

3. 执行步骤：详细的执行流程，包括需要运行的命令、读取的文件、调用的 API 等

4. 注意事项：安全提示、限制条件、常见错误等

实战示例：天气查询 Skill

让我们创建一个简单的天气查询 Skill：

1. 创建目录：skills/weather/
2. 编写 SKILL.md，描述技能功能
3. 定义触发条件："当用户问天气、温度、天气预报时"
4. 编写执行步骤：使用 wttr.in API 获取天气数据
5. 测试：对 Agent 说"今天杭州天气怎么样"

Agent 会自动识别触发条件，读取 SKILL.md，执行天气查询并返回结果。

发布到 ClawHub

开发完成后，你可以将 Skill 发布到 ClawHub 社区，让其他用户也能使用：

• 使用 clawhub publish 命令发布
• 填写技能描述和版本号
• 其他用户通过 clawhub install 安装你的技能

ClawHub 上已经有 100+ 社区技能可供安装使用，涵盖天气、翻译、GitHub、Notion 等各种场景。

开发技巧

• 保持 SKILL.md 简洁明了，Agent 靠它理解技能
• 触发条件要具体，避免和其他 Skill 冲突
• 脚本要有错误处理，失败时给出清晰的错误信息
• 先在本地测试，确认无误再发布

总结

Skill 系统是 OpenClaw 最强大的扩展机制。一个写得好的 SKILL.md，就是给 Agent 的一份精准操作手册。开始创建你的第一个 Skill 吧 🛠️