ClawHub 技能市场完全指南：发现、安装与发布你的第一个 Skill
OpenClaw 的强大之处在于其可扩展的技能生态。ClawHub 作为官方技能市场，让你像安装 App 一样发现、安装和管理各种自动化技能。本文带你全面了解 ClawHub，从技能发现到发布自己的作品。
01 为什么需要技能市场？
技能（Skill） 是 OpenClaw 的核心扩展机制。每个 Skill 都是针对特定场景的自动化解决方案——从代码生成到浏览器自动化，从媒体处理到企业集成。
没有技能市场的痛点：
ClawHub 的核心价值：
-
🔍 发现 — 海量技能，精准搜索
-
📦 安装 — 一行命令，开箱即用
-
🔄 更新 — 自动检测，无缝升级
-
🚀 发布 — 分享成果，贡献社区
02 ClawHub 简介
什么是 ClawHub？
ClawHub 是 OpenClaw 的官方技能注册中心（Registry），类似于：– npm 之于 Node.js – PyPI 之于 Python – Docker Hub 之于 Docker
它提供了一个集中化的平台，让开发者可以发布技能，让用户可以方便地发现和安装。
Registry 概念
Registry（注册中心）是 ClawHub 的底层架构概念：
┌─────────────────────────────────────────────┐
│ ClawHub Registry │
│ ┌──────────┐ ┌──────────┐ ┌──────────┐ │
│ │ Skill A │ │ Skill B │ │ Skill C │ │
│ │ v1.0.0 │ │ v2.1.0 │ │ v0.5.0 │ │
│ │ v1.1.0 │ │ v2.2.0 │ │ v1.0.0 │ │
│ └──────────┘ └──────────┘ └──────────┘ │
└─────────────────────────────────────────────┘
↑ ↓
开发者 publish 用户 install关键概念：
安装 ClawHub CLI
# 通过 npm 安装
npm install -g @openclaw/clawhub
# 验证安装
clawhub --version
# 输出: ClawHub CLI v0.8.003 实战案例 1：发现技能
搜索技能
ClawHub 支持向量搜索，可以用自然语言描述需求来查找技能：
# 基础搜索
clawhub search "postgres"
# 多关键词搜索
clawhub search "database backup"
# 描述性搜索
clawhub search "automatically download videos from websites"搜索结果示例：
┌────────────────────────────────────────────────────────────┐
│ 📦 postgres-backup │
│ 自动备份 PostgreSQL 数据库到 S3 或本地 │
│ ⭐ 4.8 | 📥 1,234 downloads | 🔧 v1.2.3 │
│ Tags: database, backup, postgres, s3 │
├────────────────────────────────────────────────────────────┤
│ 📦 postgres-migrate │
│ 数据库迁移工具，支持 schema 版本管理 │
│ ⭐ 4.5 | 📥 892 downloads | 🔧 v2.0.1 │
│ Tags: database, migration, postgres │
└────────────────────────────────────────────────────────────┘浏览最新技能
# 查看最新更新的技能
clawhub explore
# 按下载量排序
clawhub explore --sort downloads --limit 10
# 按评分排序
clawhub explore --sort rating --limit 20
# JSON 输出（适合脚本处理）clawhub explore --json排序选项：
查看技能详情
# 查看技能元数据（不安装）clawhub inspect postgres-backup
# 输出包含：# - 完整描述
# - 所有可用版本
# - 依赖关系
# - 作者信息
# - README 预览 查看已安装技能
# 列出本地已安装的技能
clawhub list
# 输出示例：# NAME VERSION INSTALLED AT
# coding-agent 1.5.2 2026-03-20
# browser-automation 2.1.0 2026-03-22
# image-gen 0.8.5 2026-03-2504 实战案例 2：安装与管理
安装技能
# 安装最新版本（推荐）clawhub install coding-agent
# 安装指定版本
clawhub install my-skill --version 1.2.3
# 强制覆盖已存在的本地修改
clawhub install coding-agent --force安装过程：
🔍 Resolving coding-agent@latest...
📦 Downloading coding-agent@1.5.2...
✅ Installed coding-agent@1.5.2 to ~/.agents/skills/coding-agent
📋 Run "cat ~/.agents/skills/coding-agent/SKILL.md" to learn usage更新技能
# 更新指定技能到最新版本
clawhub update coding-agent
# 更新到指定版本
clawhub update coding-agent --version 2.0.0
# 更新所有已安装的技能
clawhub update --all
# 强制更新（忽略本地修改）clawhub update --all --force版本控制策略：
ClawHub 使用语义化版本（SemVer）：MAJOR.MINOR.PATCH
卸载技能
# 卸载技能
clawhub uninstall coding-agent
# 卸载并清理相关数据
clawhub uninstall coding-agent --purge锁定文件
ClawHub 使用 clawhub-lock.json 记录已安装技能的精确版本：
{
"version": 1,
"skills": {
"coding-agent": {
"version": "1.5.2",
"installedAt": "2026-03-20T10:30:00Z",
"source": "registry"
},
"browser-automation": {
"version": "2.1.0",
"installedAt": "2026-03-22T14:15:00Z",
"source": "registry"
}
}
}锁定文件的作用： – 确保团队成员使用相同版本 – 支持可复现的部署 – 记录技能来源和安装时间
05 实战案例 3：发布自己的技能
技能目录结构
发布前，确保你的技能目录结构正确：
my-skill/
├── SKILL.md # 技能说明文档（必需）├── package.json # 元数据（可选）├── README.md # 详细文档（可选）├── scripts/ # 脚本文件
│ └── setup.sh
├── references/ # 参考文件
│ └── template.txt
└── icon.png # 技能图标（可选）SKILL.md 必备内容：
# my-skill
## 功能描述
简要说明这个技能能做什么。## 安装
```bash
clawhub install my-skill使用示例
# 示例命令
my-skill do something配置
说明需要的配置项。
依赖
-
依赖 1
-
依赖 2
### 发布流程
```bash
# 1. 登录 ClawHub
clawhub login
# 会打开浏览器完成 OAuth 授权
# 2. 验证登录状态
clawhub whoami
# 输出: Logged in as @yourusername
# 3. 发布技能
clawhub publish ./my-skill --slug my-skill --version 1.0.0
# 4. 添加标签
clawhub publish ./my-skill --slug my-skill --version 1.0.0 --tags "productivity,automation,latest"
# 5. 添加更新日志
clawhub publish ./my-skill --slug my-skill --version 1.0.0 --changelog "Initial release with basic features"版本规范
语义化版本（SemVer）规则：
版本格式：主版本号. 次版本号. 修订号（MAJOR.MINOR.PATCH）MAJOR：不兼容的 API 修改
MINOR：向下兼容的功能新增
PATCH：向下兼容的问题修复 发布示例：
# 初始发布
clawhub publish ./my-skill --slug my-skill --version 1.0.0
# 修复 Bug
clawhub publish ./my-skill --slug my-skill --version 1.0.1 --changelog "Fix config loading issue"
# 新增功能
clawhub publish ./my-skill --slug my-skill --version 1.1.0 --changelog "Add support for JSON output"
# 重大更新（可能破坏兼容性）clawhub publish ./my-skill --slug my-skill --version 2.0.0 --changelog "Rewrite core engine, breaking changes in config format"管理已发布技能
# 隐藏技能（暂时下架）clawhub hide my-skill
# 恢复显示
clawhub unhide my-skill
# 删除技能（软删除，管理员可恢复）clawhub delete my-skill
# 恢复删除
clawhub undelete my-skill
# 转移所有权
clawhub transfer my-skill --to @newowner收藏技能
# 收藏技能（方便以后查找）clawhub star coding-agent
# 取消收藏
clawhub unstar coding-agent06 进阶技巧
技巧 1：使用私有 Registry
企业内部可以搭建私有 Registry：
# 配置私有 Registry
export CLAWHUB_REGISTRY="https://registry.mycompany.com"
export CLAWHUB_SITE="https://clawhub.mycompany.com"
# 或者使用 .clawhubrc 文件
echo 'registry = "https://registry.mycompany.com"' > ~/.clawhubrc
# 所有命令自动使用私有 Registry
clawhub search "internal-tool"
clawhub publish ./my-skill --slug company-skill --version 1.0.0技巧 2：批量同步技能
如果你有多个技能需要管理：
# 扫描本地技能目录并批量发布
clawhub sync
# 预览将要执行的操作（不实际执行）clawhub sync --dry-run
# 自动发布所有有变更的技能
clawhub sync --auto-publish技巧 3：CI/CD 集成
在 GitHub Actions 中自动发布：
# .github/workflows/publish-skill.yml
name: Publish Skill
on:
push:
tags:
- 'v*'
jobs:
publish:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v3
- name: Setup Node.js
uses: actions/setup-node@v3
with:
node-version: '20'
- name: Install ClawHub CLI
run: npm install -g @openclaw/clawhub
- name: Publish Skill
env:
CLAWHUB_TOKEN: ${{secrets.CLAWHUB_TOKEN}}
run: |
VERSION=${GITHUB_REF#refs/tags/v}
clawhub publish ./ --slug my-skill --version $VERSION技巧 4：Fork 已有技能
基于现有技能创建自己的版本：
# 安装并 Fork
clawhub install some-skill
# 修改后发布为自己的技能
clawhub publish ./my-fork --slug my-fork --version 1.0.0 --fork-of some-skill@1.2.307 FAQ
Q1: 技能安装后在哪里？
回答： 默认安装在 ~/.agents/skills/ 目录下：
# 查看安装位置
ls ~/.agents/skills/
# 查看特定技能
cat ~/.agents/skills/coding-agent/SKILL.mdQ2: 如何查看技能的更新日志？
回答：
# 查看技能元数据
clawhub inspect coding-agent
# 或者查看本地 SKILL.md
cat ~/.agents/skills/coding-agent/SKILL.mdQ3: 安装失败怎么办？
排查步骤：
# 1. 检查网络连接
ping registry.clawhub.com
# 2. 检查 Registry 配置
echo $CLAWHUB_REGISTRY
# 3. 尝试强制安装
clawhub install my-skill --force
# 4. 清除缓存重试
rm -rf ~/.clawhub/cache
clawhub install my-skillQ4: 可以同时使用多个 Registry 吗？
回答： 可以通过环境变量切换：
# 使用官方 Registry
CLAWHUB_REGISTRY=https://registry.clawhub.com clawhub search "tool"
# 使用私有 Registry
CLAWHUB_REGISTRY=https://registry.mycompany.com clawhub search "tool"Q5: 发布的技能可以撤回吗？
回答： 可以，有几种方式：
# 隐藏技能（用户无法搜索到，但已安装的仍可用）clawhub hide my-skill
# 删除技能（软删除）clawhub delete my-skill
# 恢复
clawhub unhide my-skill
clawhub undelete my-skillQ6: 如何给技能打标签？
回答： 发布时指定 --tags：
clawhub publish ./my-skill --slug my-skill --version 1.0.0 --tags "productivity,automation,ai,latest" 常用标签：– latest – 最新稳定版 – beta – 测试版 – stable – 稳定版 – deprecated – 已弃用
Q7: 技能有依赖其他技能怎么办？
回答： 在 SKILL.md 中声明依赖：
## 依赖
- `clawhub install nodejs-runtime`
- `clawhub install common-utils`用户安装时需要手动安装依赖（未来版本会支持自动依赖解析）。
08 总结
最佳实践：
-
定期更新 — 每月运行
clawhub update --all获取最新功能和安全修复 -
锁定版本 — 生产环境建议锁定到具体版本，避免自动更新带来的不确定性
-
阅读文档 — 安装后先阅读
SKILL.md，了解技能的使用方法和配置选项 -
贡献社区 — 有好用的脚本？打包成 Skill 发布到 ClawHub，让更多人受益
下一步：
-
尝试搜索并安装几个感兴趣的技能
-
把你常用的脚本整理成 Skill 发布
-
关注 ClawHub 上的热门技能，学习优秀实践
-
加入 OpenClaw 社区，分享你的使用心得
本文是 OpenClaw 进阶技能系列第 12 篇
系列回顾： 1. OpenClaw + Codex：让 AI 帮你写代码 2. 用 OpenClaw 搭建自动化代码审查工作流 3. OpenClaw 批量生图实战：从 Prompt 到成品画廊 4. OpenClaw 语音工作流：听写、合成、通话一条龙 5. OpenClaw 浏览器自动化：解放你的重复操作 6. OpenClaw 笔记自动化：一句话记到所有平台 7. 用 OpenClaw 打造语音智能家居中枢 8. OpenClaw + 飞书：企业自动化完全指南 9. OpenClaw 媒体处理：视频、图片、GIF 全搞定 10. OpenClaw 安全运维：自动化巡检与加固 11. OpenClaw 知识库管理：构建个人 Wiki 系统 12. ClawHub 技能市场完全指南：发现、安装与发布你的第一个 Skill
#OpenClaw #ClawHub #技能市场 #自动化 #效率工具 #SkillRegistry