Tools

Пошук Exa

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

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

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

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

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

Установіть 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 не спільно використовуються.

Параметри інструмента

querystringrequired

Пошуковий запит.

countnumber

Кількість результатів для повернення (1–100).

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

freshness'day' | 'week' | 'month' | 'year'

Фільтр часу.

date_afterstring

Результати після цієї дати (YYYY-MM-DD).

date_beforestring

Результати до цієї дати (YYYY-MM-DD).

contentsobject

Параметри витягування вмісту (див. нижче).

Витягування вмісту

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	Тип	Опис
`text`	`boolean \| { maxCharacters }`	Витягнути повний текст сторінки
`highlights`	`boolean \| { maxCharacters, query, numSentences, highlightsPerUrl }`	Витягнути ключові речення
`summary`	`boolean \| { query }`	Згенероване ШІ резюме

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

Режим	Опис
`auto`	Exa вибирає найкращий режим (типово)
`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 -- структуровані результати з фільтрацією за доменом

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

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

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

# Конфігурація

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

# Параметри інструмента

# Витягування вмісту

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

# Примітки

# Пов’язане