메인 콘텐츠로 건너뛰기

​
Exa Search

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

​
API 키 받기

1

계정 만들기

exa.ai에서 가입하고 대시보드에서 API 키를 생성하세요.
2

키 저장

Gateway 환경에 EXA_API_KEY를 설정하거나 다음을 통해 구성하세요:
openclaw configure --section web

​
구성

{
  plugins: {
    entries: {
      exa: {
        config: {
          webSearch: {
            apiKey: "exa-...", // optional if EXA_API_KEY is set
          },
        },
      },
    },
  },
  tools: {
    web: {
      search: {
        provider: "exa",
      },
    },
  },
}
환경 변수 대안: Gateway 환경에 EXA_API_KEY를 설정하세요. gateway 설치의 경우 ~/.openclaw/.env에 넣으세요.

​
도구 매개변수

매개변수설명
query검색 쿼리(필수)
count반환할 결과 수(1-100)
type검색 모드: auto, neural, fast, deep, deep-reasoning, instant
freshness시간 필터: day, week, month, year
date_after이 날짜 이후의 결과(YYYY-MM-DD)
date_before이 날짜 이전의 결과(YYYY-MM-DD)
contents콘텐츠 추출 옵션(아래 참조)

​
콘텐츠 추출

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
  },
});
콘텐츠 옵션유형설명
textboolean | { maxCharacters }전체 페이지 텍스트 추출
highlightsboolean | { maxCharacters, query, numSentences, highlightsPerUrl }핵심 문장 추출
summaryboolean | { query }AI 생성 요약

​
검색 모드

모드설명
autoExa가 최적의 모드를 선택(기본값)
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 통합입니다

​
관련 문서