SuperAPI AI 工具集

clawhub-sync

部署与运维

查看项目

更新于 10-15 20:10

技能介绍

一、用途 clawhub-sync 用于把本地开发的 Skills 发布到两个公开平台:ClawHub(国际社区,强制 MIT-0 许可证)与腾讯 SkillHub(无许可证限制)。发布前自动应用 .gitignore 过滤,避免敏感文件被上传。

二、主要能力

  1. 平台分流:MIT 通用工具类 skill 只发 ClawHub;CC-BY-NC 等限制性许可证的法律类 skill 只发 SkillHub;slug 被占用时改发 SkillHub。platforms 二选一,不重复分发。
  2. 白名单控制:由 config/sync-allowlist.yaml 决定同步哪些 skill 及其目标平台,并配置 SkillHub 所需的 display_name(必填)与可选 slug;未提供该文件时使用默认忽略规则(忽略 test/、private-skills/、node_modules/)。
  3. 版本比对增量同步:对比 SKILL.md 的 version 与 config/sync-records.yaml 中记录的版本,判断是否需同步。
  4. 发布记录:按平台记录 version、last_sync、git_hash、status、url、publish_id 等。

三、使用方式 依赖 rsync、git、Python 3,并按目标平台安装 clawhub 或 skillhub CLI。腾讯 skillhub CLI 须 ≥ 2026.7.29 才支持 publish/login,可用 skillhub self-upgrade 升级。登录:clawhub login 或 skillhub login --key skh_xxx(token 从 SkillHub 个人设置获取)。发布前先运行 bash skills/clawhub-sync/scripts/prepare-publish.sh [--platform skillhub] skills/<skill-name> 生成临时目录,再执行 clawhub publish 或 skillhub publish。

四、限制 ClawHub 不支持按 skill 覆盖许可证,禁止在 SKILL.md 写冲突许可证条款;SkillHub 有发布频率限制,批量发布需串行并间隔约 12–15 秒,避免并行触发限流。Token 等同于账号密码,不得写入配置或提交到 Git。已发布版本不可修改,只能发布新版本。其他细节资料未提供。