Tavily Search#

使用 Tavily API 在互联网上搜索并总结最新信息。本工具会向 https://api.tavily.com/search 发起网络请求。

配置环境变量与凭据#

此脚本需要 Tavily API 密钥才能运行。请配置 TAVILY_API_KEY 环境变量（或将其写入 ~/.openclaw/.env）：

bash

export TAVILY_API_KEY="your_api_key_here"

使用方法#

bash

python3 scripts/tavily_search.py --query "你的搜索词" [--search-depth advanced] [--max-results 5]

参数名类型必填默认值描述querystring是-搜索关键词search-depthstring否basic搜索深度： basic (基础, 1积分), advanced (高级, 2积分), fast (快速), ultra-fast (极速)topicstring否general主题分类： general (通用), news (新闻), finance (金融)countrystring否-国家/地区（小写英文全名，如 china, united states, singapore，完整合法取值见 scripts/tavily_search.py 中 TAVILY_COUNTRY_CHOICES）； 仅 topic=general 生效time-rangestring否-时间过滤： day, week, month, year (或简写 d, w, m, y)start-datestring否-起始日期，格式如 YYYY-MM-DD``end-datestring否-结束日期，格式如 YYYY-MM-DD``max-resultsint否5返回结果数量限制（0-20）include-imagesbool否False是否在结果中包含查询相关的图片include-domainsstring否-仅搜索指定域名（多个用逗号分隔）exclude-domainsstring否-排除指定域名（多个用逗号分隔）chunks-per-sourceint否3每个来源提取的文本块数量 (1-3，仅在 depth 为 advanced/fast 时有效)auto-parametersbool否False开启后，Tavily 会根据查询意图自动覆盖及配置搜索参数formatstring否raw输出格式控制： raw (原始JSON), brave (极简JSON), md (人类可读)

License#

MIT License - Feel free to use and modify.