技能介绍

要解决什么问题

你在本地写好一套 Agent 技能（目录、元数据、SKILL.md）之后，往往还要分别对接 ClawHub、GitHub Releases、国内镜像 SkillHub CN 等渠道：认证方式不同（CLI 登录、API Key、OAuth）、上传形态也不同（整包 tar.gz、逐文件、REST、委托 gh/clawhub）。手工切换命令容易漏步骤，也更难在团队里复用同一套发布流程。

技能如何工作

本技能以插件式平台注册组织发布：每个平台是独立适配器，在文件头用注释声明 manifest（@auth_method、@upload_type），主流程只关心统一的元数据与标准接口。

认证：适配器按类型检查登录态或环境变量——cli（如 clawhub login、gh auth login）、api_key、oauth、web_login、ssh_key，或 none。
上传：主流程在需要时打包；适配器负责 tarball、files、http_api、cli_tool 等具体上传路径。
内置平台：ClawHub（slug、changelog、版本）、GitHub Releases（自动 tag + tarball）、SkillHub CN（ClawHub 镜像同步，国内下载）。
流程：发布前 validate，失败即中止；敏感关键词文件不发布；凭证不进日志；每次操作需用户确认（可用 --yes 跳过）；记录写入 ~/.openclaw/skill-publisher/history.jsonl（不含凭证）。

社区还可按 references/adding-platforms.md 扩展 GitLab、Gitee、自建 Registry、飞书云盘等。

适用边界与注意点

SkillHub CN 走 mirror 模式时，通常以先发布到 ClawHub 再同步为前提，不要把它当成与 ClawHub 完全无关的第二条手工流水线。第三方适配器的认证与上传能力取决于各平台 API/CLI 的稳定性，扩展前建议在目标环境单独验证。发布前校验能拦住明显问题，但敏感内容过滤仍依赖关键词规则，不能替代你对仓库内容的审查。