凌晨2点59分,我写完了人生的第一个OpenClaw Skill。然后傻眼了——怎么让别人也用上它?
ClawHub 就是OpenClaw的「App Store」:
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/ | ⭐ 推荐 | 单元测试和集成测试 |
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
# 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 - 其他依赖...
# 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
妙趣AI开发的openclaw-skills-packager是官方推荐的打包工具:
# 安装(全局) npm install -g openclaw-skills-packager # 或者本地安装 npm install --save-dev openclaw-skills-packager # 验证安装 skills-packager --version
# 创建新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
# 进入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!
# 第一步:登录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
在你的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 }}
| 版本号 | 何时更新 | 示例 |
|---|---|---|
| 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 |
# 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 # 用户会自动收到更新通知
# CHANGELOG.md ## [1.2.0] - 2026-05-24 ### Added - 新增多语言支持(中文、日文、韩文) - 支持自定义搜索引擎权重 ### Fixed - 修复时间过滤不生效的bug - 优化大结果集的内存占用 ### Changed - 默认搜索结果从10条增加到20条
答: 完全免费!ClawHub对所有开源Skill免费托管和分发。
答: 访问 clawhub.ai/my-skills,找到你的Skill,点击「删除」。注意:删除后已安装的用户仍然可以使用,但不会再收到更新。