English简体中文繁體中文日本語EspañolPortuguês (BR)한국어DeutschFrançaisالعربيةItalianoTiếng ViệtNederlandsTürkçeУкраїнськаBahasa IndonesiaPolskiفارسیไทย

Tools

Exa 검색

OpenClaw는 web_search 제공자로 Exa AI를 지원합니다. Exa는 내장 콘텐츠 추출(하이라이트, 텍스트, 요약)과 함께 신경망, 키워드, 하이브리드 검색 모드를 제공합니다.

API 키 받기

  • Create an account

    exa.ai에서 가입하고 대시보드에서 API 키를 생성합니다.

  • Store the key

    Gateway 환경에 EXA_API_KEY를 설정하거나 다음으로 구성합니다.

    openclaw configure --section web

    • 구성

    {
  plugins: {
    entries: {
      exa: {
        config: {
          webSearch: {
            apiKey: "exa-...", // optional if EXA_API_KEY is set
            baseUrl: "https://api.exa.ai", // optional; OpenClaw appends /search
          },
        },
      },
    },
  },
  tools: {
    web: {
      search: {
        provider: "exa",
      },
    },
  },
}

    환경 대안: Gateway 환경에 EXA_API_KEY를 설정합니다. Gateway 설치의 경우 ~/.openclaw/.env에 넣습니다.

    기본 URL 재정의

    Exa 검색 요청이 호환 프록시나 대체 Exa 엔드포인트를 거쳐야 할 때 plugins.entries.exa.config.webSearch.baseUrl을 설정합니다. OpenClaw는 기본 호스트 앞에 https://를 붙여 정규화하고, 경로가 이미 해당 위치에서 끝나지 않는 한 /search를 추가합니다. 해석된 엔드포인트는 검색 캐시 키에 포함되므로 서로 다른 Exa 엔드포인트의 결과는 공유되지 않습니다.

    도구 매개변수

    querystringrequired

    검색 쿼리입니다.

    countnumber

    반환할 결과 수입니다(1~100).

    type'auto' | 'neural' | 'fast' | 'deep' | 'deep-reasoning' | 'instant'

    검색 모드입니다.

    freshness'day' | 'week' | 'month' | 'year'

    시간 필터입니다.

    date_afterstring

    이 날짜 이후의 결과입니다(YYYY-MM-DD).

    date_beforestring

    이 날짜 이전의 결과입니다(YYYY-MM-DD).

    contentsobject

    콘텐츠 추출 옵션입니다(아래 참조).

    콘텐츠 추출

    Exa는 검색 결과와 함께 추출된 콘텐츠를 반환할 수 있습니다. 활성화하려면 contents 객체를 전달합니다.

    await web_search({
  query: "transformer architecture explained",
  type: "neural",
  contents: {
    text: true, // full page text
    highlights: { numSentences: 3 }, // key sentences
    summary: true, // AI summary
  },
});
    콘텐츠 옵션 유형 설명
    text boolean | { maxCharacters } 전체 페이지 텍스트 추출
    highlights boolean | { maxCharacters, query, numSentences, highlightsPerUrl } 핵심 문장 추출
    summary boolean | { query } AI 생성 요약

    검색 모드

    모드 설명
    auto Exa가 최적의 모드를 선택합니다(기본값)
    neural 의미 기반 검색
    fast 빠른 키워드 검색
    deep 철저한 심층 검색
    deep-reasoning 추론을 포함한 심층 검색
    instant 가장 빠른 결과

    참고

    • contents 옵션이 제공되지 않으면 Exa는 기본적으로 { highlights: true }를 사용하므로 결과에 핵심 문장 발췌가 포함됩니다.
    • 사용 가능한 경우 결과는 Exa API 응답의 highlightScores 및 summary 필드를 보존합니다.
    • 결과 설명은 하이라이트, 요약, 전체 텍스트 순으로, 사용 가능한 항목에서 결정됩니다.
    • freshness와 date_after/date_before는 함께 사용할 수 없습니다. 하나의 시간 필터 모드를 사용하세요.
    • 쿼리당 최대 100개의 결과를 반환할 수 있습니다(Exa 검색 유형 제한 적용).
    • 결과는 기본적으로 15분 동안 캐시됩니다(cacheTtlMinutes로 구성 가능).
    • Exa는 구조화된 JSON 응답을 제공하는 공식 API 통합입니다.

    관련 항목