- name
- tavily-search
- description
- 使用Tavily API进行智能网络搜索。无需信用卡，每月1000次免费查询。支持AI增强的搜索结果和深度研究模式。Use when: 需要高质量搜索结果、学术研究、或不想绑定信用卡的场景。
- homepage
- https://tavily.com
- metadata
Tavily Search - 智能搜索工具
基于Tavily API的网络搜索skill，提供高质量的AI增强搜索结果。
Features
- ✅ 无需信用卡 - 每月1000次免费查询
- 🤖 AI增强 - 自动提取关键信息，生成摘要
- 🔬 深度研究模式 - 多源综合分析
- 📚 学术友好 - 适合研究和信息收集
- 🌐 多语言支持 - 中英文搜索优化
Setup
1. 获取API Key
- 访问 https://tavily.com/
- 注册账号（邮箱即可，无需绑卡）
- 在Dashboard复制API Key
2. 配置OpenClaw
# 设置环境变量
export TAVILY_API_KEY="tvly-..."
# 或者写入配置文件
echo 'TAVILY_API_KEY=tvly-...' >> ~/.openclaw/.envUsage
基础搜索
# 搜索最新AI新闻
python3 ~/.openclaw/skills/tavily-search/scripts/search.py "AI artificial intelligence news today"
# 中文搜索
python3 ~/.openclaw/skills/tavily-search/scripts/search.py "人工智能最新进展" --lang zhPython调用
import subprocess
import json
result = subprocess.run(
['python3', '~/.openclaw/skills/tavily-search/scripts/search.py',
'你的搜索词', '--json'],
capture_output=True, text=True
)
data = json.loads(result.stdout)Parameters
| 参数 | 说明 | 默认值 |
|---|---|---|
query | 搜索关键词 | 必填 |
--max-results | 返回结果数量 (1-20) | 5 |
--search-depth | 搜索深度 (basic/advanced) | basic |
--include-answer | 包含AI生成的答案 | True |
--include-images | 包含相关图片 | False |
--days | 时间范围（天） | 无限制 |
--lang | 语言偏好 (zh/en) | auto |
--json | JSON格式输出 | False |
Examples
AI新闻搜索
python3 scripts/search.py "OpenAI GPT-5 release" --days 7 --include-answer学术研究
python3 scripts/search.py "transformer architecture survey" \
--search-depth advanced --max-results 10技术问题
python3 scripts/search.py "Docker compose networking tutorial" \
--include-answer --lang zhFree Tier Limits
- 每月1000次API调用
- 每次最多20个结果
- 基础搜索深度
- 学生可申请更多额度
Response Format
{
"query": "搜索词",
"answer": "AI生成的综合答案（可选）",
"results": [
{
"title": "标题",
"url": "链接",
"content": "内容摘要",
"score": 0.95,
"published_date": "2024-03-01"
}
],
"images": [...]
}Notes
- 首次使用需要先配置TAVILY_API_KEY
- 建议将API key添加到~/.openclaw/.env
- 超过免费额度后会返回错误提示