核心用法
Tavily Search Skill 是一个基于 Tavily API 的 OpenClaw 搜索技能,作为 Brave Web Search 的替代方案使用。主要工作流程包括:通过 Git 克隆安装、用户需提供 Tavily API Key、创建受保护的 apikey 文件,最后执行验证测试。支持基础搜索、指定结果数量(默认5条,可扩展至10条或更多)、以及图片搜索等进阶功能。
显著优点
- 高质量搜索结果:Tavily 专注于 AI 优化的搜索,返回结构化、高相关度的内容
- 灵活的黑名单机制:内置
blocklist/目录,支持根域名自动匹配子域名,有效过滤低质量或不可信来源 - 轻量依赖:仅需
curl和jq,跨平台兼容性强 - API 配额透明:成功响应包含剩余配额信息,便于用量管理
- stderr 独立反馈:过滤操作日志写入标准错误流,避免干扰正常输出
潜在缺点或局限性
- 强制外部依赖:必须用户自行申请 Tavily API Key,存在注册门槛
- 无内置缓存机制:每次搜索均为实时 API 调用,高频使用可能快速消耗配额
- 黑名单维护成本:需人工识别并添加低质域名,无社区共享黑名单更新机制
- 功能相对单一:相比企业级搜索方案,缺乏语义重排序、结果去重等高级特性
- Shell 脚本架构:复杂查询逻辑难以扩展,错误处理能力有限
适合人群
- 需要 Brave Search 替代方案的 OpenClaw/Claw 用户
- 对搜索结果质量有要求、希望自主控制过滤规则的技术用户
- 轻量级自动化工作流开发者,需集成命令行搜索工具
- 个人开发者或小型团队,预算有限但需结构化搜索数据
常规风险
- API Key 泄露风险:
apikey文件权限设为 600 仅为基础防护,需避免仓库误提交 - 配额超支风险:无内置用量限制,高频调用可能导致服务中断或额外费用
- 黑名单误判:过度过滤可能移除有价值结果,需持续调优规则
- 上游服务依赖:Tavily API 的可用性、定价策略变化直接影响技能功能