Skip to main content
Exa AI — провайдер web_search с нейронным, ключевым и гибридным режимами поиска, а также встроенным извлечением содержимого (выделенные фрагменты, текст, сводки).

​
Установка плагина

​
Получение ключа API

1

Создание учётной записи

Зарегистрируйтесь на exa.ai и создайте ключ API в своей панели управления.
2

Сохранение ключа

Задайте EXA_API_KEY в окружении Gateway или настройте его с помощью:

​
Конфигурация

Альтернатива через переменную окружения: задайте EXA_API_KEY в окружении Gateway. При установке Gateway поместите её в ~/.openclaw/.env. См. Переменные окружения.

​
Переопределение базового URL

Задайте plugins.entries.exa.config.webSearch.baseUrl, чтобы направлять поисковые запросы Exa через совместимый прокси-сервер или альтернативную конечную точку. OpenClaw нормализует адреса без схемы, добавляя в начало https://, и добавляет /search, если путь ещё не оканчивается на него. Разрешённая конечная точка входит в ключ кеша поиска, поэтому результаты от разных конечных точек никогда не используются совместно.

​
Параметры инструмента

​
string
обязательно
Поисковый запрос.
​
number
по умолчанию:"5"
Количество возвращаемых результатов (1–100, с учётом ограничений типа поиска Exa).
​
'auto' | 'neural' | 'fast' | 'deep' | 'deep-reasoning' | 'instant'
Режим поиска.
​
'day' | 'week' | 'month' | 'year'
Фильтр по времени. Нельзя использовать вместе с date_after/date_before.
​
string
Результаты после этой даты (YYYY-MM-DD).
​
string
Результаты до этой даты (YYYY-MM-DD).
​
object
Параметры извлечения содержимого (см. ниже).

​
Извлечение содержимого

Передайте объект contents, чтобы управлять извлекаемым содержимым результатов:
Если contents не указан, Exa по умолчанию использует { highlights: true }, поэтому результаты содержат выдержки из ключевых предложений. Описания результатов формируются сначала из выделенных фрагментов, затем из сводки, а затем из полного текста — используется первый доступный вариант. Результаты также сохраняют необработанные поля highlightScores и summary из ответа API Exa, если они доступны.

​
Режимы поиска

​
Примечания

  • count принимает значения до 100 с учётом ограничений типа поиска Exa.
  • По умолчанию результаты кешируются на 15 минут. Настройте общие параметры tools.web.search.cacheTtlMinutes (в минутах) и tools.web.search.timeoutSeconds (по умолчанию 30 с), чтобы изменить кеширование и время ожидания запросов для всех провайдеров web_search, включая Exa.

​
См. также

  • Обзор веб-поиска — все провайдеры и автоматическое определение
  • Brave Search — структурированные результаты с фильтрами по стране и языку
  • Perplexity Search — структурированные результаты с фильтрацией по доменам