📦 OpenClaw Skills打包发布到ClawHub教程

📅 更新:2026-05-24 | ⏱️ 阅读时间:12分钟 | 🏷️ 标签:OpenClaw Skills, ClawHub发布, Skill打包, Skills开发

📋 目录

1. 为什么发布到ClawHub?

凌晨2点59分,我写完了人生的第一个OpenClaw Skill。然后傻眼了——怎么让别人也用上它?

ClawHub 就是OpenClaw的「App Store」:

💡 一句话: 发布到ClawHub,让你的Skill从「个人玩具」变成「全球工具」。

2. Skills Packaging Standard

2026年5月20日,OpenClaw #144讨论确立了Skills Packaging Standard——从「能用」到「好用」的标准化规范。

规范项 要求 说明
SKILL.md ✅ 必须 包含name、description、usage、features
README.md ✅ 推荐 详细文档、示例、配置说明
package.json ✅ 必须 版本、依赖、入口文件
icon.png ⭐ 推荐 512x512px,PNG格式
LICENSE ✅ 必须 MIT / Apache 2.0 推荐
tests/ ⭐ 推荐 单元测试和集成测试

3. Skill目录结构

my-awesome-skill/
├── SKILL.md              # ❗ 必须:Skill描述文件
├── README.md             # 详细文档
├── package.json          # 包信息
├── LICENSE               # 开源协议
├── icon.png              # Skill图标(可选)
├── index.js              # 主逻辑文件
├── lib/                  # 依赖库
│   ├── utils.js
│   └── api.js
├── templates/            # 模板文件
│   └── default.md
└── tests/                # 测试文件
    ├── unit.test.js
    └── integration.test.js

4. SKILL.md编写规范

⚠️ SKILL.md是必须文件! 它决定了你的Skill在ClawHub上如何展示。
# my-awesome-skill

> 一句话描述你的Skill(用>引用的形式)

## Description
详细描述你的Skill做什么,解决什么问题,适合什么场景。
至少写3-5句话,包含使用场景和核心优势。

## Usage
- "具体的命令示例1"
- "具体的命令示例2"  
- "具体的命令示例3"

## Features
- ✅ 功能点1:具体描述
- ✅ 功能点2:具体描述
- ✅ 功能点3:具体描述

## Installation (可选)
如果需要额外的安装步骤,在这里说明。

## Configuration (可选)
如果有配置项,在这里列出并说明。

## Examples (可选)
提供1-2个完整的使用示例。

## Requirements (可选)
- OpenClaw >= v2026.1.0
- Node.js >= 18
- 其他依赖...

4.1 好的SKILL.md示例

# web-search-plus

> 增强版网页搜索Skill,支持多引擎、结果过滤、自动摘要

## Description
web-search-plus是对OpenClaw内置web_search工具的增强替代。
它支持同时查询Google、Bing、DuckDuckGo等多个搜索引擎,
自动去重并生成摘要。适合需要全面信息收集的场景。

## Usage
- "Search for 'OpenClaw tutorial' using multiple engines"
- "Find the latest news about AI agents"
- "Compare prices for GPT-5 API"

## Features
- ✅ 多引擎并发搜索(Google/Bing/DDG)
- ✅ 智能去重和结果排序
- ✅ AI自动生成摘要
- ✅ 支持时间过滤(最近24h/一周/一月)
- ✅ 结果导出为Markdown/CSV

5. 使用openclaw-skills-packager打包

妙趣AI开发的openclaw-skills-packager是官方推荐的打包工具:

5.1 安装打包工具

# 安装(全局)
npm install -g openclaw-skills-packager

# 或者本地安装
npm install --save-dev openclaw-skills-packager

# 验证安装
skills-packager --version

5.2 初始化新Skill

# 创建新Skill脚手架
skills-packager init my-new-skill

# 按提示填写信息:
# - Skill名称: my-new-skill
# - 描述: 一句话描述
# - 作者: 你的名字
# - License: MIT (默认)

