🚀 OpenClaw ClawHub Skills 发布教程

导读：写了好用的Skill想分享给全世界？ClawHub是OpenClaw的技能市场，让你的Skill被千万用户发现。本教程从SKILL.md开发到发布上架，一步步教你。

📋 什么是ClawHub？

ClawHub是OpenClaw的公共技能注册中心：

• 3000+ Skills - 社区贡献的丰富技能库
• 语义搜索 - 基于向量的智能搜索
• 版本管理 - semver版本控制，支持回滚
• 安全扫描 - VirusTotal集成的安全审计
• 一键安装 - openclaw skills install skill-name
• npm风格 - 类似npm的包管理体验

🔧 Skill开发

目录结构

my-awesome-skill/
├── SKILL.md           # 核心文件（必须）
├── README.md          # 说明文档
├── package.json       # 元数据（可选）
├── templates/         # 模板文件
│   └── report.html
├── scripts/           # 辅助脚本
│   └── setup.sh
└── examples/          # 使用示例
    └── example.md

SKILL.md 编写

# My Awesome Skill

## 描述
这是一个awesome的Skill，它能做awesome的事情。

## 触发条件
当用户提到"awesome"或需要做awesome的事情时使用。

## 使用方法
1. 读取配置文件
2. 执行核心逻辑
3. 输出结果

## 工具依赖
- web_search: 搜索awesome的内容
- write: 写入awesome的结果

## 示例

### 输入
"帮我做一个awesome的分析"

### 输出
生成一份awesome的分析报告...

## 最佳实践
- 先搜索再分析
- 结果要awesome
- 保持简洁

## 注意事项
- 不要滥用awesome
- 遵循安全规范

package.json 元数据

{
  "name": "my-awesome-skill",
  "version": "1.0.0",
  "description": "一个awesome的OpenClaw Skill",
  "author": "your-name",
  "license": "MIT",
  "keywords": ["awesome", "analysis", "report"],
  "openclaw": {
    "min_version": "2026.5.0",
    "tools": ["web_search", "write"],
    "category": "productivity"
  }
}

🧪 测试调试

# 本地测试Skill
openclaw skills test ./my-awesome-skill

# 在对话中测试
"使用 my-awesome-skill 帮我做一个分析"

# 查看Skill加载状态
openclaw skills list --local

# 调试模式
openclaw skills debug ./my-awesome-skill --verbose

📦 发布到ClawHub

Step 1: 注册ClawHub账号

# 登录ClawHub
openclaw clawhub login

# 或通过网页注册
# https://clawhub.ai/register

Step 2: 打包Skill

# 打包
openclaw skills pack ./my-awesome-skill

# 输出：
# ✅ Packed: my-awesome-skill-1.0.0.tgz
# Size: 12.3 KB
# Files: 5

Step 3: 发布

# 发布到ClawHub
openclaw clawhub publish ./my-awesome-skill

# 输出：
# ✅ Published: my-awesome-skill@1.0.0
# 🔗 https://clawhub.ai/skills/my-awesome-skill
# 📊 Security scan: PASSED

# 更新版本
# 修改 package.json 中的 version
openclaw clawhub publish ./my-awesome-skill

# 发布beta版本
openclaw clawhub publish ./my-awesome-skill --tag beta

💡 最佳实践

1. 小而专注 - 一个Skill做好一件事，不要大而全
2. 清晰的触发条件 - 让AI知道什么时候该用你的Skill
3. 充分的示例 - 至少3个使用示例
4. 错误处理 - 考虑各种异常情况
5. 版本管理 - 遵循semver规范

📊 发布检查清单

检查项	必须	说明
SKILL.md	✅	核心文件，必须包含
描述信息	✅	清晰的功能描述
使用示例	✅	至少1个示例
package.json	推荐	版本和元数据
README.md	推荐	详细说明文档
安全扫描	自动	ClawHub自动扫描
许可证	推荐	MIT/Apache等

🔗 相关链接