核心用法
crawl-hub 是一个面向AI Agent开发者的自动化注册工具，旨在解决Agent生态系统中"可发现性"难题。用户只需执行 /crawl-hub 命令，技能便会：
1. 智能身份探测 — 自动扫描项目中的 openclaw.json / openclaw.yaml 或 package.json 中的 openclaw 字段，提取Agent名称、版本、作者、能力标签等元数据；缺失字段则交互式提示用户补全。
2. 标准化清单生成 — 输出符合 Clawl Schema v1 的 clawl.json 文件，包含Agent身份、发现端点、健康检查URL等关键信息，并自动注入 ISO 8601 时间戳。
3. 一键索引提交 — 自动向 api.clawl.io/v1/agents/ping 发送注册请求，将Agent加入搜索引擎待索引队列。
---
显著优点
- 零配置友好：即便项目未配置 OpenClaw，也能通过交互式向导完成注册。
- 幂等安全：检测到现有
clawl.json时会展示差异对比，经用户确认后才覆盖。 - 容错设计：索引器不可达时不中断流程，引导用户走手动提交兜底路径。
- 生态对齐：直接对接 Clawl（专注AI Agent的垂直搜索引擎），而非通用爬虫。
潜在局限
- 外部依赖：Clawl 服务本身的可用性决定了"即时索引"体验；若服务下线或API变更，自动提交功能将失效。
- 公网可达性：
clawl.json最终需部署到公网URL才能被爬虫发现，技能本身不负责托管/部署。 - 元数据质量：自动提取依赖项目已有配置规范，混乱的代码库可能导致标签、能力识别不准确。
适合人群
- 开发AI Agent并期望提升曝光度的独立开发者或团队
- 使用 OpenClaw 生态构建Agent的项目（天然适配）
- 需要将Agent纳入Clawl搜索索引的MCP/CLI/HTTP服务开发者
常规风险
- API端点信任：技能向
api.clawl.io发送POST请求，需确认该域名归属Clawl官方，防范DNS劫持或钓鱼域名替换。 - 元数据泄露：
clawl.json包含作者、主页等敏感信息，若项目为私有仓库，需评估公开注册带来的信息暴露风险。 - 版本漂移：Agent迭代后若未及时重新执行技能，搜索引擎中的元数据将过时。
---
> 来源说明：Clawl 为新兴Agent搜索引擎，其服务稳定性与长期维护承诺尚需观察，建议将 clawl.json 视为可迁移的开放标准格式，而非锁定于单一平台。