[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"tool-openclaw--clawhub":3,"similar-openclaw--clawhub":69},{"id":4,"github_repo":5,"name":6,"description_en":7,"description_zh":8,"ai_summary_zh":9,"readme_en":10,"readme_zh":11,"quickstart_zh":12,"use_case_zh":13,"hero_image_url":14,"owner_login":15,"owner_name":15,"owner_avatar_url":16,"owner_bio":17,"owner_company":18,"owner_location":18,"owner_email":19,"owner_twitter":15,"owner_website":20,"owner_url":21,"languages":22,"stars":39,"forks":40,"last_commit_at":41,"license":42,"difficulty_score":43,"env_os":44,"env_gpu":44,"env_ram":44,"env_deps":45,"category_tags":52,"github_topics":55,"view_count":58,"oss_zip_url":18,"oss_zip_packed_at":18,"status":59,"created_at":60,"updated_at":61,"faqs":62,"releases":63},5173,"openclaw\u002Fclawhub","clawhub","Skill Directory for OpenClaw","ClawHub 是专为 OpenClaw 生态打造的公开技能与插件注册中心。它让开发者能够轻松发布、版本化管理并检索基于文本的 AI 智能体技能（SKILL.md）、系统设定（SOUL.md）以及代码插件包。\n\n这一工具主要解决了 AI 智能体资源分散、难以统一管理和高效复用的痛点。通过 ClawHub，用户不再需要手动整理零散的脚本或文档，而是拥有一个集中化的“应用商店”，支持对技能进行重命名、合并去重及变更追踪，确保资源引用的稳定性。同时，其配套的 onlycrabs.ai 子站专门用于共享智能体的核心系统设定，进一步完善了生态协作链条。\n\nClawHub 特别适合 AI 智能体开发者、开源贡献者以及希望快速构建自定义 Agent 的技术人员使用。它不仅提供友好的网页浏览体验，还配备了功能强大的命令行工具（CLI），支持一键登录、搜索、安装、发布及同步更新，极大提升了工作流效率。\n\n在技术亮点方面，ClawHub 摒弃了传统的关键词匹配，采用 OpenAI 嵌入模型结合向量搜索技术，让用户能通过语义理解精准找到所需技能。此外，项目基于 Convex 后端构建，集成了 GitHub ","ClawHub 是专为 OpenClaw 生态打造的公开技能与插件注册中心。它让开发者能够轻松发布、版本化管理并检索基于文本的 AI 智能体技能（SKILL.md）、系统设定（SOUL.md）以及代码插件包。\n\n这一工具主要解决了 AI 智能体资源分散、难以统一管理和高效复用的痛点。通过 ClawHub，用户不再需要手动整理零散的脚本或文档，而是拥有一个集中化的“应用商店”，支持对技能进行重命名、合并去重及变更追踪，确保资源引用的稳定性。同时，其配套的 onlycrabs.ai 子站专门用于共享智能体的核心系统设定，进一步完善了生态协作链条。\n\nClawHub 特别适合 AI 智能体开发者、开源贡献者以及希望快速构建自定义 Agent 的技术人员使用。它不仅提供友好的网页浏览体验，还配备了功能强大的命令行工具（CLI），支持一键登录、搜索、安装、发布及同步更新，极大提升了工作流效率。\n\n在技术亮点方面，ClawHub 摒弃了传统的关键词匹配，采用 OpenAI 嵌入模型结合向量搜索技术，让用户能通过语义理解精准找到所需技能。此外，项目基于 Convex 后端构建，集成了 GitHub 认证、自动化审核机制及细粒度的权限管理（如软删除恢复、别名重定向），既保证了社区内容的质量，又兼顾了数据的安全与灵活维护。","\u003Cp align=\"center\">\n  \u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fopenclaw_clawhub_readme_ee5759de0bab.png\" alt=\"ClawHub\" width=\"120\">\n\u003C\u002Fp>\n\n\u003Ch1 align=\"center\">ClawHub\u003C\u002Fh1>\n\n\u003Cp align=\"center\">\n  \u003Ca href=\"https:\u002F\u002Fgithub.com\u002Fopenclaw\u002Fclawhub\u002Factions\u002Fworkflows\u002Fci.yml?branch=main\">\u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Factions\u002Fworkflow\u002Fstatus\u002Fopenclaw\u002Fclawhub\u002Fci.yml?branch=main&style=for-the-badge\" alt=\"CI status\">\u003C\u002Fa>\n  \u003Ca href=\"https:\u002F\u002Fdiscord.gg\u002Fclawd\">\u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fdiscord\u002F1456350064065904867?label=Discord&logo=discord&logoColor=white&color=5865F2&style=for-the-badge\" alt=\"Discord\">\u003C\u002Fa>\n  \u003Ca href=\"LICENSE\">\u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FLicense-MIT-blue.svg?style=for-the-badge\" alt=\"MIT License\">\u003C\u002Fa>\n\u003C\u002Fp>\n\nClawHub is the **public skill registry for Clawdbot**: publish, version, and search text-based agent skills (a `SKILL.md` plus supporting files).\nIt's designed for fast browsing + a CLI-friendly API, with moderation hooks and vector search.\nIt also now exposes a native **OpenClaw package catalog** for code plugins and bundle plugins.\n\nonlycrabs.ai is the **SOUL.md registry**: publish and share system lore the same way you publish skills.\n\n\u003Cp align=\"center\">\n  \u003Ca href=\"https:\u002F\u002Fclawhub.ai\">ClawHub\u003C\u002Fa> ·\n  \u003Ca href=\"https:\u002F\u002Fonlycrabs.ai\">onlycrabs.ai\u003C\u002Fa> ·\n  \u003Ca href=\"VISION.md\">Vision\u003C\u002Fa> ·\n  \u003Ca href=\"docs\u002FREADME.md\">Docs\u003C\u002Fa> ·\n  \u003Ca href=\"CONTRIBUTING.md\">Contributing\u003C\u002Fa> ·\n  \u003Ca href=\"https:\u002F\u002Fdiscord.gg\u002Fclawd\">Discord\u003C\u002Fa>\n\u003C\u002Fp>\n\n## What you can do with it\n\n- Browse skills + render their `SKILL.md`.\n- Publish new skill versions with changelogs + tags (including `latest`).\n- Rename an owned skill without breaking old links or installs.\n- Merge duplicate owned skills into one canonical slug.\n- Browse souls + render their `SOUL.md`.\n- Publish new soul versions with changelogs + tags.\n- Search via embeddings (vector index) instead of brittle keywords.\n- Star + comment; admins\u002Fmods can curate and approve skills.\n- Browse OpenClaw packages with family\u002Ftrust\u002Fcapability metadata.\n- Publish native code plugins and bundle plugins through `\u002Fpackages` APIs and CLI flows.\n\n## onlycrabs.ai (SOUL.md registry)\n\n- Entry point is host-based: `onlycrabs.ai`.\n- On the onlycrabs.ai host, the home page and nav default to souls.\n- On ClawHub, souls live under `\u002Fsouls`.\n- Soul bundles only accept `SOUL.md` for now (no extra files).\n\n## How it works (high level)\n\n- Web app: TanStack Start (React, Vite\u002FNitro).\n- Backend: Convex (DB + file storage + HTTP actions) + Convex Auth (GitHub OAuth).\n- Search: OpenAI embeddings (`text-embedding-3-small`) + Convex vector search.\n- API schema + routes: `packages\u002Fschema` (`clawhub-schema`).\n\n## CLI\n\nCommon CLI flows:\n\n- Auth: `clawhub login`, `clawhub whoami`\n- Discover: `clawhub search ...`, `clawhub explore`\n- Browse unified catalog (skills + plugins): `clawhub package explore`, `clawhub package inspect \u003Cname>`\n- Manage local installs: `clawhub install \u003Cslug>`, `clawhub uninstall \u003Cslug>`, `clawhub list`, `clawhub update --all`\n- Inspect without installing: `clawhub inspect \u003Cslug>`\n- Publish\u002Fsync skills: `clawhub skill publish \u003Cpath>`, `clawhub sync`\n- Publish plugins: `clawhub package publish \u003Csource>`\n- Canonicalize owned skills: `clawhub skill rename \u003Cslug> \u003Cnew-slug>`, `clawhub skill merge \u003Csource> \u003Ctarget>`\n\nDocs: [`docs\u002Fquickstart.md`](docs\u002Fquickstart.md), [`docs\u002Fcli.md`](docs\u002Fcli.md).\n\n### Removal permissions\n\n- `clawhub uninstall \u003Cslug>` only removes a local install on your machine.\n- Uploaded registry skills use soft-delete\u002Frestore (`clawhub delete \u003Cslug>` \u002F `clawhub undelete \u003Cslug>` or API equivalents).\n- Soft-delete\u002Frestore is allowed for the skill owner, moderators, and admins.\n- Hard delete is admin-only (management tools \u002F ban flows).\n- Owner rename keeps the old slug as a redirect alias.\n- Owner merge hides the source listing and redirects the old slug to the canonical target.\n\n## Telemetry\n\nClawHub tracks minimal **install telemetry** (to compute install counts) when you run `clawhub sync` while logged in.\nDisable via:\n\n```bash\nexport CLAWHUB_DISABLE_TELEMETRY=1\n```\n\nDetails: [`docs\u002Ftelemetry.md`](docs\u002Ftelemetry.md).\n\n## Repo layout\n\n- `src\u002F` — TanStack Start app (routes, components, styles).\n- `convex\u002F` — schema + queries\u002Fmutations\u002Factions + HTTP API routes.\n- `packages\u002Fschema\u002F` — shared API types\u002Froutes for the CLI and app.\n- [`docs\u002F`](docs\u002FREADME.md) — project documentation (architecture, CLI, auth, deployment, and more).\n- [`docs\u002Fspec.md`](docs\u002Fspec.md) — product + implementation spec (good first read).\n\n## Local dev\n\nPrereqs: [Bun](https:\u002F\u002Fbun.sh\u002F) (Convex runs via `bunx`, no global install needed).\n\n```bash\nbun install\ncp .env.local.example .env.local\n# edit .env.local — see CONTRIBUTING.md for local Convex values\n\n# terminal A: local Convex backend\nbunx convex dev\n\n# terminal B: web app (port 3000)\nbun run dev\n\n# seed sample data\nbunx convex run --no-push devSeed:seedNixSkills\n```\n\nFor full setup instructions (env vars, GitHub OAuth, JWT keys, database seeding), see [CONTRIBUTING.md](CONTRIBUTING.md).\n\n## Environment\n\n- `VITE_CONVEX_URL`: Convex deployment URL (`https:\u002F\u002F\u003Cdeployment>.convex.cloud`).\n- `VITE_CONVEX_SITE_URL`: Convex site URL (`https:\u002F\u002F\u003Cdeployment>.convex.site`).\n- `VITE_SOULHUB_SITE_URL`: onlycrabs.ai site URL (`https:\u002F\u002Fonlycrabs.ai`).\n- `VITE_SOULHUB_HOST`: onlycrabs.ai host match (`onlycrabs.ai`).\n- `VITE_SITE_MODE`: Optional override (`skills` or `souls`) for SSR builds.\n- `CONVEX_SITE_URL`: same as `VITE_CONVEX_SITE_URL` (auth + cookies).\n- `SITE_URL`: App URL (local: `http:\u002F\u002Flocalhost:3000`).\n- `AUTH_GITHUB_ID` \u002F `AUTH_GITHUB_SECRET`: GitHub OAuth App.\n- `JWT_PRIVATE_KEY` \u002F `JWKS`: Convex Auth keys.\n- `OPENAI_API_KEY`: embeddings for search + indexing.\n\n## Nix plugins (nixmode skills)\n\nClawHub can store a nix-clawdbot plugin pointer in SKILL frontmatter so the registry knows which\nNix package bundle to install. A nix plugin is different from a regular skill pack: it bundles the\nskill pack, the CLI binary, and its config flags\u002Frequirements together.\n\nAdd this to `SKILL.md`:\n\n```yaml\n---\nname: peekaboo\ndescription: Capture and automate macOS UI with the Peekaboo CLI.\nmetadata:\n  {\n    \"clawdbot\":\n      {\n        \"nix\":\n          {\n            \"plugin\": \"github:clawdbot\u002Fnix-steipete-tools?dir=tools\u002Fpeekaboo\",\n            \"systems\": [\"aarch64-darwin\"],\n          },\n      },\n  }\n---\n```\n\nInstall via nix-clawdbot:\n\n```nix\nprograms.clawdbot.plugins = [\n  { source = \"github:clawdbot\u002Fnix-steipete-tools?dir=tools\u002Fpeekaboo\"; }\n];\n```\n\nYou can also declare config requirements + an example snippet:\n\n```yaml\n---\nname: padel\ndescription: Check padel court availability and manage bookings via Playtomic.\nmetadata:\n  {\n    \"clawdbot\":\n      {\n        \"config\":\n          {\n            \"requiredEnv\": [\"PADEL_AUTH_FILE\"],\n            \"stateDirs\": [\".config\u002Fpadel\"],\n            \"example\": \"config = { env = { PADEL_AUTH_FILE = \\\\\\\"\u002Frun\u002Fagenix\u002Fpadel-auth\\\\\\\"; }; };\",\n          },\n      },\n  }\n---\n```\n\nTo show CLI help (recommended for nix plugins), include the `cli --help` output:\n\n```yaml\n---\nname: padel\ndescription: Check padel court availability and manage bookings via Playtomic.\nmetadata: { \"clawdbot\": { \"cliHelp\": \"padel --help\\\\nUsage: padel [command]\\\\n\" } }\n---\n```\n\n`metadata.clawdbot` is preferred, but `metadata.clawdis` and `metadata.openclaw` are accepted as aliases.\n\n## Skill metadata\n\nSkills declare their runtime requirements (env vars, binaries, install specs) in the `SKILL.md` frontmatter. ClawHub's security analysis checks these declarations against actual skill behavior.\n\nFull reference: [`docs\u002Fskill-format.md`](docs\u002Fskill-format.md#frontmatter-metadata)\n\nQuick example:\n\n```yaml\n---\nname: my-skill\ndescription: Does a thing with an API.\nmetadata:\n  openclaw:\n    requires:\n      env:\n        - MY_API_KEY\n      bins:\n        - curl\n    primaryEnv: MY_API_KEY\n---\n```\n\n## Scripts\n\n```bash\nbun run dev\nbun run build\nbun run test\nbun run coverage\nbun run lint\n```\n","\u003Cp align=\"center\">\n  \u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fopenclaw_clawhub_readme_ee5759de0bab.png\" alt=\"ClawHub\" width=\"120\">\n\u003C\u002Fp>\n\n\u003Ch1 align=\"center\">ClawHub\u003C\u002Fh1>\n\n\u003Cp align=\"center\">\n  \u003Ca href=\"https:\u002F\u002Fgithub.com\u002Fopenclaw\u002Fclawhub\u002Factions\u002Fworkflows\u002Fci.yml?branch=main\">\u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Factions\u002Fworkflow\u002Fstatus\u002Fopenclaw\u002Fclawhub\u002Fci.yml?branch=main&style=for-the-badge\" alt=\"CI 状态\">\u003C\u002Fa>\n  \u003Ca href=\"https:\u002F\u002Fdiscord.gg\u002Fclawd\">\u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fdiscord\u002F1456350064065904867?label=Discord&logo=discord&logoColor=white&color=5865F2&style=for-the-badge\" alt=\"Discord\">\u003C\u002Fa>\n  \u003Ca href=\"LICENSE\">\u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FLicense-MIT-blue.svg?style=for-the-badge\" alt=\"MIT 许可证\">\u003C\u002Fa>\n\u003C\u002Fp>\n\nClawHub 是 **Clawdbot 的公共技能注册表**：用于发布、版本化和搜索基于文本的智能体技能（包含 `SKILL.md` 及其支持文件）。它专为快速浏览和 CLI 友好的 API 设计，同时提供内容审核钩子和向量搜索功能。此外，它现在还公开了一个原生的 **OpenClaw 包目录**，用于管理代码插件和捆绑插件。\n\nonlycrabs.ai 是 **SOUL.md 注册表**：以与发布技能相同的方式发布和分享系统背景故事。\n\n\u003Cp align=\"center\">\n  \u003Ca href=\"https:\u002F\u002Fclawhub.ai\">ClawHub\u003C\u002Fa> ·\n  \u003Ca href=\"https:\u002F\u002Fonlycrabs.ai\">onlycrabs.ai\u003C\u002Fa> ·\n  \u003Ca href=\"VISION.md\">愿景\u003C\u002Fa> ·\n  \u003Ca href=\"docs\u002FREADME.md\">文档\u003C\u002Fa> ·\n  \u003Ca href=\"CONTRIBUTING.md\">贡献指南\u003C\u002Fa> ·\n  \u003Ca href=\"https:\u002F\u002Fdiscord.gg\u002Fclawd\">Discord\u003C\u002Fa>\n\u003C\u002Fp>\n\n## 你可以用它做什么\n\n- 浏览技能并渲染其 `SKILL.md`。\n- 发布新版本的技能，附带变更日志和标签（包括 `latest`）。\n- 在不破坏旧链接或安装的情况下重命名你拥有的技能。\n- 将重复的自有技能合并为一个规范的别名。\n- 浏览灵魂并渲染其 `SOUL.md`。\n- 发布新版本的灵魂，并附带变更日志和标签。\n- 使用嵌入向量（向量索引）进行搜索，而非依赖脆弱的关键字。\n- 收藏和评论；管理员或版主可以对技能进行精选和批准。\n- 浏览 OpenClaw 包，并查看其家族、信任度和能力元数据。\n- 通过 `\u002Fpackages` API 和 CLI 流程发布原生代码插件和捆绑插件。\n\n## onlycrabs.ai（SOUL.md 注册表）\n\n- 入口是基于主机的：`onlycrabs.ai`。\n- 在 onlycrabs.ai 主机上，首页和导航默认显示灵魂。\n- 在 ClawHub 上，灵魂位于 `\u002Fsouls` 路径下。\n- 灵魂包目前仅接受 `SOUL.md` 文件（不支持其他文件）。\n\n## 工作原理（高层次）\n\n- Web 应用：TanStack Start（React、Vite\u002FNitro）。\n- 后端：Convex（数据库、文件存储和 HTTP 操作）+ Convex Auth（GitHub OAuth）。\n- 搜索：使用 OpenAI 嵌入模型（`text-embedding-3-small`）结合 Convex 向量搜索。\n- API 架构和路由：`packages\u002Fschema`（`clawhub-schema`）。\n\n## CLI\n\n常用 CLI 流程：\n\n- 认证：`clawhub login`、`clawhub whoami`\n- 发现：`clawhub search ...`、`clawhub explore`\n- 浏览统一目录（技能 + 插件）：`clawhub package explore`、`clawhub package inspect \u003Cname>`\n- 管理本地安装：`clawhub install \u003Cslug>`、`clawhub uninstall \u003Cslug>`、`clawhub list`、`clawhub update --all`\n- 不安装直接检查：`clawhub inspect \u003Cslug>`\n- 发布\u002F同步技能：`clawhub skill publish \u003Cpath>`、`clawhub sync`\n- 发布插件：`clawhub package publish \u003Csource>`\n- 规范化自有技能：`clawhub skill rename \u003Cslug> \u003Cnew-slug>`、`clawhub skill merge \u003Csource> \u003Ctarget>`\n\n文档：[`docs\u002Fquickstart.md`](docs\u002Fquickstart.md)、[`docs\u002Fcli.md`](docs\u002Fcli.md)。\n\n### 删除权限\n\n- `clawhub uninstall \u003Cslug>` 仅会移除你本机上的本地安装。\n- 已上传到注册表的技能采用软删除\u002F恢复机制（`clawhub delete \u003Cslug>` \u002F `clawhub undelete \u003Cslug>` 或等效的 API 操作）。\n- 软删除\u002F恢复操作允许技能所有者、版主和管理员执行。\n- 硬删除仅限管理员操作（通过管理工具或封禁流程）。\n- 所有者重命名时，旧的别名 slug 会保留为重定向别名。\n- 所有者合并时，源条目将被隐藏，旧的 slug 会被重定向到规范的目标。\n\n## 遥测\n\nClawHub 会在你登录状态下运行 `clawhub sync` 时，收集最少的 **安装遥测数据**（用于计算安装次数）。\n可通过以下方式禁用：\n\n```bash\nexport CLAWHUB_DISABLE_TELEMETRY=1\n```\n\n详情请参阅 [`docs\u002Ftelemetry.md`](docs\u002Ftelemetry.md)。\n\n## 仓库结构\n\n- `src\u002F` — TanStack Start 应用（路由、组件、样式）。\n- `convex\u002F` — 架构、查询\u002F变更\u002F动作以及 HTTP API 路由。\n- `packages\u002Fschema\u002F` — CLI 和应用共享的 API 类型及路由。\n- [`docs\u002F`](docs\u002FREADME.md) — 项目文档（架构、CLI、认证、部署等）。\n- [`docs\u002Fspec.md`](docs\u002Fspec.md) — 产品与实现规格说明（适合初次阅读）。\n\n## 本地开发\n\n先决条件：[Bun](https:\u002F\u002Fbun.sh\u002F)（Convex 通过 `bunx` 运行，无需全局安装）。\n\n```bash\nbun install\ncp .env.local.example .env.local\n# 编辑 .env.local — 请参考 CONTRIBUTING.md 获取本地 Convex 配置值\n\n# 终端 A：本地 Convex 后端\nbunx convex dev\n\n# 终端 B：Web 应用（端口 3000）\nbun run dev\n\n# 种植示例数据\nbunx convex run --no-push devSeed:seedNixSkills\n```\n\n完整设置说明（环境变量、GitHub OAuth、JWT 密钥、数据库种子等），请参阅 [CONTRIBUTING.md](CONTRIBUTING.md)。\n\n## 环境变量\n\n- `VITE_CONVEX_URL`：Convex 部署 URL（`https:\u002F\u002F\u003Cdeployment>.convex.cloud`）。\n- `VITE_CONVEX_SITE_URL`：Convex 站点 URL（`https:\u002F\u002F\u003Cdeployment>.convex.site`）。\n- `VITE_SOULHUB_SITE_URL`：onlycrabs.ai 站点 URL（`https:\u002F\u002Fonlycrabs.ai`）。\n- `VITE_SOULHUB_HOST`：onlycrabs.ai 主机匹配（`onlycrabs.ai`）。\n- `VITE_SITE_MODE`：SSR 构建的可选覆盖模式（`skills` 或 `souls`）。\n- `CONVEX_SITE_URL`：与 `VITE_CONVEX_SITE_URL` 相同（认证和 Cookie）。\n- `SITE_URL`：应用 URL（本地：`http:\u002F\u002Flocalhost:3000`）。\n- `AUTH_GITHUB_ID` \u002F `AUTH_GITHUB_SECRET`：GitHub OAuth 应用程序。\n- `JWT_PRIVATE_KEY` \u002F `JWKS`：Convex Auth 密钥。\n- `OPENAI_API_KEY`：用于搜索和索引的嵌入模型 API 密钥。\n\n## Nix 插件（nixmode 技能）\n\nClawHub 可以在 SKILL 的 frontmatter 中存储一个 nix-clawdbot 插件指针，以便注册表知道要安装哪个 Nix 软件包束。Nix 插件与常规技能包不同：它将技能包、CLI 二进制文件及其配置标志\u002F要求打包在一起。\n\n将以下内容添加到 `SKILL.md`：\n\n```yaml\n---\nname: peekaboo\ndescription: 使用 Peekaboo CLI 捕获并自动化 macOS UI。\nmetadata:\n  {\n    \"clawdbot\":\n      {\n        \"nix\":\n          {\n            \"plugin\": \"github:clawdbot\u002Fnix-steipete-tools?dir=tools\u002Fpeekaboo\",\n            \"systems\": [\"aarch64-darwin\"],\n          },\n      },\n  }\n---\n```\n\n通过 nix-clawdbot 安装：\n\n```nix\nprograms.clawdbot.plugins = [\n  { source = \"github:clawdbot\u002Fnix-steipete-tools?dir=tools\u002Fpeekaboo\"; }\n];\n```\n\n你还可以声明配置要求以及示例片段：\n\n```yaml\n---\nname: padel\ndescription: 通过 Playtomic 查看帕德尔球场可用情况并管理预订。\nmetadata:\n  {\n    \"clawdbot\":\n      {\n        \"config\":\n          {\n            \"requiredEnv\": [\"PADEL_AUTH_FILE\"],\n            \"stateDirs\": [\".config\u002Fpadel\"],\n            \"example\": \"config = { env = { PADEL_AUTH_FILE = \\\"\u002Frun\u002Fagenix\u002Fpadel-auth\\\"; }; };\",\n          },\n      },\n  }\n---\n```\n\n为了显示 CLI 帮助信息（建议用于 Nix 插件），请包含 `cli --help` 的输出：\n\n```yaml\n---\nname: padel\ndescription: 通过 Playtomic 查看帕德尔球场可用情况并管理预订。\nmetadata: { \"clawdbot\": { \"cliHelp\": \"padel --help\\\\n用法: padel [命令]\\\\n\" } }\n---\n```\n\n推荐使用 `metadata.clawdbot`，但也接受 `metadata.clawdis` 和 `metadata.openclaw` 作为别名。\n\n## 技能元数据\n\n技能会在 `SKILL.md` 的 frontmatter 中声明其运行时要求（环境变量、二进制文件、安装规范）。ClawHub 的安全分析会将这些声明与技能的实际行为进行比对。\n\n完整参考：[`docs\u002Fskill-format.md`](docs\u002Fskill-format.md#frontmatter-metadata)\n\n快速示例：\n\n```yaml\n---\nname: my-skill\ndescription: 使用 API 做某件事。\nmetadata:\n  openclaw:\n    requires:\n      env:\n        - MY_API_KEY\n      bins:\n        - curl\n    primaryEnv: MY_API_KEY\n---\n```\n\n## 脚本\n\n```bash\nbun run dev\nbun run build\nbun run test\nbun run coverage\nbun run lint\n```","# ClawHub 快速上手指南\n\nClawHub 是 Clawdbot 的公共技能注册中心，支持发布、版本管理和搜索基于文本的 Agent 技能（`SKILL.md`）及代码插件。它提供 Web 浏览界面和友好的 CLI 工具，并集成了向量搜索功能。\n\n## 环境准备\n\n### 系统要求\n- 操作系统：Linux \u002F macOS \u002F Windows (WSL)\n- 网络：需能访问 GitHub 和 Convex 云服务\n\n### 前置依赖\n本项目使用 **Bun** 作为运行时和包管理器（Convex 通过 `bunx` 运行，无需全局安装）。\n\n1. 安装 Bun：\n   ```bash\n   curl -fsSL https:\u002F\u002Fbun.sh\u002Finstall | bash\n   ```\n   *注：国内用户若下载缓慢，可尝试使用镜像源或手动下载安装包。*\n\n2. 确保已拥有 GitHub 账号（用于登录认证）。\n\n## 安装步骤\n\n### 1. 克隆项目\n```bash\ngit clone https:\u002F\u002Fgithub.com\u002Fopenclaw\u002Fclawhub.git\ncd clawhub\n```\n\n### 2. 安装依赖\n```bash\nbun install\n```\n\n### 3. 配置环境变量\n复制示例配置文件并根据需要修改（本地开发通常只需确认 Convex 相关配置）：\n```bash\ncp .env.local.example .env.local\n```\n> **提示**：具体的本地 Convex 值和 GitHub OAuth 配置请参考项目根目录的 `CONTRIBUTING.md`。\n\n### 4. 启动开发环境\n你需要开启两个终端窗口分别运行后端和前端。\n\n**终端 A：启动本地 Convex 后端**\n```bash\nbunx convex dev\n```\n\n**终端 B：启动 Web 应用（默认端口 3000）**\n```bash\nbun run dev\n```\n\n### 5. 种子数据（可选）\n如需加载示例技能数据以便测试：\n```bash\nbunx convex run --no-push devSeed:seedNixSkills\n```\n\n启动完成后，访问 `http:\u002F\u002Flocalhost:3000` 即可看到 ClawHub 界面。\n\n## 基本使用\n\nClawHub 的核心功能主要通过 CLI 工具进行交互。在使用前，请确保你已通过 `clawhub login` 登录。\n\n### 1. 认证登录\n使用 GitHub 账号登录：\n```bash\nclawhub login\n```\n查看当前登录用户信息：\n```bash\nclawhub whoami\n```\n\n### 2. 浏览与搜索技能\n探索可用的技能库：\n```bash\nclawhub explore\n```\n通过向量嵌入（语义）搜索技能，而非简单的关键词匹配：\n```bash\nclawhub search \u003Cquery>\n```\n查看特定技能的详细信息（无需安装）：\n```bash\nclawhub inspect \u003Cslug>\n```\n\n### 3. 安装与管理技能\n安装指定技能到本地：\n```bash\nclawhub install \u003Cslug>\n```\n列出已安装的本地技能：\n```bash\nclawhub list\n```\n更新所有已安装的技能：\n```bash\nclawhub update --all\n```\n卸载本地技能（仅移除本地文件，不影响注册表）：\n```bash\nclawhub uninstall \u003Cslug>\n```\n\n### 4. 发布技能\n将本地的技能目录发布到注册中心（包含版本变更日志和标签）：\n```bash\nclawhub skill publish \u003Cpath>\n```\n同步本地状态：\n```bash\nclawhub sync\n```\n\n### 5. 高级管理（所有者权限）\n重命名技能（旧链接会自动重定向）：\n```bash\nclawhub skill rename \u003Cslug> \u003Cnew-slug>\n```\n合并重复的技能：\n```bash\nclawhub skill merge \u003Csource> \u003Ctarget>\n```\n\n### 关闭遥测（可选）\nClawHub 默认收集最小化的安装统计数据。如需禁用，可在运行命令前设置环境变量：\n```bash\nexport CLAWHUB_DISABLE_TELEMETRY=1\n```","某 AI 初创团队正在快速迭代其客服机器人，需要整合多名开发者编写的数十个独立技能模块（如“订单查询”、“情绪安抚”），并统一管理系统提示词（SOUL）。\n\n### 没有 clawhub 时\n- **技能管理混乱**：团队成员通过 GitHub 仓库或本地文件共享技能，版本更新不同步，常出现因手动复制粘贴导致的配置冲突。\n- **检索效率低下**：寻找特定功能的技能只能依靠模糊的文件名或关键词搜索，无法理解技能的实际语义能力，耗时费力。\n- **协作维护困难**：重命名或合并重复技能时会破坏现有引用链接，导致机器人运行报错，且缺乏统一的审核机制来保证技能质量。\n- **系统提示词分散**：机器人的核心设定（SOUL）散落在各个开发者的笔记中，难以统一版本控制和分发。\n\n### 使用 clawhub 后\n- **统一注册与版本控制**：团队利用 clawhub 发布带标签的技能版本，支持一键同步更新，彻底消除了手动同步带来的配置错误。\n- **语义化智能检索**：借助内置的向量搜索，开发者只需输入“处理退款”等自然语言描述，即可精准定位到具备相应能力的技能包。\n- **安全重构与治理**：通过 `skill rename` 和 `skill merge` 命令，团队可安全地合并冗余技能或优化命名，旧链接自动重定向，业务零中断。\n- **集中化管理系统灵魂**：将核心系统提示词作为 SOUL 发布到 onlycrabs.ai（clawhub 生态的一部分），确保所有机器人实例加载一致的最新人设。\n\nclawhub 将原本碎片化的 AI 技能开发流程转变为标准化、可检索且易于协作的现代化工程体系。","https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fopenclaw_clawhub_e60d245d.png","openclaw","https:\u002F\u002Foss.gittoolsai.com\u002Favatars\u002Fopenclaw_f9f07bbb.jpg","Your personal, open source AI assistant.",null,"peter@openclaw.ai","https:\u002F\u002Fopenclaw.ai","https:\u002F\u002Fgithub.com\u002Fopenclaw",[23,27,31,35],{"name":24,"color":25,"percentage":26},"TypeScript","#3178c6",98.3,{"name":28,"color":29,"percentage":30},"JavaScript","#f1e05a",1.1,{"name":32,"color":33,"percentage":34},"CSS","#663399",0.6,{"name":36,"color":37,"percentage":38},"Shell","#89e051",0,7600,1186,"2026-04-07T11:57:40","MIT",4,"未说明",{"notes":46,"python":44,"dependencies":47},"该项目主要基于 Bun 运行时（非 Node.js），无需全局安装，通过 bunx 运行 Convex。后端依赖 Convex 云服务（数据库、文件存储、向量搜索）和 GitHub OAuth 认证。搜索功能需要配置 OpenAI API Key 以生成嵌入向量。开发环境需配置 .env.local 文件包含 Convex 部署 URL 及认证密钥。支持通过 Nix 包管理器安装特定的插件技能。",[48,49,50,51],"Bun","TanStack Start (React, Vite\u002FNitro)","Convex","OpenAI API (text-embedding-3-small)",[53,54],"Agent","插件",[56,57],"directory","skill",2,"ready","2026-03-27T02:49:30.150509","2026-04-08T01:49:20.484023",[],[64],{"id":65,"version":66,"summary_zh":67,"released_at":68},144961,"v0.1.0","### 新增\n- API：v1 公开 REST 端点，包含速率限制、原始文件获取功能及 OpenAPI 规范。\n- 文档：`docs\u002Fapi.md` 和 `DEPRECATIONS.md`，用于 v1 切换计划。\n- 注册中心：GitHub 应用程序将已发布的技能备份至 `clawdbot\u002Fskills`（感谢 @thewilloftheshadow，#5）。\n\n### 变更\n- CLI：发布命令现使用单个分片的 `POST \u002Fapi\u002Fv1\u002Fskills` 请求。\n- 注册中心：旧版 `\u002Fapi\u002F*` 和 `\u002Fapi\u002Fcli\u002F*` 已标记为废弃（目前仍保留）。","2026-01-07T19:07:32",[70,81,89,98,106,114],{"id":71,"name":15,"github_repo":72,"description_zh":73,"stars":74,"difficulty_score":75,"last_commit_at":76,"category_tags":77,"status":59},4358,"openclaw\u002Fopenclaw","OpenClaw 是一款专为个人打造的本地化 AI 助手，旨在让你在自己的设备上拥有完全可控的智能伙伴。它打破了传统 AI 助手局限于特定网页或应用的束缚，能够直接接入你日常使用的各类通讯渠道，包括微信、WhatsApp、Telegram、Discord、iMessage 等数十种平台。无论你在哪个聊天软件中发送消息，OpenClaw 都能即时响应，甚至支持在 macOS、iOS 和 Android 设备上进行语音交互，并提供实时的画布渲染功能供你操控。\n\n这款工具主要解决了用户对数据隐私、响应速度以及“始终在线”体验的需求。通过将 AI 部署在本地，用户无需依赖云端服务即可享受快速、私密的智能辅助，真正实现了“你的数据，你做主”。其独特的技术亮点在于强大的网关架构，将控制平面与核心助手分离，确保跨平台通信的流畅性与扩展性。\n\nOpenClaw 非常适合希望构建个性化工作流的技术爱好者、开发者，以及注重隐私保护且不愿被单一生态绑定的普通用户。只要具备基础的终端操作能力（支持 macOS、Linux 及 Windows WSL2），即可通过简单的命令行引导完成部署。如果你渴望拥有一个懂你",349277,3,"2026-04-06T06:32:30",[53,78,79,80],"开发框架","图像","数据工具",{"id":82,"name":83,"github_repo":84,"description_zh":85,"stars":86,"difficulty_score":75,"last_commit_at":87,"category_tags":88,"status":59},3808,"stable-diffusion-webui","AUTOMATIC1111\u002Fstable-diffusion-webui","stable-diffusion-webui 是一个基于 Gradio 构建的网页版操作界面，旨在让用户能够轻松地在本地运行和使用强大的 Stable Diffusion 图像生成模型。它解决了原始模型依赖命令行、操作门槛高且功能分散的痛点，将复杂的 AI 绘图流程整合进一个直观易用的图形化平台。\n\n无论是希望快速上手的普通创作者、需要精细控制画面细节的设计师，还是想要深入探索模型潜力的开发者与研究人员，都能从中获益。其核心亮点在于极高的功能丰富度：不仅支持文生图、图生图、局部重绘（Inpainting）和外绘（Outpainting）等基础模式，还独创了注意力机制调整、提示词矩阵、负向提示词以及“高清修复”等高级功能。此外，它内置了 GFPGAN 和 CodeFormer 等人脸修复工具，支持多种神经网络放大算法，并允许用户通过插件系统无限扩展能力。即使是显存有限的设备，stable-diffusion-webui 也提供了相应的优化选项，让高质量的 AI 艺术创作变得触手可及。",162132,"2026-04-05T11:01:52",[78,79,53],{"id":90,"name":91,"github_repo":92,"description_zh":93,"stars":94,"difficulty_score":58,"last_commit_at":95,"category_tags":96,"status":59},1381,"everything-claude-code","affaan-m\u002Feverything-claude-code","everything-claude-code 是一套专为 AI 编程助手（如 Claude Code、Codex、Cursor 等）打造的高性能优化系统。它不仅仅是一组配置文件，而是一个经过长期实战打磨的完整框架，旨在解决 AI 代理在实际开发中面临的效率低下、记忆丢失、安全隐患及缺乏持续学习能力等核心痛点。\n\n通过引入技能模块化、直觉增强、记忆持久化机制以及内置的安全扫描功能，everything-claude-code 能显著提升 AI 在复杂任务中的表现，帮助开发者构建更稳定、更智能的生产级 AI 代理。其独特的“研究优先”开发理念和针对 Token 消耗的优化策略，使得模型响应更快、成本更低，同时有效防御潜在的攻击向量。\n\n这套工具特别适合软件开发者、AI 研究人员以及希望深度定制 AI 工作流的技术团队使用。无论您是在构建大型代码库，还是需要 AI 协助进行安全审计与自动化测试，everything-claude-code 都能提供强大的底层支持。作为一个曾荣获 Anthropic 黑客大奖的开源项目，它融合了多语言支持与丰富的实战钩子（hooks），让 AI 真正成长为懂上",143909,"2026-04-07T11:33:18",[78,53,97],"语言模型",{"id":99,"name":100,"github_repo":101,"description_zh":102,"stars":103,"difficulty_score":58,"last_commit_at":104,"category_tags":105,"status":59},2271,"ComfyUI","Comfy-Org\u002FComfyUI","ComfyUI 是一款功能强大且高度模块化的视觉 AI 引擎，专为设计和执行复杂的 Stable Diffusion 图像生成流程而打造。它摒弃了传统的代码编写模式，采用直观的节点式流程图界面，让用户通过连接不同的功能模块即可构建个性化的生成管线。\n\n这一设计巧妙解决了高级 AI 绘图工作流配置复杂、灵活性不足的痛点。用户无需具备编程背景，也能自由组合模型、调整参数并实时预览效果，轻松实现从基础文生图到多步骤高清修复等各类复杂任务。ComfyUI 拥有极佳的兼容性，不仅支持 Windows、macOS 和 Linux 全平台，还广泛适配 NVIDIA、AMD、Intel 及苹果 Silicon 等多种硬件架构，并率先支持 SDXL、Flux、SD3 等前沿模型。\n\n无论是希望深入探索算法潜力的研究人员和开发者，还是追求极致创作自由度的设计师与资深 AI 绘画爱好者，ComfyUI 都能提供强大的支持。其独特的模块化架构允许社区不断扩展新功能，使其成为当前最灵活、生态最丰富的开源扩散模型工具之一，帮助用户将创意高效转化为现实。",107888,"2026-04-06T11:32:50",[78,79,53],{"id":107,"name":108,"github_repo":109,"description_zh":110,"stars":111,"difficulty_score":58,"last_commit_at":112,"category_tags":113,"status":59},4721,"markitdown","microsoft\u002Fmarkitdown","MarkItDown 是一款由微软 AutoGen 团队打造的轻量级 Python 工具，专为将各类文件高效转换为 Markdown 格式而设计。它支持 PDF、Word、Excel、PPT、图片（含 OCR）、音频（含语音转录）、HTML 乃至 YouTube 链接等多种格式的解析，能够精准提取文档中的标题、列表、表格和链接等关键结构信息。\n\n在人工智能应用日益普及的今天，大语言模型（LLM）虽擅长处理文本，却难以直接读取复杂的二进制办公文档。MarkItDown 恰好解决了这一痛点，它将非结构化或半结构化的文件转化为模型“原生理解”且 Token 效率极高的 Markdown 格式，成为连接本地文件与 AI 分析 pipeline 的理想桥梁。此外，它还提供了 MCP（模型上下文协议）服务器，可无缝集成到 Claude Desktop 等 LLM 应用中。\n\n这款工具特别适合开发者、数据科学家及 AI 研究人员使用，尤其是那些需要构建文档检索增强生成（RAG）系统、进行批量文本分析或希望让 AI 助手直接“阅读”本地文件的用户。虽然生成的内容也具备一定可读性，但其核心优势在于为机器",93400,"2026-04-06T19:52:38",[54,78],{"id":115,"name":116,"github_repo":117,"description_zh":118,"stars":119,"difficulty_score":75,"last_commit_at":120,"category_tags":121,"status":59},4487,"LLMs-from-scratch","rasbt\u002FLLMs-from-scratch","LLMs-from-scratch 是一个基于 PyTorch 的开源教育项目，旨在引导用户从零开始一步步构建一个类似 ChatGPT 的大型语言模型（LLM）。它不仅是同名技术著作的官方代码库，更提供了一套完整的实践方案，涵盖模型开发、预训练及微调的全过程。\n\n该项目主要解决了大模型领域“黑盒化”的学习痛点。许多开发者虽能调用现成模型，却难以深入理解其内部架构与训练机制。通过亲手编写每一行核心代码，用户能够透彻掌握 Transformer 架构、注意力机制等关键原理，从而真正理解大模型是如何“思考”的。此外，项目还包含了加载大型预训练权重进行微调的代码，帮助用户将理论知识延伸至实际应用。\n\nLLMs-from-scratch 特别适合希望深入底层原理的 AI 开发者、研究人员以及计算机专业的学生。对于不满足于仅使用 API，而是渴望探究模型构建细节的技术人员而言，这是极佳的学习资源。其独特的技术亮点在于“循序渐进”的教学设计：将复杂的系统工程拆解为清晰的步骤，配合详细的图表与示例，让构建一个虽小但功能完备的大模型变得触手可及。无论你是想夯实理论基础，还是为未来研发更大规模的模型做准备",90106,"2026-04-06T11:19:32",[97,79,53,78]]