# 生成后的目录结构:
my-new-skill/
├── SKILL.md
├── package.json
├── README.md
├── LICENSE
└── index.js

5.3 打包Skill

# 进入Skill目录
cd my-awesome-skill

# 打包(生成 .skill 文件)
skills-packager pack

# 输出:
# ✅ Skill packaged successfully: my-awesome-skill-v1.0.0.skill
# 📦 Package size: 12.5 KB
# 📝 Files included: 15

# 验证打包文件
skills-packager validate my-awesome-skill-v1.0.0.skill
# ✅ Package is valid!

6. 发布到ClawHub

6.1 方法一:通过ClawHub网站发布

  1. 访问 clawhub.ai/publish
  2. 登录你的GitHub账号
  3. 上传 .skill 文件
  4. 填写详细信息(分类、标签、截图)
  5. 点击「发布」

6.2 方法二:通过命令行发布

# 第一步:登录ClawHub
skills-packager login
# 会打开浏览器授权,或输入API Token

# 第二步:发布
skills-packager publish my-awesome-skill-v1.0.0.skill

# 输出:
# ✅ Publishing to ClawHub...
# ✅ Published successfully!
# 🔗 View your Skill: https://clawhub.ai/skills/my-awesome-skill
# 📊 Installation command: clawhub install my-awesome-skill

6.3 方法三:通过GitHub Actions自动发布

在你的Skill仓库中添加 .github/workflows/publish.yml

name: Publish to ClawHub

on:
  release:
    types: [published]

jobs:
  publish:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v3
      - uses: actions/setup-node@v3
        with:
          node-version: '18'
      - run: npm install -g openclaw-skills-packager
      - run: skills-packager pack
      - run: skills-packager publish *.skill
        env:
          CLAWHUB_TOKEN: ${{ secrets.CLAWHUB_TOKEN }}

7. 版本管理

7.1 语义化版本

版本号 何时更新 示例
MAJOR (X.0.0) 不兼容的API变更 1.0.0 → 2.0.0
MINOR (0.X.0) 新增功能(向后兼容) 1.1.0 → 1.2.0
PATCH (0.0.X) Bug修复(向后兼容) 1.0.1 → 1.0.2

7.2 更新已发布的Skill

# 1. 更新代码
vim index.js

# 2. 更新版本号(package.json)
# "version": "1.0.0" → "version": "1.0.1"

# 3. 重新打包
skills-packager pack

# 4. 发布新版本
skills-packager publish my-awesome-skill-v1.0.1.skill

# 用户会自动收到更新通知

7.3 Changelog最佳实践

# CHANGELOG.md
## [1.2.0] - 2026-05-24
### Added
- 新增多语言支持(中文、日文、韩文)
- 支持自定义搜索引擎权重

### Fixed
- 修复时间过滤不生效的bug
- 优化大结果集的内存占用

### Changed
- 默认搜索结果从10条增加到20条

8. 常见问题

Q1: 发布到ClawHub需要付费吗?

答: 完全免费!ClawHub对所有开源Skill免费托管和分发。

Q2: 我的Skill被拒绝怎么办?

常见拒绝原因: 检查邮件中的拒绝原因,修复后重新提交。

Q3: 如何提升Skill的下载量?

💡 提升技巧:

Q4: 如何删除已发布的Skill?

答: 访问 clawhub.ai/my-skills,找到你的Skill,点击「删除」。注意:删除后已安装的用户仍然可以使用,但不会再收到更新。

🎯 总结: 发布Skill到ClawHub就像开了一家「AI工具店」——SKILL.md是门面,打包是货架,发布是开门营业。就像王家卫电影里那些精心布置的场景,每个细节都在诉说着品质。别让你的好Skill只躺在本地文件夹里吃灰。

🔗 相关资源


🦞 妙趣AI - 让AI工具变得有趣又实用 | 返回首页 | 更多教程