核心用法
ClawHub Search 是 OpenClaw 生态的官方技能发现工具,通过调用 https://clawhub.ai/api/v1/skills API 实现技能市场检索。核心功能包括:
- 关键词搜索:通过
q参数匹配技能名称、描述 - 智能排序:支持 downloads(下载量)、stars(星标数)、newest(最新发布)三种排序维度
- 格式化输出:内置 Python 脚本模板,可直接解析 JSON 并展示关键字段
使用流程为:获取 Bearer Token → 构造 curl 请求 → 解析返回数据 → 通过 npx clawhub@latest install <skill-slug> 安装目标技能。
显著优点
1. 权威性:官方 API 数据源,信息实时准确,避免网页抓取的动态渲染问题
2. 社区驱动:覆盖 OpenClaw 社区贡献的全部技能,下载量/星标数据公开透明
3. 检索效率高:支持组合关键词(如 agent+memory)和精确搜索,结果可量化评估
4. 即装即用:搜索结果直接对应可安装的技能 slug,无缝衔接安装流程
潜在局限
- 依赖 Token:必须使用有效的 CLAWHUB_TOKEN,个人用户需单独申请
- API 限制:存在未明示的速率限制,高频调用可能受限
- 搜索质量依赖关键词:过于具体的关键词可能返回结果不足,需人工调整策略
- 无内置筛选器:不支持按类别、安全等级等维度过滤,需人工阅读描述判断
适合人群
- OpenClaw/MCP 框架开发者,需要扩展系统能力
- 希望快速评估社区技能质量的技术决策者
- 构建自定义 Agent 团队需要特定功能模块的工程师
常规风险
- Token 泄露风险:API Key 若硬编码或误提交至版本控制,可能导致账户被盗用
- 供应链安全:通过搜索发现的第三方技能未经过官方安全审计,需自行评估代码可信度
- 网络依赖:ClawHub 服务可用性直接影响技能发现能力,存在单点依赖
使用建议
建议将 CLAWHUB_TOKEN 配置为环境变量,配合 shell 别名或封装脚本提升使用体验。搜索时优先按下载量排序,结合星标数和更新时间综合判断技能活跃度。