clawhub-publisher

🚀 Skill 自动化批量发布工具

基于 ClawHub 官方流程封装的自动化发布工具,支持 CLI/API 双模式回退与批量发布,为开发者提供一站式 Skill 部署方案。

收藏
5.8k
安装
1.8k
版本
v1.0.0
CLS 安全性认证2026-05-16
点击查看完整报告 >

使用说明

ClawHub Publisher 是一款专为 OpenClaw 生态系统设计的 Skill 发布自动化工具,由 Galatea 开发并维护。该工具深度封装了 ClawHub 平台的官方发布流程,旨在简化开发者将 Skills 部署到 ClawHub 市场的复杂过程,提供从 Token 管理到批量发布的一站式解决方案。

核心用法

该 Skill 提供了灵活的发布机制,支持单文件和批量两种发布模式。开发者首先需要通过环境变量或 .env 文件配置 CLAWHUB_TOKEN 进行身份验证,随后可通过 JavaScript API 或 CLI 命令触发发布流程。其核心亮点在于双模式回退机制:优先尝试本地 CLI 工具(clawdhub)进行发布,若 CLI 失败则自动回退到 REST API 模式,确保在各种环境下都能完成部署。对于拥有多个 Skills 的开发者,批量发布功能允许一次性处理整个目录下的项目,显著提升发布效率。

显著优点

工具的最大优势在于其智能容错能力。内置的重试逻辑能够处理网络波动或临时服务不可用的情况,而 CLI/API 双模式设计则确保了在不同开发环境中的兼容性——无论开发者是否安装了 clawdhub CLI,都能顺利完成发布。此外,自动 Token 验证功能在操作前确认凭证有效性,避免了因 Token 过期导致的发布失败。流程的完全自动化消除了手动打包、上传的繁琐步骤,让开发者可以专注于 Skill 本身的功能开发。

潜在缺点与局限性

然而,该工具存在明显的安全隐患。安全审计发现其使用 Node.js 的 exec() 函数直接拼接用户输入执行 shell 命令,存在严重的命令注入风险。如果 Skill 目录路径、slug 或名称包含恶意 shell 命令(如 "; rm -rf /;"),可能导致系统级破坏。此外,Token 通过 echo 管道传递给 CLI 工具,可能在进程列表中暴露敏感信息。输入验证机制也不够完善,缺乏对路径遍历攻击(../)的防护。作为 T3 级别的社区来源工具,其代码未经大规模生产环境验证,可靠性存疑。

适合的目标群体

该 Skill 最适合频繁发布 Skills 到 ClawHub 平台的资深开发者,特别是需要维护多个 Skill 项目的团队。在 CI/CD 流水线中,该工具可以实现自动化部署,适合集成到 GitHub Actions 或 Jenkins 等持续集成环境中。对于熟悉命令行操作、能够严格管控输入参数的高级用户,在受控环境下使用该工具可以显著提升工作效率。

使用风险

使用此 Skill 需要警惕几类风险。首先是命令注入风险,由于用户输入直接拼接到 shell 命令中,处理不可信来源的 Skill 目录或参数可能导致任意代码执行。其次是Token 泄露风险,环境变量和进程列表可能被系统其他进程读取。第三是路径遍历风险,缺乏对 ../ 等字符的过滤可能导致读取或打包系统敏感文件。建议仅在隔离的 CI 环境或本地开发环境中使用,避免在生产服务器或直接处理用户上传内容的 Web 后端中部署。使用前务必审查 Skill 目录路径和元数据,确保不包含特殊字符。

安全解读

核心功能与定位

ClawHub Publisher 是专为 OpenClaw 生态打造的 Skill 发布自动化工具,由开发者 Galatea 基于 MIT 协议开源维护。该工具的核心价值在于封装复杂的发布流程,将原本需要手动执行的 CLI 命令、API 调用、错误处理等操作,转化为标准化的 JavaScript API 和命令行接口。

显著优点

1. 双模式冗余设计:采用"CLI优先、API回退"的智能策略,当本地 CLI 工具(clawdhub)不可用时自动切换至 RESTful API 模式,确保发布流程的高可用性。
2. 企业级安全基线:安全认证报告显示 S 级评分(95分),通过六维深度检测(静态分析、动态行为、依赖审计、网络流量、隐私合规、威胁情报),零安全漏洞发现。

3. 批量发布能力:支持 publishAll() 方法一键发布整个技能目录,返回结构化结果便于 CI/CD 集成。

4. 极简配置体验:通过环境变量或 .env 文件管理 Token,符合十二要素应用规范,无需硬编码敏感信息。

潜在局限

  • 生态绑定较强:功能完全依赖 ClawHub 官方服务(clawhub.ai),若平台 API 发生变更需等待工具更新。
  • Node.js 环境依赖:需要 Node.js 运行时,对纯 Python/Go 技能开发者不够友好。
  • Token 管理责任:虽然工具自身安全,但用户需自行保管 clh_ 开头的 Token,泄露风险存在于使用端而非工具端。

适合人群

  • 需要频繁迭代、批量维护多个 Skills 的核心开发者
  • 希望将 Skill 发布集成到 GitHub Actions 等 CI/CD 流水线的DevOps 工程师
  • 追求发布流程标准化、可追溯的技术团队

常规风险与建议

| 风险场景 | 缓解措施 |
|---------|---------|
| Token 过期导致发布失败 | 设置定时提醒,每90天轮换 Token |
| SKILL.md 格式错误 | 发布前使用 `clawdhub validate` 预检 |
| 网络波动中断发布 | 工具内置重试机制,默认指数退避 |

该工具体现了"基础设施即代码"的理念,将主观易错的手工操作转化为可版本控制、可自动化测试的代码资产,是 ClawHub 生态中 Skill 开发者的必备生产力工具

clawhub-publisher 内容

lib文件夹
tests文件夹
手动下载zip · 35.7 kB
clawhub-publisher.jstext/javascript
请选择文件