메인 콘텐츠로 건너뛰기

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

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

​
API 키 받기

1

Create an account

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

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 엔드포인트의 결과는 공유되지 않습니다.

​
도구 매개변수

​
query
string
필수
검색 쿼리입니다.
​
count
number
반환할 결과 수입니다(1~100).
​
type
'auto' | 'neural' | 'fast' | 'deep' | 'deep-reasoning' | 'instant'
검색 모드입니다.
​
freshness
'day' | 'week' | 'month' | 'year'
시간 필터입니다.
​
date_after
string
이 날짜 이후의 결과입니다(YYYY-MM-DD).
​
date_before
string
이 날짜 이전의 결과입니다(YYYY-MM-DD).
​
contents
object
콘텐츠 추출 옵션입니다(아래 참조).

​
콘텐츠 추출

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

​
관련 항목