🛠️ OpenClaw Skill 开发入门教程

从SKILL.md到ClawHub发布,30分钟创建你的第一个AI Skill

Skill开发 SKILL.md ClawHub 入门

📌 什么是OpenClaw Skill?

OpenClaw Skill(技能)是一种模块化的AI能力扩展。通过一个SKILL.md文件,你可以告诉Agent如何执行特定任务——比如SEO优化、代码审查、内容生成、数据分析等。

🎯 类比:如果OpenClaw是操作系统,那Skill就是App。ClawHub上的71,000+ Skills就是App Store。

Skill vs MCP Server vs Plugin

类型作用技术门槛示例
Skill给Agent指令模板⭐ 极低(写Markdown)SEO优化、内容生成
MCP Server给Agent提供外部工具⭐⭐⭐ 需要编程数据库查询、API调用
Plugin扩展OpenClaw核心功能⭐⭐⭐⭐⭐ 需要深入了解飞书集成、Discord Bot

🏗️ Skill 目录结构

my-awesome-skill/
├── SKILL.md          # 核心!技能描述文件(必需)
├── README.md         # 说明文档(可选)
├── templates/        # 模板文件(可选)
│   └── output.html
├── scripts/          # 辅助脚本(可选)
│   └── process.sh
└── examples/         # 示例(可选)
    └── demo.md

最重要的文件是 SKILL.md,它是Agent理解这个Skill的唯一入口。

✍️ SKILL.md 编写指南

基本结构

# Skill Name

## 触发条件
当用户要求 [XXX] 时使用此 Skill。

## 执行步骤
1. 第一步:[做什么]
2. 第二步:[做什么]
3. 第三步:[做什么]

## 输出格式
返回 [某种格式] 的结果。

## 注意事项
- 不要做 [某事]
- 始终确保 [某条件]

实战示例:AI新闻日报Skill

# AI News Daily Report Generator

## 触发条件
当用户要求"生成新闻日报"或"AI新闻"时使用。

## 执行步骤
1. 使用 web_search 搜索以下关键词:
   - "AI news today"
   - "OpenClaw updates"
   - "AI agent breakthroughs"
2. 筛选最有价值的 5-10 条新闻
3. 为每条新闻撰写摘要(50-100字)
4. 生成 HTML 页面,包含:
   - 标题和日期
   - 新闻列表(标题+摘要+链接)
   - 妙趣风格的开场白

## 输出格式
HTML 文件,保存到 /var/www/miaoquai/news/YYYY-MM-DD.html

## 内容风格
- 开场白使用王家卫式时间感 + 周星驰式脑洞
- 语言幽默但不失专业
- 每条新闻配一个emoji

## 注意事项
- 不要编造新闻内容
- 所有链接必须真实可访问
- 更新 sitemap.xml
💡 写好SKILL.md的秘诀:
  • 触发条件要明确,避免和其他Skill冲突
  • 步骤要具体,Agent才能稳定执行
  • 输出格式要标准化,方便后续处理

🧪 本地测试 Skill

Step 1:将Skill目录放到 ~/.openclaw/skills/
cp -r my-awesome-skill ~/.openclaw/skills/
Step 2:重启OpenClaw(Skill会被自动发现)
openclaw gateway restart
Step 3:测试触发条件
# 在聊天中输入触发语句
"帮我生成今天的AI新闻日报"
Step 4:检查Agent是否正确使用了你的Skill
# 查看可用Skills
openclaw skills check

🚀 发布到 ClawHub

# 1. 确保 SKILL.md 质量过关
openclaw skills check

# 2. 发布到 ClawHub
openclaw skills publish my-awesome-skill

# 3. 查看发布状态
clawhub.ai/skills/my-awesome-skill

发布检查清单

检查项要求状态
SKILL.md必须存在且有效
触发条件明确且唯一
执行步骤清晰可执行
安全检查无恶意指令
文档完整README.md建议有

🔗 相关推荐