Перейти до основного вмісту

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 підтримує Exa AI як постачальника web_search. Exa пропонує нейронний, ключовий і гібридний режими пошуку з вбудованим витягуванням вмісту (виділення, текст, резюме).

​
Отримання ключа 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

​
Пов’язане

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