核心用法
Tavily Search 是一个基于 Tavily API 的网页搜索技能，作为 Brave Search 的替代方案使用。用户通过 Python 脚本调用，支持三种输出格式：默认原始 JSON、类 Brave 格式的稳定 JSON，以及便于阅读的 Markdown 列表。
基础命令结构为：
python3 {baseDir}/scripts/tavily_search.py --query "搜索词" --max-results 5 [选项]关键选项包括 --include-answer（获取简短答案摘要）和 --format（指定 brave/md 格式）。API 密钥可通过环境变量 TAVILY_API_KEY 或 ~/.openclaw/.env 文件配置。
显著优点
- 格式灵活：三种输出格式适配不同场景——原始 JSON 信息完整，Brave 格式兼容现有工作流，Markdown 便于直接阅读分享
- 答案摘要：可选的 short answer 功能直接提供查询总结，减少页面抓取需求
- 低 token 消耗：默认限制 3-5 条结果，专为 LLM 上下文优化设计
- 配置便捷：支持标准环境变量和配置文件双模式
潜在局限
- 依赖外部 Tavily 服务可用性，非自托管方案
- 结果数量受限（设计如此），深度研究需多次查询
- 未提供高级搜索语法或过滤选项的说明
- 相比 Brave，社区认知度和文档丰富度较低
适合人群
- 需要 Brave Search 备用方案的开发者和高级用户
- 偏好结构化 JSON 输出用于自动化处理的场景
- 追求简洁结果集以降低 LLM token 消耗的工作流
- 已持有 Tavily API 密钥或愿意申请的用户
常规风险
- API 密钥泄露：
TAVILY_API_KEY若写入脚本或日志可能造成密钥暴露，建议严格使用环境变量 - 外部依赖：Tavily 服务中断将直接导致技能失效
- 结果质量控制：AI 生成的 short answer 可能存在事实性偏差，重要信息应核对原始来源
- 隐私暴露：搜索查询内容发送至第三方 API，敏感信息需谨慎处理