clawhub-search（ClawHub 搜索）

ClawHub Skill 搜索工具

概述

此技能用于在 ClawHub 技能市场上搜索 OpenClaw Skills。通过调用 ClawHub API 获取技能列表，支持按关键词搜索和下载量排序。

API 信息

• API 地址: https://clawhub.ai/api/v1/skills
• 认证方式: Bearer Token
• 参数:

- q: 搜索关键词 - sort: 排序方式 (downloads, stars, newest) - limit: 返回数量 (可选)

使用方法

API Token

使用环境变量 CLAWHUB_TOKEN 存储 API Token。

获取方式：在 ClawHub 官网申请 API Token。

重要：不要将 Token 明文写入代码或文档中！

1. 获取 API Token

需要用户的 ClawHub API Token。可以在 ClawHub 官网申请。

2. 搜索 Skills

使用 curl 命令搜索：

# 基础搜索（按下载量排序）
curl -s "https://clawhub.ai/api/v1/skills?sort=downloads&q=关键词" \
  -H "Authorization: Bearer $CLAWHUB_TOKEN"

# 精确搜索
curl -s "https://clawhub.ai/api/v1/skills?q=agent+team" \
  -H "Authorization: Bearer $CLAWHUB_TOKEN"

# 搜索并格式化输出
curl -s "https://clawhub.ai/api/v1/skills?sort=downloads&q=关键词" \
  -H "Authorization: Bearer $CLAWHUB_TOKEN" | python3 -c "
import sys,json
d=json.load(sys.stdin)
for i in d.get('items',[])[:10]:
    print(f\"{i['slug']}: {i['summary'][:60]}... ({i['stats']['downloads']} downloads)\")
"

3. 安装 Skills

找到想用的 skill 后，使用以下命令安装：

# 通过 ClawHub 安装
npx clawhub@latest install <skill-slug>

# 或手动安装（下载并解压到 skills 目录）

常用搜索示例

示例：搜索 "agent" 相关的 Skills

curl -s "https://clawhub.ai/api/v1/skills?sort=downloads&q=agent" \
  -H "Authorization: Bearer YOUR_TOKEN" | python3 -c "
import sys,json
d=json.load(sys.stdin)
items = d.get('items', [])
print(f'找到 {len(items)} 个结果:\
')
for i in items[:15]:
    stats = i.get('stats', {})
    print(f\"- {i['slug']}\")
    print(f\"  描述: {i.get('summary', '')[:80]}\")
    print(f\"  下载: {stats.get('downloads', 0)} | 星标: {stats.get('stars', 0)}\")
    print()
"

输出格式解析

API 返回的 JSON 包含以下字段：

注意事项

1. Token 管理: API Token 需要妥善保管，不要泄露
2. 速率限制: 注意 API 调用频率限制
3. 动态页面: ClawHub 前端页面是动态加载的，无法通过普通网页抓取获取内容，必须使用 API
4. 搜索策略: 如果搜索结果少于 5 个，尝试用更通用的关键词

常用技巧

1. 组合搜索: 使用多个关键词组合，如 agent+memory、code+automation
2. 过滤筛选: 可以先搜索再根据描述人工筛选
3. 关注下载量: 高下载量通常意味着更稳定、更受欢迎的技能

相关链接

• ClawHub 官网: https://clawhub.ai/
• 技能市场: https://clawhub.ai/skills
• 发布技能: https://clawhub.ai/upload