ClawHub Skill Guide 是一个专为 OpenClaw 技能开发者设计的实用指南，旨在帮助开发者创建、构建并发布符合安全标准的技能至 ClawHub 平台。该工具不仅提供了完整的 YAML frontmatter 模式说明，还详细阐述了如何通过安全扫描并获得良好评级。与内置的 `skill-creator` 技能相比，本指南特别强调了在实际发布过程中必须包含的额外字段，如环境变量声明（env）、元数据（metadata）和依赖项（requires），这些字段对于通过 ClawHub 的安全审查至关重要。 本指南覆盖了从技能结构设计到最终发布的完整流程。它指导开发者如何合理规划 SKILL.md、scripts、references 和 assets 等目录的内容布局，确保核心说明简洁明了，辅助材料有序组织。在编写 frontmatter 时，指南指出使用 `metadata.openclaw` 格式是推荐做法，因为它能同时兼容本地打包工具和 ClawHub 的在线扫描器，避免因格式不匹配导致的验证失败。此外，指南还深入剖析了安全扫描器的五大评估类别：目的与能力、指令范围、安装机制、凭证处理以及持久化与权限，为开发者提供了清晰的合规路径。 通过提供具体的代码示例、最佳实践建议和常见陷阱分析，该指南大大降低了技能发布门槛。无论是需要集成 API 密钥的技能，还是涉及脚本执行或配置变更的场景，开发者都能找到相应的解决方案。最终目标是让每一个发布的技能都具备高透明度、强安全性，并在 ClawHub 生态中获得良好的信誉和发现率。
核心功能特点
- 提供完整的 YAML frontmatter 模式文档，支持环境变量、元数据和依赖项声明
- 详解五大安全扫描类别合规要求，涵盖凭证处理、指令范围和持久化控制
- 推荐使用 metadata.openclaw 格式以确保本地打包与在线扫描双重兼容
- 包含从结构设计到发布的完整工作流，提供命令行操作参考
- 附带多种 SKILL.md 模板，支持基础技能、含脚本技能和配置变更场景
适用场景
ClawHub Skill Guide 特别适合需要在 ClawHub 平台上发布 OpenClaw 技能的 AI 助手开发者。无论你是希望分享自动化工具、API 集成方案，还是需要提供特定领域（如数据分析、系统管理）的操作指导，该指南都能帮助你构建符合平台安全标准的高质量技能。通过遵循指南中的 frontmatter 规范和安全实践，开发者可以显著提升技能在 ClawHub 上的可见性和可信度。 对于涉及敏感凭证（如 API 密钥、数据库密码）的技能，本指南尤为重要。它强制要求所有环境变量必须在 frontmatter 中明确声明，并建议标记敏感信息，从而防止凭据泄露风险。同时，指南强调脚本应仅在技能工作区内操作，禁止外部下载和网络调用，确保执行过程透明可控。这种设计特别适合需要与第三方服务交互但又要保证安全性的场景，例如调用云服务 API 生成报告或监控资源使用情况。 此外，该指南也适用于希望优化技能用户体验的开发者。通过提供描述最佳实践、触发关键词建议和渐进式披露结构，帮助技能更精准地被目标用户识别和使用。无论是简单的文件操作技能，还是复杂的配置管理工具，都可以借助这些模板和原则快速构建出专业水准的发布包。