Tavily Search
使用 Tavily API 在互联网上搜索并总结最新信息。本工具会向 https://api.tavily.com/search 发起网络请求。
配置环境变量与凭据
此脚本需要 Tavily API 密钥才能运行。请配置 TAVILY_API_KEY 环境变量（或将其写入 ~/.openclaw/.env）：
export TAVILY_API_KEY="your_api_key_here"
使用方法
python3 scripts/tavily_search.py --query "你的搜索词" [--search-depth advanced] [--max-results 5]
| 参数名 | 类型 | 必填 | 默认值 | 描述 |
|---|---|---|---|---|
query | string | 是 | - | 搜索关键词 |
search-depth | string | 否 | basic | 搜索深度：basic (基础, 1积分), advanced (高级, 2积分), fast (快速), ultra-fast (极速) |
topic | string | 否 | general | 主题分类：general (通用), news (新闻), finance (金融) |
country | string | 否 | - | 国家/地区（小写英文全名，如 china,united states,singapore，完整合法取值见 scripts/tavily_search.py 中 TAVILY_COUNTRY_CHOICES）；仅 topic=general 生效 |
time-range | string | 否 | - | 时间过滤：day, week, month, year (或简写 d, w, m, y) |
start-date | string | 否 | - | 起始日期，格式如 YYYY-MM-DD |
end-date | string | 否 | - | 结束日期，格式如 YYYY-MM-DD |
max-results | int | 否 | 5 | 返回结果数量限制（0-20） |
include-images | bool | 否 | False | 是否在结果中包含查询相关的图片 |
include-domains | string | 否 | - | 仅搜索指定域名（多个用逗号分隔） |
exclude-domains | string | 否 | - | 排除指定域名（多个用逗号分隔） |
chunks-per-source | int | 否 | 3 | 每个来源提取的文本块数量 (1-3，仅在 depth 为 advanced/fast 时有效) |
auto-parameters | bool | 否 | False | 开启后，Tavily 会根据查询意图自动覆盖及配置搜索参数 |
format | string | 否 | raw | 输出格式控制：raw (原始JSON), brave (极简JSON), md (人类可读) |
License
MIT License - Feel free to use and modify.