메인 콘텐츠로 건너뛰기

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

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

​
시작하기

1

API 키 받기

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

Plugin 및 제공자 구성

{
  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",
      },
    },
  },
}
3

검색 실행 확인

아무 에이전트에서나 web_search를 트리거하거나, tavily_search를 직접 호출합니다.
온보딩 또는 openclaw configure --section web에서 Tavily를 선택하면 번들 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는 쿼리 관련성을 기준으로 청크의 순위를 매기므로, 쿼리가 없으면 이 매개변수는 의미가 없습니다.

​
관련 항목

웹 검색 개요

모든 제공자와 자동 감지 규칙.

Firecrawl

콘텐츠 추출을 포함한 검색 및 스크래핑.

Exa Search

콘텐츠 추출을 포함한 신경망 검색.

구성

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