Tavily Search Skill

核心用法

Tavily Search Skill 是一款调用 Tavily AI 搜索 API 的 OpenClaw 技能，通过命令行脚本实现高质量网络搜索。核心功能包括：智能搜索返回结构化结果、实时额度监控（免费/付费额度分离显示）、付费模式灵活切换、以及完整的错误处理机制。

典型使用场景：

• 自动化信息收集与知识检索
• 需要引用可靠来源的 AI 问答系统
• 实时监控搜索配额消耗

基础命令结构：

./search.sh "关键词" [结果数量] [是否包含图片]

显著优点

1. 结构化输出：返回 JSON 格式结果，包含标题、URL、摘要，便于程序化处理
2. 额度透明化：实时显示 plan 类型、总配额、已用量、剩余量，避免服务中断
3. 成本控制：免费/付费额度分离管理，支持一键切换付费模式，灵活应对业务需求
4. 轻量依赖：仅需 curl 和 jq，跨平台兼容（Ubuntu/Debian/macOS）

潜在缺点与局限性

• 额度天花板：免费版每月仅 1000 次，高频场景需付费升级
• 结果上限：单次最多 20 条结果，大规模数据采集需分页处理
• 密钥自理：无默认 API Key，用户必须自行注册获取
• 无内置缓存：重复搜索仍会消耗配额

适合人群

• 开发者构建 AI Agent 或自动化工作流
• 需要可信来源引用的内容创作者
• 对搜索配额有严格成本控制要求的团队

常规风险

• 密钥泄露风险：API Key 通过环境变量传递，共享环境需注意隔离
• 网络依赖：完全依赖 Tavily 服务可用性及网络连通性
• 额度耗尽：未监控用量可能导致服务中断

核心用法

Tavily Search Skill 是一款调用 Tavily API 进行高质量网络搜索的 OpenClaw Skill。用户需自行配置 TAVILY_API_KEY 环境变量，通过 ./search.sh 执行搜索，支持指定结果数量、包含图片、查看额度、切换付费模式等参数。输出为结构化 JSON，包含搜索标题、URL、摘要及实时额度信息。

显著优点

• 智能搜索能力：集成 Tavily 专业搜索 API，返回高质量结构化结果
• 完善的额度管理：实时显示免费/付费额度使用状态，支持付费模式切换
• 代码安全可靠：静态分析 95 分，无危险函数，API Key 从环境变量安全读取
• 错误处理健全：覆盖网络失败、额度不足等异常情况
• 依赖轻量：仅依赖系统标准工具 curl 和 jq

潜在缺点与局限性

• 外部服务依赖：核心功能完全依赖 Tavily API，服务不可用则功能中断
• 来源可信度中等：T3 级别个人开发者维护，建议关注后续更新
• 免费额度有限：每月 1000 次请求，高频率使用需付费
• 结果数量限制：单次最多返回 20 条结果
• API Key 日志部分泄露：脚本第 17 行输出密钥前 10 位，存在低风险

适合人群

• 需要集成实时网络搜索能力的 AI 应用开发者
• 对搜索质量有要求、愿为 API 服务付费的用户
• 熟悉 shell 环境、能自行管理 API Key 的技术用户

常规风险

• 外部 API 服务稳定性风险（已识别 RISK-001，风险等级低）
• API Key 部分泄露风险（已识别 RISK-002，建议优化日志输出）
• 需自行承担 Tavily API 调用费用（付费模式下）