Tavily Search - 智能搜索工具

---

name: tavily-search

description: "使用Tavily API进行智能网络搜索。无需信用卡，每月1000次免费查询。支持AI增强的搜索结果和深度研究模式。Use when: 需要高质量搜索结果、学术研究、或不想绑定信用卡的场景。"

homepage: https://tavily.com

metadata:

{

"openclaw":

{ "emoji": "🔍", "requires": { "bins": ["curl", "python3"] } },

}

---

# Tavily Search - 智能搜索工具

基于Tavily API的网络搜索skill，提供高质量的AI增强搜索结果。

Features

Setup

1. 获取API Key

1. 访问 https://tavily.com/

2. 注册账号（邮箱即可，无需绑卡）

3. 在Dashboard复制API Key

2. 配置OpenClaw

# 设置环境变量
export TAVILY_API_KEY="tvly-..."

# 或者写入配置文件
echo 'TAVILY_API_KEY=tvly-...' >> ~/.openclaw/.env

Usage

基础搜索

# 搜索最新AI新闻
python3 ~/.openclaw/skills/tavily-search/scripts/search.py "AI artificial intelligence news today"

# 中文搜索
python3 ~/.openclaw/skills/tavily-search/scripts/search.py "人工智能最新进展" --lang zh

Python调用

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 zh

Free Tier Limits

Response Format

{
  "query": "搜索词",
  "answer": "AI生成的综合答案（可选）",
  "results": [
    {
      "title": "标题",
      "url": "链接",
      "content": "内容摘要",
      "score": 0.95,
      "published_date": "2024-03-01"
    }
  ],
  "images": [...]
}

Notes