메인 콘텐츠로 건너뛰기
Tavily는 AI 애플리케이션을 위해 설계된 검색 API입니다. OpenClaw는 이를 두 가지 방식으로 제공합니다.
  • 범용 검색 도구의 web_search 공급자로 제공
  • 명시적 Plugin 도구로 제공: tavily_search 및 tavily_extract
Tavily는 구성 가능한 검색 깊이, 주제 필터링, 도메인 필터, AI 생성 답변 요약, URL의 콘텐츠 추출(JavaScript로 렌더링된 페이지 포함)을 갖춘, LLM 소비에 최적화된 구조화 결과를 반환합니다.
속성값
Plugin IDtavily
패키지@openclaw/tavily-plugin
인증TAVILY_API_KEY 또는 config apiKey
기본 URLhttps://api.tavily.com (기본값)
도구tavily_search, tavily_extract

​
시작하기

1

Install the plugin

openclaw plugins install @openclaw/tavily-plugin
2

Get an API key

tavily.com에서 Tavily 계정을 만든 다음, 대시보드에서 API 키를 생성합니다.
3

Configure the plugin and provider

{
  plugins: {
    entries: {
      tavily: {
        enabled: true,
        config: {
          webSearch: {
            apiKey: "tvly-...", // optional if TAVILY_API_KEY is set
            baseUrl: "https://api.tavily.com",
          },
        },
      },
    },
  },
  tools: {
    web: {
      search: {
        provider: "tavily",
      },
    },
  },
}
4

Verify search runs

아무 에이전트에서 web_search를 트리거하거나 tavily_search를 직접 호출합니다.
온보딩에서 Tavily를 선택하거나 openclaw configure --section web을 실행하면, 필요한 경우 공식 Tavily Plugin이 설치되고 활성화됩니다.

​
도구 참조

범용 web_search 대신 Tavily 전용 검색 제어가 필요할 때 사용합니다.
매개변수유형제약 조건 / 기본값설명
querystring필수검색 쿼리 문자열입니다. 400자 미만으로 유지하세요.
search_depthenumbasic (기본값), advancedadvanced는 더 느리지만 관련성이 더 높습니다.
topicenumgeneral (기본값), news, finance주제 계열로 필터링합니다.
max_resultsinteger1-20결과 수입니다.
include_answerboolean기본값 falseTavily AI 생성 답변 요약을 포함합니다.
time_rangeenumday, week, month, year최신성 기준으로 결과를 필터링합니다.
include_domainsstring array(없음)이 도메인의 결과만 포함합니다.
exclude_domainsstring array(없음)이 도메인의 결과를 제외합니다.
검색 깊이 절충점:
깊이속도관련성적합한 용도
basic더 빠름높음범용 쿼리(기본값).
advanced더 느림최고정밀 조사 및 사실 확인.

​
tavily_extract

하나 이상의 URL에서 정제된 콘텐츠를 추출할 때 사용합니다. JavaScript로 렌더링된 페이지를 처리하며, 대상 추출을 위한 쿼리 중심 청킹을 지원합니다.
매개변수유형제약 조건 / 기본값설명
urlsstring array필수, 1-20콘텐츠를 추출할 URL입니다.
querystring(선택 사항)이 쿼리와의 관련성 기준으로 추출된 청크를 다시 정렬합니다.
extract_depthenumbasic (기본값), advancedJS가 많은 페이지, SPA 또는 동적 테이블에는 advanced를 사용합니다.
chunks_per_sourceinteger1-5; query 필요URL당 반환되는 청크입니다. query 없이 설정하면 오류가 발생합니다.
include_imagesboolean기본값 false결과에 이미지 URL을 포함합니다.
추출 깊이 절충점:
깊이사용 시점
basic단순한 페이지입니다. 먼저 이 옵션을 시도하세요.
advancedJS로 렌더링된 SPA, 동적 콘텐츠, 테이블입니다.
더 큰 URL 목록은 여러 번의 tavily_extract 호출로 나누세요(요청당 최대 20개). 전체 페이지 대신 관련 콘텐츠만 얻으려면 query와 chunks_per_source를 함께 사용하세요.

​
적절한 도구 선택

필요 사항도구
특수 옵션 없는 빠른 웹 검색web_search
깊이, 주제, AI 답변이 있는 검색tavily_search
특정 URL에서 콘텐츠 추출tavily_extract
Tavily를 공급자로 사용하는 범용 web_search 도구는 query와 count(최대 20개 결과)를 지원합니다. Tavily 전용 제어(search_depth, topic, include_answer, 도메인 필터, 시간 범위)가 필요하면 대신 tavily_search를 사용하세요.

​
고급 구성

Tavily 클라이언트는 다음 순서로 API 키를 조회합니다.
  1. plugins.entries.tavily.config.webSearch.apiKey(SecretRefs를 통해 해석됨).
  2. gateway 환경의 TAVILY_API_KEY.
둘 다 없으면 tavily_extract는 설정 오류를 발생시킵니다.
프록시를 통해 Tavily를 앞단에 두는 경우 plugins.entries.tavily.config.webSearch.baseUrl을 재정의하세요. 기본값은 https://api.tavily.com입니다.
tavily_extract는 query 없이 chunks_per_source를 전달하는 호출을 거부합니다. Tavily는 쿼리 관련성으로 청크의 순위를 매기므로, 쿼리가 없으면 이 매개변수는 의미가 없습니다.

​
관련 항목

Web Search overview

모든 공급자와 자동 감지 규칙입니다.

Firecrawl

콘텐츠 추출이 포함된 검색 및 스크래핑입니다.

Exa Search

콘텐츠 추출이 포함된 신경망 검색입니다.

Configuration

Plugin 항목 및 도구 라우팅을 위한 전체 config 스키마입니다.