clawhub

ClawHub 是一个为开源代理框架 OpenClaw 专门构建的公共注册表和分发平台。它服务两个主要目录：基于文本的代理技能（一个 SKILL.md 文件加上支持文件）和原生 OpenClaw 包（代码插件、捆绑插件和完整代理 Claw 包）。 关键能力： - 技能生命周期：浏览技能并渲染其 SKILL.md 文档；发布带有变更日志和标签（包括移动的 `latest` 标签）的新技能版本；在不破坏旧链接或安装的情况下重命名拥有的技能；将重复拥有的技能合并为一个规范标识符。 - 搜索：由 OpenAI 嵌入（text-embedding-3-small）驱动的向量搜索，而非脆弱的精确匹配，因此技能可按语义相似性发现。 - 社交和治理：对技能加星和评论；版主和管理员可策划、批准和管理列表。软删除和恢复流程允许所有者、发布者所有者、管理员和版主移除或恢复技能，而不会造成永久数据丢失。硬删除仅限管理员。 - 本地安装管理：从命令行界面安装、检查、列出、更新和卸载技能。固定本地安装，以便更新和强制重新安装无法覆盖冻结副本。 - 包目录：浏览带有家族、信任和能力元数据的 OpenClaw 包。通过专门的 /packages API 和 CLI 流程发布原生代码插件和捆绑包。代码插件清单必须声明 openclaw.compat.pluginApi 和 openclaw.build.openclawVersion。 - Nix 插件支持：技能可在 SKILL 前置数据中声明 nix-clawdbot 插件指针，以便注册表知道要安装哪个 Nix 包捆绑包，包括配置要求、状态目录和 CLI 帮助文本。 - 元数据和安全性：技能在前置数据中声明运行时要求（环境变量、二进制文件、安装规范）。ClawHub 的安全分析对照实际技能行为检查这些声明；中等审查发现保持可见，而可疑过滤器保留给高影响或恶意问题。 - 最小遥测：安装遥测仅用于计算安装次数，可通过 CLAWHUB_DISABLE_TELEMETRY 禁用。 架构：Web 应用使用 TanStack Start（React、Vite/Nitro）构建。后端在 Convex（数据库、文件存储和 HTTP 操作）上运行，并配合 Convex Auth 进行 GitHub OAuth 身份验证。共享 API 模式和路由位于 packages/schema（clawhub-schema）中，CLI 和 Web 应用均消费这些内容。 仓库布局：src/ 持有 TanStack Start 应用；convex/ 持有模式、查询、变更、操作和 HTTP API 路由；packages/schema/ 包含共享 API 类型；docs/ 发布用户、发布者、API 客户端和操作员文档；specs/ 包含产品规范、计划的设计历史。