clawhub-skill-forge

创建结构正确、符合扫描标准、安全规则及发布检查清单的ClawhHub OpenClaw技能。无需凭证或二进制文件。

安装

概览

ClawHub Skill Forge 是一个专为 ClawHub OpenClaw 生态设计的技能脚手架工具,旨在帮助开发者快速生成符合平台扫描标准、安全规则及发布规范的 OpenClaw 技能。该工具通过交互式引导获取技能名称与用途,自动生成结构完整且可直接发布的技能文件,无需依赖凭证或预编译二进制文件。其核心目标是确保每个生成的技能都能通过 ClawHub 严格的自动化扫描流程,避免因格式错误或安全疏漏导致的发布失败。 Skill Forge 严格遵循 ClawHub 的五大扫描准则:明确技能功能边界、规范指令作用域、确保安装机制安全、妥善处理凭据管理、以及控制持久化与权限范围。它特别强调描述摘要的前160字符必须包含价值主张与技术要求,因为这是注册表唯一信任的信息源。同时,工具内置了对 OpenClaw 解析器常见陷阱的检测能力,如缺失 frontmatter 闭合标记、误将 `openclaw` 列入依赖项等,这些细节问题若不修正会导致技能在列表中完全不可见。 整个生成过程模拟了真实的发布迭代路径——每次修复一个问题都会暴露下一层级的检查项,形成渐进式信任验证机制。这意味着开发者需多次提交才能最终通过审核,但这种设计有效防止了高风险技能被误放行。所有输出文件仅包含必需的 SKILL.md 和 _meta.json,杜绝冗余文档干扰审查流程。

核心功能特点

  1. 自动生成符合 ClawHub 扫描标准的 SKILL.md 和 _meta.json 文件
  2. 强制实施安全规则:禁止硬编码凭据、限制后台进程权限、确保日志脱敏
  3. 智能检测 OpenClaw 解析陷阱(如缺失 frontmatter 闭合符、错误依赖声明)
  4. 提供详细的凭据管理模板:区分必填/选填字段、设置敏感信息删除指引
  5. 支持背景任务声明与权限隔离:worker 脚本独立存储并配置最小访问权限
  6. 集成发布后校验清单:包括 GitHub 仓库元数据设置与技能可见性验证

适用场景

Skill Forge 最适用于希望在 ClawHub 生态中快速部署可信技能的开发者,尤其是那些需要调用第三方 API 并处理用户凭据的场景。例如,一个用于管理 Facebook Page 发帖与数据分析的技能,可以通过该工具自动生成包含 Graph API 调用说明、OAuth 令牌轮换策略及本地配置文件权限设置的完整技能包。由于 ClawHub 对社区技能采取保守审核策略,任何使用长期有效 token 或后台监听的服务都必须在此阶段明确声明风险点,而 Skill Forge 正好提供了标准化的披露模板。 另一个典型应用场景是跨平台 CLI 工具的封装,比如将 curl 命令包装成可配置的 Slack 通知服务。此时,工具会指导用户在描述中突出‘Requires: powershell/pwsh’并在 meta.json 中同步声明系统兼容性,同时在 worker 脚本部分强调仅传输元数据而非消息全文。这种细粒度控制能有效降低因越权访问或意外泄露导致的安全事件概率。 对于希望建立个人技能库的技术人员而言,Skill Forge 还能显著提升发布效率。传统方式下,开发者常因忽略 ownerId 应为内部 userId 而非公开 handle 而导致注册失败;而该工具会自动提示正确获取方式(通过 clawhub inspect 命令),并在 meta.json 中填充准确值。此外,它还会提醒设置 GitHub 仓库的 About 描述与 ClawHub 主页链接,解决‘无审计轨迹’警告,使整个发布流程具备可追溯性。