Tavily Search Skill

核心用法

Tavily Search Skill 是一款集成 Tavily 搜索 API 的 OpenClaw 技能，专为需要高质量实时网络搜索的场景设计。用户需自行配置 TAVILY_API_KEY 环境变量后，通过 ./search.sh 命令执行搜索，支持自定义返回结果数量（最多20条）及图片检索。内置 --usage、--status、--toggle-paid-mode 等管理指令，方便监控配额与切换计费模式。

显著优点

1. 结构化输出：返回标准JSON格式，包含标题、链接、摘要及配额信息，便于下游处理
2. 实时配额追踪：每次调用后自动更新剩余额度，免费/付费配额独立显示
3. 灵活的付费策略：支持一键切换优先使用免费或付费额度，适配不同成本场景
4. 完善的错误处理：覆盖网络异常、额度耗尽等常见故障

潜在局限

• 依赖外部API：需用户自备API Key，服务可用性受 Tavily 平台稳定性制约
• 免费额度有限：1000次/月的免费配额对高频用户可能不足
• 结果数量上限：单次最多返回20条，大规模数据采集需多次调用
• 无本地缓存：重复查询消耗相同额度

适合人群

• 需要实时资讯检索的开发者与研究者
• 构建AI Agent/RAG系统的工程师（需外部知识增强）
• 对搜索质量有要求、愿为更好结果付费的专业用户

常规风险

API Key 以环境变量形式存储，存在被进程窥探或日志泄露的风险；建议配合密钥管理工具使用。免费额度耗尽后若未开启付费模式将导致服务中断，生产环境需做好额度监控与告警。

核心用法

Tavily Search Skill 是一个命令行工具，通过调用 Tavily 官方 API 实现高质量网络搜索。用户需先配置 TAVILY_API_KEY 环境变量，随后可通过 ./search.sh "查询内容" 执行搜索，支持指定结果数量、包含图片等选项。此外提供 --usage 查看配额、--toggle-paid-mode 切换付费模式、--status 检查状态等管理功能。

显著优点

1. 功能专一清晰：专注 Tavily 搜索集成，无冗余功能，符合 Unix 哲学
2. 配额管理完善：实时追踪免费/付费配额使用状态，避免超额调用
3. 输出结构化：返回标准 JSON 格式，便于下游程序解析处理
4. 依赖极简：仅需 curl 和 jq 两个系统标准工具，无第三方包依赖风险
5. 网络安全合规：仅访问官方 Tavily API，全 HTTPS 加密传输

潜在缺点与局限性

1. 需外部配置：用户必须自行注册并配置 Tavily API Key，增加使用门槛
2. 免费配额有限：每月仅 1000 次请求，高频场景需付费升级
3. 单次结果上限：最多返回 20 条结果，深度搜索需多次调用
4. 平台依赖：仅支持 Tavily 单一搜索引擎，无备用方案
5. 状态存储风险：临时目录存储配额信息，存在多用户环境下的信息泄露隐患

适合人群

• 需要实时网络搜索能力的开发者与自动化工作流
• 已将 Tavily 纳入技术栈的 AI/LLM 应用构建者
• 追求轻量级、无依赖搜索方案的个人用户
• 对配额成本敏感、需要精细化用量控制的团队

常规风险

• API Key 前缀在日志中部分暴露（低危）
• 搜索参数未严格转义，存在 JSON 注入理论风险（低危）
• 状态文件存储于 /tmp 目录，多用户系统下可能被读取（信息级）
• 完全依赖 Tavily 服务可用性，无故障转移机制