Tavily Web Search

核心用法

Tavily Search 技能通过调用 Tavily API 实现实时网络搜索，专为 AI Agent 工作流设计。基础用法为 python3 scripts/search.py "查询内容"，支持 1-10 条结果控制（默认 5 条）。核心参数包括 --depth（basic/advanced 两档搜索深度）、--answer（生成 AI 摘要答案）、--images（获取相关图片 URL）及 --json（原始 JSON 输出）。API 密钥通过三级路径读取：OpenClaw 工作区 workspace/secrets/tavily_api_key、相对路径 secrets/tavily_api_key 或环境变量 TAVILY_API_KEY。

显著优点

1. 结构化输出：返回包含标题、URL、相关性评分（0-1）、内容片段的标准化结果，降低 Agent 解析成本
2. AI 原生设计：Tavily 专为 LLM 优化，相比传统搜索引擎（Google/Bing）返回更干净、无广告的内容块
3. 搜索深度可控：basic 模式响应快、消耗低，advanced 模式深度抓取适合综合研究
4. 集成友好：提供格式化文本与原始 JSON 两种输出，便于不同场景消费
5. 多模态支持：可选图片结果，扩展信息获取维度

潜在缺点与局限性

• 成本约束：advanced 深度及高数量结果会显著增加 API 调用成本
• 内容截断：片段固定 300 字符限制，复杂议题需多次查询或阅读原文
• 来源单一：依赖 Tavily 索引覆盖范围，小众或极新内容可能缺失
• 无本地缓存：每次调用均产生网络请求与 API 费用，高频场景需成本规划
• 答案质量波动：--answer 生成的摘要准确性受 Tavily 内部 LLM 能力制约

适合人群

• 需要突破训练数据时间限制的 AI Agent 开发者
• 进行竞品分析、市场研究、新闻监控的研究人员
• 构建 RAG 系统需实时检索增强的工程师
• 需要快速事实核查与多源交叉验证的内容创作者

常规风险

1. API 密钥泄露：密钥存储于本地文件路径，多用户环境需严格权限管理
2. 成本失控：advanced 模式与高频调用易触达用量上限，建议实施配额监控
3. 信息时效幻觉：搜索结果虽为实时，但 Tavily 索引本身存在抓取延迟（通常分钟级）
4. 版权与合规：抓取内容的使用需遵守目标网站 robots.txt 及服务条款

核心用法

Tavily Search是一款面向AI Agent的实时网络搜索技能，通过调用Tavily API获取结构化搜索结果。支持基础与深度两种搜索模式，可配置结果数量（1-10条），并可选AI生成的答案摘要与相关图片。使用Python脚本直接调用，支持JSON或格式化文本输出，API密钥通过环境变量或指定文件路径配置。

显著优点

1. 专为AI设计：Tavily API针对AI Agent消费优化，返回带相关性评分（0-1）的结构化数据，便于Agent自主判断信息质量
2. 功能聚焦：代码仅296行，单一职责明确，无冗余功能，维护成本低
3. 安全合规：静态/动态分析均无风险发现，通过GDPR数据最小化原则等五项合规检查，TLS加密传输
4. 灵活输出：支持格式化文本便于阅读，也支持原始JSON便于程序化解析
5. 成本可控：深度模式（advanced）可选，平衡搜索质量与API调用成本

潜在缺点与局限性

• 外部依赖：核心功能完全依赖Tavily第三方服务，存在服务可用性风险
• 无本地缓存：每次查询均发起API请求，重复搜索产生冗余成本
• 功能单一：仅支持搜索，无结果存储、历史管理或批量处理功能
• 透明度待提升：SKILL.md未明确说明查询数据会发送至Tavily服务器，隐私告知不完整
• 开源许可缺失：当前为Unknown许可，社区采用存在顾虑

适合人群

• 需要突破训练数据时间限制的AI Agent开发者
• 进行竞品分析、市场研究、新闻监控的研究人员
• 构建RAG（检索增强生成）系统的技术团队
• 需要快速事实核查与多源信息整合的内容创作者

常规风险

• API密钥泄露风险：密钥存储于本地文件，多用户环境需严格权限管理
• 第三方数据处理：搜索内容经Tavily服务器处理，敏感信息查询需谨慎
• 网络依赖：离线环境完全不可用，网络波动影响响应稳定性
• 成本累积：高频调用或深度搜索模式可能产生较高API费用