Перейти к основному содержанию
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 — структурированные результаты с фильтрацией по доменам