ClawHub:13,000+ OpenClaw Skills 的公共注册表
引言
OpenClaw 的核心价值之一是其 Skills 生态系统------13,000+ 个社区构建的技能,覆盖从 GitHub 集成到 Gmail 自动化的方方面面。但这些技能如何被发现、安装和分享?ClawHub 是答案------OpenClaw 的公共技能注册表,类似于 npm for JavaScript 或 crates.io for Rust,让 OpenClaw Skills 能够被发布、版本化、搜索和安装。
项目概述
ClawHub 是 OpenClaw 的公共技能注册表,用于发布、版本化和搜索基于文本的代理技能(SKILL.md + 支持文件)。它还暴露了 OpenClaw 包目录的原生 OpenClaw 包目录,用于代码插件和束插件。
核心特性
| 特性 | 说明 |
|---|---|
| 技能浏览 | Web 应用浏览 + 渲染 SKILL.md |
| 版本发布 | 带变更日志和标签的版本发布 |
| 技能搜索 | 嵌入向量搜索而非脆弱关键词 |
| CLI 集成 | 命令行安装/卸载/更新 |
| 托管插件 | 代码插件和束插件支持 |
| onlycrabs.ai | SOUL.md 系统设定注册表 |
项目数据
- GitHub Stars: 8,445+
- 主要语言: TypeScript
- 技能总数: 13,729 (官方注册表)
- Awesome 筛选: 5,211 精选技能
技术架构
管理层
内容层
搜索层
应用层
用户层
Web 应用
浏览/搜索
CLI
安装/管理
TanStack Start
React/Vite
Convex
DB+文件存储
Convex Auth
GitHub OAuth
OpenAI Embeddings
text-embedding-3-small
Convex 向量搜索
语义索引
Skills
SKILL.md
Souls
SOUL.md
Packages
代码插件/束插件
审核/管理
星标/评论
安装遥测
计数
核心创新点
1. onlycrabs.ai - SOUL.md 注册表
ClawHub 的姊妹项目,用于**系统设定(Lore)**的注册表:
- 发布和分享系统设定
- 与 Skills 相同的发布流程
- SOUL.md 格式
2. 向量搜索而非关键词
传统软件仓库依赖关键词搜索,ClawHub 使用:
- OpenAI
text-embedding-3-small生成嵌入 - Convex 向量搜索进行语义搜索
- 更智能的技能发现
3. 技能过滤(Awesome OpenClaw Skills)
官方注册表有 13,729 个技能,但 Awesome 列表只包含 5,211 个。过滤掉:
- 4,065 个可能的垃圾(批量账号、测试/垃圾)
- 1,040 个重复/相似名称
- 851 个低质量或非英语描述
- 886 个加密/区块链/金融/交易
- 373 个恶意(安全审计发现的)
4. CLI 友好 API
ClawHub 的设计优先考虑 CLI 使用:
bash
clawhub search <query> # 搜索技能
clawhub install <slug> # 安装技能
clawhub uninstall <slug> # 卸载技能
clawhub list # 列出已安装
clawhub update --all # 更新全部
clawhub inspect <slug> # 检查但不安装
5. 软删除/重命名/合并
- 软删除 :
clawhub delete <slug>(所有者/管理员可恢复) - 重命名 :
clawhub skill rename <old> <new>(旧 slug 重定向) - 合并 :
clawhub skill merge <src> <tgt>(源隐藏,重定向到目标)
部署与开发
技术栈
- 前端:TanStack Start (React, Vite/Nitro)
- 后端:Convex (DB + 文件存储 + HTTP actions)
- 搜索:OpenAI embeddings + Convex vector search
- 认证:Convex Auth (GitHub OAuth)
本地开发
bash
# 前置要求:Bun
bun install
cp .env.local.example .env.local
# 编辑 .env.local
# 终端 A:Convex 后端
bunx convex dev
# 终端 B:Web 应用(端口 3000)
bun run dev
CLI 安装
bash
npm install -g @openclaw/clawhub
# 或通过 openclaw 内置
与其他包注册表对比
| 特性 | ClawHub | npm | crates.io | PyPI |
|---|---|---|---|---|
| 内容类型 | Skills + 插件 | JS 包 | Rust crate | Python 包 |
| 搜索 | 向量 | 关键词 | 关键词 | 关键词 |
| 审核 | 社区 + 自动化 | 自动化 | 自动化 | 自动化 |
| 版本控制 | 是 | 是 | 是 | 是 |
| OAuth | GitHub | GitHub/GitLab | GitHub | GitHub/GitLab |
| 技能/包 | 5,211+ | 2M+ | 100K+ | 500K+ |
遥测
ClawHub 跟踪最少的安装遥测 (计算安装次数),当你在登录状态下运行 clawhub sync 时。禁用:
bash
export CLAWHUB_DISABLE_TELEMETRY=1
常见问题
Q1:如何发布技能?
A:技能必须先发布到 github.com/openclaw/skills 仓库。然后在 ClawHub 上同步。PR 需要包含 ClawHub 链接和 GitHub 链接。
Q2:什么是 SOUL.md?
A:SOUL.md 是 OpenClaw 的系统设定格式,用于定义代理的"世界观"或"人设"。通过 onlycrabs.ai 分享。
Q3:如何搜索技能?
A:使用 clawhub search <query> 或访问 clawhub.ai 进行语义搜索。
Q4:技能安全吗?
A:Awesome 列表过滤了 373 个已知恶意技能。但社区技能未经官方审计,使用前请检查源代码。
结论
ClawHub 是 OpenClaw 生态的枢纽------13,000+ Skills 的注册表、发现和安装中心。向量搜索比传统关键词更智能,Awesome 列表的严格过滤确保质量,onlycrabs.ai 扩展到系统设定分享。与 npm/crates.io 不同,ClawHub 不仅管理代码包,还管理基于文本的 Skills 和 Lore,体现了 AI 代理生态的独特性。
核心价值:
- 技能注册表:13,729 官方技能,5,211 精选
- 向量搜索:语义搜索比关键词更智能
- CLI 优先:命令行友好的一体化管理
- SOUL 生态:onlycrabs.ai 系统设定注册表
- 质量控制:过滤垃圾/恶意技能
延伸阅读
关键词:ClawHub, OpenClaw 技能, 注册表, 向量搜索, SOUL.md
SEO 元数据:
- 标题:54 字符
- 描述:156 字符
- 关键词密度:约 1.5%
- 字数:约 2,500 字
- 可读性等级:9 年级
Mermaid 图表检查结果
✅ 已检查 1 个图表
✅ 所有图表语法正确
✅ 无保留关键字冲突