Exa search

기준일: 2026-07-26
난이도: 중급
공식 기준: Exa search

개요

이 페이지는 OpenClaw Exa search 도구(파라미터, 권한, 설정, CLI)를 공식 문서 기준으로 정리합니다.

공식 요약: Exa AI search -- neural and keyword search with content extraction

도구 가시성은 profile / allow·deny policy / sandbox / channel 권한에 따라 달라집니다. 최신 스키마는 항상 공식 문서를 우선합니다.

공식 문서 기반 상세

아래는 공식 tools/exa-search 문서를 정리한 내용입니다. 코드 블록, 파라미터 이름, 기본값은 원문 그대로입니다.

Exa AI is a web_search provider with neural, keyword, and hybrid search modes plus built-in content extraction (highlights, text, summaries).

Install plugin

openclaw plugins install @openclaw/exa-plugin
openclaw gateway restart

Get an API key

Create an account

Sign up at [exa.ai](https://exa.ai/) and generate an API key from your
dashboard.

Store the key

Set `EXA_API_KEY` in the Gateway environment, or configure via:

```bash
openclaw configure --section web
```

Config

{
  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",
      },
    },
  },
}

Environment alternative: set EXA_API_KEY in the Gateway environment. For a gateway install, put it in ~/.openclaw/.env. See Env vars.

Base URL override

Set plugins.entries.exa.config.webSearch.baseUrl to route Exa search requests through a compatible proxy or alternate endpoint. OpenClaw normalizes bare hosts by prepending https:// and appends /search unless the path already ends there. The resolved endpoint is part of the search cache key, so results from different endpoints are never shared.

Tool parameters

• query (string) (required): Search query.

• count (number) · default: 5: Results to return (1-100, subject to Exa search-type limits).

• type ('auto' | 'neural' | 'fast' | 'deep' | 'deep-reasoning' | 'instant'): Search mode.

• freshness ('day' | 'week' | 'month' | 'year'): Time filter. Cannot be combined with date_after/date_before.

• date_after (string): Results after this date (YYYY-MM-DD).

• date_before (string): Results before this date (YYYY-MM-DD).

• contents (object): Content extraction options (see below).

Content extraction

Pass a contents object to control extracted content in results:

await web_search({
  query: "transformer architecture explained",
  type: "neural",
  contents: {
    text: true, // full page text
    highlights: { numSentences: 3 }, // key sentences
    summary: true, // AI summary
  },
});

Contents option	Type	Description
text	boolean | { maxCharacters }	Extract full page text
highlights	boolean | { maxCharacters, query, numSentences, highlightsPerUrl }	Extract key sentences
summary	boolean | { query }	AI-generated summary

If contents is omitted, Exa defaults to { highlights: true } so results include key-sentence excerpts. Result descriptions resolve from highlights first, then summary, then full text -- whichever is available first. Results also preserve the raw highlightScores and summary fields from the Exa API response when available.

Search modes

Mode	Description
auto	Exa picks the best mode (default)
neural	Semantic/meaning-based search
fast	Quick keyword search
deep	Thorough deep search
deep-reasoning	Deep search with reasoning
instant	Fastest results

참고

• count accepts up to 100, subject to Exa search-type limits.
• Results are cached for 15 minutes by default. Configure the shared tools.web.search.cacheTtlMinutes (minutes) and tools.web.search.timeoutSeconds (default 30s) to change caching and request timeout for all web_search providers, including Exa.

관련 문서

• Web Search overview -- all providers and auto-detection
• Brave Search -- structured results with country/language filters
• Perplexity Search -- structured results with domain filtering

검증 체크리스트

• 해당 tool이 활성 profile/policy에서 허용되는지 확인
• sandbox / elevated / host 실행 경로 정책을 이해했는지 확인
• 채널·에이전트 권한과 충돌하지 않는지 확인
• 공식 CLI/--help와 문서 옵션이 버전과 맞는지 확인

관련

• Tools 목록 인덱스
• 공식: Tools overview, Tools and custom providers