Tools

Tavily

OpenClaw는 Tavily를 두 가지 방식으로 사용할 수 있습니다.

web_search provider로 사용
명시적 Plugin 도구로 사용: tavily_search 및 tavily_extract

Tavily는 AI 애플리케이션용으로 설계된 검색 API로, LLM 소비에 최적화된 구조화된 결과를 반환합니다. 구성 가능한 검색 깊이, 주제 필터링, 도메인 필터, AI 생성 응답 요약, URL의 콘텐츠 추출(JavaScript로 렌더링된 페이지 포함)을 지원합니다.

API 키 받기

tavily.com에서 Tavily 계정을 만드세요.
대시보드에서 API 키를 생성하세요.
config에 저장하거나 gateway 환경에 TAVILY_API_KEY를 설정하세요.

Tavily 검색 구성

{
  plugins: {
    entries: {
      tavily: {
        enabled: true,
        config: {
          webSearch: {
            apiKey: "tvly-...", // TAVILY_API_KEY가 설정되어 있으면 선택 사항
            baseUrl: "https://api.tavily.com",
          },
        },
      },
    },
  },
  tools: {
    web: {
      search: {
        provider: "tavily",
      },
    },
  },
}

참고:

온보딩 또는 openclaw configure --section web에서 Tavily를 선택하면 번들 Tavily Plugin이 자동으로 활성화됩니다.
Tavily config는 plugins.entries.tavily.config.webSearch.* 아래에 저장하세요.
Tavily를 사용하는 web_search는 query와 count(최대 20개 결과)를 지원합니다.
search_depth, topic, include_answer, 도메인 필터 같은 Tavily 전용 제어를 원하면 tavily_search를 사용하세요.

Tavily Plugin 도구

`tavily_search`

일반적인 web_search 대신 Tavily 전용 검색 제어가 필요할 때 사용하세요.

매개변수	설명
`query`	검색 쿼리 문자열(400자 이하 권장)
`search_depth`	`basic` (기본값, 균형형) 또는 `advanced` (가장 높은 관련성, 더 느림)
`topic`	`general` (기본값), `news` (실시간 업데이트), 또는 `finance`
`max_results`	결과 개수, 1-20 (기본값: 5)
`include_answer`	AI 생성 응답 요약 포함 (기본값: false)
`time_range`	최신성 기준 필터: `day`, `week`, `month`, 또는 `year`
`include_domains`	결과를 제한할 도메인 배열
`exclude_domains`	결과에서 제외할 도메인 배열

검색 깊이:

깊이	속도	관련성	가장 적합한 경우
`basic`	더 빠름	높음	일반적인 쿼리 (기본값)
`advanced`	더 느림	최고	정밀성, 구체적 사실, 조사

`tavily_extract`

하나 이상의 URL에서 정리된 콘텐츠를 추출할 때 사용하세요. JavaScript로 렌더링된 페이지를 처리하고, 대상 추출을 위한 쿼리 중심 chunking을 지원합니다.

매개변수	설명
`urls`	추출할 URL 배열(요청당 1-20개)
`query`	이 쿼리와의 관련도에 따라 추출된 chunk를 재정렬
`extract_depth`	`basic` (기본값, 빠름) 또는 `advanced` (JS-heavy 페이지용)
`chunks_per_source`	URL당 chunk 수, 1-5 (`query` 필요)
`include_images`	결과에 이미지 URL 포함 (기본값: false)

추출 깊이:

깊이	사용 시점
`basic`	단순한 페이지 - 먼저 이것을 시도
`advanced`	JS 렌더링 SPA, 동적 콘텐츠, 표

팁:

요청당 최대 20개 URL. 더 큰 목록은 여러 호출로 나누세요.
전체 페이지 대신 관련 콘텐츠만 얻으려면 query + chunks_per_source를 사용하세요.
먼저 basic을 시도하고, 콘텐츠가 누락되거나 불완전하면 advanced로 fallback하세요.

올바른 도구 선택

필요 사항	도구
빠른 웹 검색, 특별한 옵션 없음	`web_search`
깊이, 주제, AI 응답이 있는 검색	`tavily_search`
특정 URL에서 콘텐츠 추출	`tavily_extract`

# API 키 받기

# Tavily 검색 구성

# Tavily Plugin 도구

# tavily_search

# tavily_extract

# 올바른 도구 선택

# 관련