Tools

Exa 검색

Exa AI는 신경망, 키워드, 하이브리드 검색 모드와 내장 콘텐츠 추출(하이라이트, 텍스트, 요약)을 제공하는 web_search 제공자입니다.

Plugin 설치

bash

openclaw plugins install @openclaw/exa-pluginopenclaw gateway restart

API 키 발급

계정 만들기

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

키 저장

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

bash

openclaw configure --section web

구성

json5

{  plugins: {    entries: {      exa: {        config: {          webSearch: {            apiKey: "exa-...", // EXA_API_KEY가 설정된 경우 선택 사항            baseUrl: "https://api.exa.ai", // 선택 사항. OpenClaw가 /search를 추가함          },        },      },    },  },  tools: {    web: {      search: {        provider: "exa",      },    },  },}

환경 변수 대안: Gateway 환경에 EXA_API_KEY를 설정합니다. Gateway 설치 환경에서는 ~/.openclaw/.env에 추가합니다. 환경 변수를 참조하세요.

기본 URL 재정의

호환 프록시 또는 대체 엔드포인트를 통해 Exa 검색 요청을 라우팅하려면 plugins.entries.exa.config.webSearch.baseUrl을 설정합니다. OpenClaw는 프로토콜이 없는 호스트 앞에 https://를 붙여 정규화하고, 경로가 이미 /search로 끝나지 않는 한 /search를 추가합니다. 확인된 엔드포인트는 검색 캐시 키에 포함되므로 서로 다른 엔드포인트의 결과가 공유되는 일은 없습니다.

도구 매개변수

querystringrequired

검색 쿼리입니다.

countnumberdefault: 5

반환할 결과 수입니다(1~100, Exa 검색 유형 제한 적용).

검색 모드입니다.

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

시간 필터입니다. date_after/date_before와 함께 사용할 수 없습니다.

date_afterstring

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

date_beforestring

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

contentsobject

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

콘텐츠 추출

결과에서 추출할 콘텐츠를 제어하려면 contents 객체를 전달합니다.

javascript

await web_search({  query: "transformer architecture explained",  type: "neural",  contents: {    text: true, // 전체 페이지 텍스트    highlights: { numSentences: 3 }, // 핵심 문장    summary: true, // AI 요약  },});

콘텐츠 옵션	유형	설명
`text`	`boolean \| { maxCharacters }`	전체 페이지 텍스트 추출
`highlights`	`boolean \| { maxCharacters, query, numSentences, highlightsPerUrl }`	핵심 문장 추출
`summary`	`boolean \| { query }`	AI 생성 요약

contents를 생략하면 Exa는 기본적으로 { highlights: true }를 사용하므로 결과에 핵심 문장 발췌문이 포함됩니다. 결과 설명은 하이라이트, 요약, 전체 텍스트 순으로 먼저 사용할 수 있는 항목에서 가져옵니다. 또한 사용 가능한 경우 Exa API 응답의 원본 highlightScores 및 summary 필드도 결과에 보존됩니다.

검색 모드

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

참고 사항

count에는 최대 100까지 지정할 수 있으며 Exa 검색 유형 제한이 적용됩니다.
결과는 기본적으로 15분 동안 캐시됩니다. Exa를 포함한 모든 web_search 제공자의 캐시 및 요청 제한 시간을 변경하려면 공유 설정인 tools.web.search.cacheTtlMinutes(분)와 tools.web.search.timeoutSeconds(기본값 30초)를 구성하세요.