Agent Skills
返回列表
ClawHub API 使用指南

ClawHub API 使用指南

知识管理 更新于 2026.08.30

将以下提示词粘贴到你的 AI 对话框中：

请根据 https://skillhub.cn/install/skillhub.md，安装 @user_15292d5a/yjkj-clh-api-guidance。

技能介绍

解决的问题

ClawHub API 的文档分散，调用方容易在 Bearer Token、公开端点、限流响应头和 429 处理上踩坑。该技能面向需要读取技能目录、下载包或做安全检查的集成方，把快速开始、认证、接口速查和错误处理整理成一份工程可用参考。

工作方式

  • 快速开始：给出 curl / Python requests 场景下的首个调用、API Key 获取和常见问答。
  • 认证边界：明确公开读取端点无需 token，写入和账户操作使用 Bearer Token，并覆盖 401 / 403。
  • 接口速查：按技能、包、插件、目录等分类列出 GET /api/v1/search、GET /api/v1/skills、GET /api/v1/packages 等常用端点，详细文档指向 reference/api-reference.md。
  • 限流与错误：解释 X-RateLimit-Remaining、Retry-After、指数退避、400 / 404 / 415 / 429 等处理建议。

适用边界

它适合构建第三方目录、做技能安全检查和下载包集成，不适合绕过认证、镜像私有内容或暗示平台认可。实际调用仍应以服务端响应头、接口行为和官方文档为准。

使用场景

  • 后端工程师接入技能目录时，用 GET /api/v1/skills 与搜索端点做列表和检索。
  • 集成包下载流程时，读取下载端点并处理 401、429 等错误。
  • 安全审核流程中，查询技能 moderation、scan 和包版本 security 信息。
  • 搭建第三方目录时，缓存响应并链接回源 ClawHub 页面 URL。

适合人员

  • 后端工程师：要把 ClawHub 技能或包目录集成到内部工具。
  • 平台运维：要维护第三方目录的缓存、限流和回源链接。
  • 安全审核人员：要查询技能 moderation、scan 与包版本 security。
  • 独立开发者：要下载并解析技能包或插件包文件。