Tavily API 网络搜索替代方案，支持结构化 JSON 与 Markdown 输出，适合 Brave 不可用时快速获取网页摘要与链接。
说明：
## 核心用法
Tavily Search 是一个基于 Tavily API 的网页搜索技能，作为 Brave Search 的替代方案使用。用户通过 Python 脚本调用，支持三种输出格式：默认原始 JSON、类 Brave 格式的稳定 JSON，以及便于阅读的 Markdown 列表。
基础命令结构为：
“`bash
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，敏感信息需谨慎处理
会员专属
