​

Tavily

• web_search provider로 사용
• 명시적 플러그인 도구 tavily_search, tavily_extract로 사용

​

API 키 받기

1. tavily.com에서 Tavily 계정을 만듭니다.
2. 대시보드에서 API 키를 생성합니다.
3. 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",
      },
    },
  },
}

• onboarding이나 openclaw configure --section web에서 Tavily를 고르면 번들 Tavily 플러그인이 자동 활성화됩니다.
• Tavily 설정은 plugins.entries.tavily.config.webSearch.* 아래에 둡니다.
• Tavily를 사용하는 web_search는 query, count(최대 20개 결과)를 지원합니다.
• search_depth, topic, include_answer, 도메인 필터 같은 Tavily 전용 제어가 필요하면 tavily_search를 사용하세요.

​

Tavily 플러그인 도구

​

tavily_search

​

tavily_extract

• 요청당 최대 20개 URL만 허용됩니다. 더 많으면 여러 호출로 나누세요.
• 전체 페이지 대신 관련 부분만 원한다면 query + chunks_per_source를 사용하세요.
• 먼저 basic을 시도하고, 콘텐츠가 비거나 불완전하면 advanced로 넘어가세요.

​

어떤 도구를 써야 하나

​

관련 문서

• Web Search overview - 모든 provider와 자동 감지
• Firecrawl - 검색 + 스크래핑 + 콘텐츠 추출
• Exa Search - 콘텐츠 추출이 가능한 뉴럴 검색