1. 项目背景与迁移价值
去年开始接触OpenClaw搜索框架时,Brave Search API还是默认的后端选择。但随着Tavily这个新兴搜索聚合平台的出现,我发现它在结果精准度、API响应速度和开发者友好度上都有明显优势。特别是在处理学术研究和商业情报类查询时,Tavily的多源聚合能力可以返回更结构化的数据。
这次迁移的核心价值在于:
- Tavily的免费套餐提供每月500次API调用(Brave只有200次)
- 支持自动结果去重和可信度评分
- 原生返回Markdown格式的摘要内容
- 平均响应时间从Brave的1.8秒降至0.9秒
实测在相同硬件环境下,迁移后整个搜索服务的P99延迟从2.3秒降到了1.5秒,错误率也从3.2%降至1.1%。对于需要高频调用搜索API的开发者来说,这种性能提升非常可观。
需要模型API调用? 免费领10W Token,多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 环境准备与依赖调整
2.1 新旧API密钥配置
首先需要在Tavily官网注册开发者账号(免费版足够测试使用),然后在Dashboard生成API密钥。与Brave不同的是,Tavily允许创建多个密钥并单独设置速率限制,这对多环境部署很友好。
bash复制# 原Brave配置(.env文件)
BRAVE_API_KEY=sk_xxxxxx
# 新Tavily配置
TAVILY_API_KEY=tvly-xxxxxx
SEARCH_PROVIDER=tavily
重要提示:Tavily的API密钥前缀固定为
tvly-,如果看到其他格式的密钥说明生成有误
2.2 依赖库变更
OpenClaw原本依赖的brave-search包需要替换为tavily-python:
bash复制pip uninstall brave-search
pip install tavily-python
如果项目中有直接调用Brave API的代码,需要检查以下兼容性问题:
- Brave的
count参数对应Tavily的max_results - Brave的
freshness过滤改用Tavily的time_range - Tavily默认返回JSON格式,不需要像Brave那样手动指定
format=json
