Tools

Exa 검색

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

Plugin 설치

공식 Plugin을 설치한 다음 Gateway를 다시 시작합니다.

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-...", // 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은 bare 호스트 앞에 https://를 붙여 정규화하고, 경로가 이미 /search로 끝나지 않으면 /search를 추가합니다. 해석된 엔드포인트는 검색 캐시 키에 포함되므로 서로 다른 Exa 엔드포인트의 결과는 공유되지 않습니다.

도구 매개변수

querystringrequired

검색 쿼리입니다.

countnumber

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

검색 모드입니다.

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

시간 필터입니다.

date_afterstring

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

date_beforestring

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

contentsobject

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

콘텐츠 추출

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

javascript

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 통합입니다