关于 find-skills
用于在 ClaWHub 中搜索和发现技能的工具型技能,适合需要为 AI 工作流筛选技能的用户。可按能力、类别、评分、兼容性和关键词查找,并返回技能元数据。
主要功能
- 01按能力和关键词搜索技能
- 02按类别筛选结果
- 03按评分排序或设置最低评分
- 04检查版本兼容性
- 05返回 ID、名称和标签等元数据
适用场景
- 01为项目配置寻找相关技能
- 02按评分筛选候选技能
- 03检查技能与 OpenClaw 版本的兼容性
- 04在工作流中自动发现并串联技能
安装
复制下面的命令,在终端中运行。
npx skills add https:/ / github.com/ alphaonedev/ openclaw-graph --skill find-skills安装后在 Claude Code 中输入/find-skills确认已加载。
详细介绍
find-skills
用途
此技能可根据能力、类别、评分、兼容性和关键词等条件,在 ClaWHub 中搜索和发现技能,帮助用户高效找到适合集成到 AI 工作流中的技能。
适用场景
当你需要在 ClaWHub 中发现可用技能时,可使用此技能,例如查找适用于特定任务(如代码生成)的高评分技能、按类别(如“效率”)探索技能,或匹配关键词(如“图像处理”)。可在项目设置、技能原型开发或扩展 AI 能力时使用。
主要功能
- 按能力搜索技能(如“自然语言处理”)。
- 按类别筛选(如“社区”或“企业”)。
- 按评分排序(如至少 4.0 星)。
- 检查兼容性(如与版本 >=1.5 的 OpenClaw 兼容)。
- 按技能名称、描述或标签进行关键词匹配。
- 返回包含 ID、名称和标签等元数据的结果。
使用模式
通过 CLI 调用此技能以快速搜索,或将其集成到脚本中以自动发现技能。可在循环中获取并评估多个技能,或与其他技能组合以构建动态工作流(如先搜索再执行)。务必指定搜索参数以避免结果过于宽泛;例如,组合关键词和评分条件进行精准查询。
常用命令/API
使用 ClaWHub CLI 或 API 进行搜索。运行命令前,必须设置环境变量 $CLAWHUB_API_KEY 进行身份验证。
-
CLI 命令示例:
clawhub find-skills --query "AI coding" --category "community" --min-rating 4.0 --limit 10
此命令最多返回 10 个符合查询条件且评分至少为 4.0 的技能。 -
API 端点示例:
向https://api.clawhub.com/v1/skills/search发送包含 JSON 请求体的 POST 请求:{ "query": "web scraping", "category": "tools", "minRating": 3.5, "compatibility": "OpenClaw-v2" }响应为技能对象组成的 JSON 数组。
-
Python 集成代码片段:
import requests headers = {'Authorization': f'Bearer {os.environ.get("CLAWHUB_API_KEY")}'} response = requests.post('https://api.clawhub.com/v1/skills/search', json={'query': 'data analysis'}, headers=headers)此代码会获取匹配“数据分析”的技能。
-
配置格式:
将搜索偏好存储在 JSON 配置文件中(例如search-config.json):{ "defaultQuery": "AI tools", "defaultCategory": "community" }使用
--config search-config.json将其传递给 CLI。
集成说明
将 API 封装在 AI Agent 的代码中进行集成;确保安全地设置 $CLAWHUB_API_KEY。对于 OpenClaw,使用结果中的技能 ID 链式调用执行(例如,接下来调用 execute-skill)。通过检查 nextPageToken 字段处理 API 响应中的分页。在沙盒环境中测试集成,以验证其与 Agent 版本的兼容性。
错误处理
常见错误包括身份验证失败(HTTP 401:检查 $CLAWHUB_API_KEY)、查询无效(HTTP 400:验证 --query 等参数)或触发速率限制(HTTP 429:增加延迟)。在代码中使用 try-except 块封装 API 调用:
try:
response = requests.post(...)
response.raise_for_status()
except requests.exceptions.HTTPError as e:
print(f"Error: {e} - Retry after checking API key.")
记录包含错误代码等详细信息的错误,并使用指数退避策略重试,最多 3 次。
图谱关系
- 相关项:“discovery”(标签)、“search”(标签)、“clawhub”(集群)
- 依赖项:“clawhub-api”(用于身份验证和端点)
- 使用方:“skill-execution”(用于运行前发现技能)
- 冲突项:暂无已知项
- 增强项:通过提供发现机制,增强“community”集群中的技能