Перейти до основного вмісту
OpenClaw підтримує Exa AI як провайдера web_search. Exa пропонує нейронний, ключовий і гібридний режими пошуку з вбудованим витягуванням вмісту (виділення, текст, зведення).

​
Встановлення Plugin

Встановіть офіційний Plugin, потім перезапустіть Gateway: 
openclaw plugins install @openclaw/exa-plugin
openclaw gateway restart

​
Отримання API-ключа

1

Створіть обліковий запис

Зареєструйтеся на exa.ai і згенеруйте API-ключ зі своєї панелі керування.
2

Збережіть ключ

Задайте EXA_API_KEY у середовищі Gateway або налаштуйте через:
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",
      },
    },
  },
}
Альтернатива через середовище: задайте EXA_API_KEY у середовищі Gateway. Для встановлення gateway помістіть його в ~/.openclaw/.env.

​
Перевизначення базової URL-адреси

Задайте plugins.entries.exa.config.webSearch.baseUrl, коли пошукові запити Exa мають проходити через сумісний проксі або альтернативну кінцеву точку Exa. 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
  },
});
Параметр contentsТипОпис
textboolean | { maxCharacters }Витягнути повний текст сторінки
highlightsboolean | { maxCharacters, query, numSentences, highlightsPerUrl }Витягнути ключові речення
summaryboolean | { query }Зведення, згенероване ШІ

​
Режими пошуку

РежимОпис
autoExa вибирає найкращий режим (типово)
neuralСемантичний пошук на основі значення
fastШвидкий пошук за ключовими словами
deepРетельний глибокий пошук
deep-reasoningГлибокий пошук із міркуванням
instantНайшвидші результати

​
Примітки

  • Якщо параметр contents не надано, Exa типово використовує { highlights: true }, тож результати містять уривки ключових речень
  • Результати зберігають поля highlightScores і summary з відповіді Exa API, коли вони доступні
  • Описи результатів визначаються спочатку з виділень, потім зі зведення, потім із повного тексту — залежно від того, що доступно
  • freshness і date_after/date_before не можна поєднувати — використовуйте один режим фільтрації за часом
  • За один запит можна повернути до 100 результатів (залежно від обмежень типу пошуку Exa)
  • Результати типово кешуються на 15 хвилин (налаштовується через cacheTtlMinutes)
  • Exa — офіційна API-інтеграція зі структурованими JSON-відповідями

​
Пов’язане

  • Огляд Web Search — усі провайдери та автовиявлення
  • Brave Search — структуровані результати з фільтрами країни/мови
  • Perplexity Search — структуровані результати з фільтрацією за доменом