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.