Tavily Search

调用 Tavily 的 LLM 优化搜索 API，以 Node 脚本执行查询，支持结果数量、搜索深度、主题、时间范围与域名过滤等参数，返回带内容片段、相关度评分和元数据的搜索结果，需配置 TAVILY_API_KEY。

matthew77

热度 80.38

最近更新 2026-09-23 16:06:47

分类：搜索依赖：代码执行 / 第三方 API应用场景：研究

安装技能

复制下面的话术发给你的 Agent，它会通过 secure-skills 检索并安装该技能。

执行命令安装此 skill： npx secure-skills-cli add liang-tavily-search

Metadata

name: tavily-search
description: Web search using Tavily's LLM-optimized API. Returns relevant results with content snippets, scores, and metadata.
homepage: https://tavily.com
metadata: {"openclaw":{"emoji":"🔍","requires":{"bins":["node"],"env":["TAVILY_API_KEY"]},"primaryEnv":"TAVILY_API_KEY"}}

Tavily Search

Search the web and get relevant results optimized for LLM consumption.

Authentication

Get your API key at https://tavily.com and add to your OpenClaw config:

{
  "skills": {
    "entries": {
      "tavily-search": {
        "enabled": true,
        "apiKey": "tvly-YOUR_API_KEY_HERE"
      }
    }
  }
}

Or set the environment variable:

export TAVILY_API_KEY="tvly-YOUR_API_KEY_HERE"

Quick Start

Using the Script

node {baseDir}/scripts/search.mjs "query"
node {baseDir}/scripts/search.mjs "query" -n 10
node {baseDir}/scripts/search.mjs "query" --deep
node {baseDir}/scripts/search.mjs "query" --topic news

Examples

# Basic search
node {baseDir}/scripts/search.mjs "python async patterns"

# With more results
node {baseDir}/scripts/search.mjs "React hooks tutorial" -n 10

# Advanced search
node {baseDir}/scripts/search.mjs "machine learning" --deep

# News search
node {baseDir}/scripts/search.mjs "AI news" --topic news

# Domain-filtered search
node {baseDir}/scripts/search.mjs "Python docs" --include-domains docs.python.org

Options

Option	Description	Default
`-n <count>`	Number of results (1-20)	10
`--depth <mode>`	Search depth: `ultra-fast`, `fast`, `basic`, `advanced`	`basic`
`--topic <topic>`	Topic: `general` or `news`	`general`
`--time-range <range>`	Time range: `day`, `week`, `month`, `year`	-
`--include-domains <domains>`	Comma-separated domains to include	-
`--exclude-domains <domains>`	Comma-separated domains to exclude	-
`--raw-content`	Include full page content	false
`--json`	Output raw JSON	false

Search Depth

Depth	Latency	Relevance	Use Case
`ultra-fast`	Lowest	Lower	Real-time chat, autocomplete
`fast`	Low	Good	Need chunks but latency matters
`basic`	Medium	High	General-purpose, balanced
`advanced`	Higher	Highest	Precision matters, research

Tips

Keep queries under 400 characters - Think search query, not prompt
Break complex queries into sub-queries - Better results than one massive query
Use --include-domains to focus on trusted sources
Use --time-range for recent information
Filter by score (0-1) to get highest relevance results