Tools

Поиск Exa

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

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

bash

openclaw plugins install @openclaw/exa-pluginopenclaw gateway restart

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

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

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

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

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

bash

openclaw configure --section web

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

json5

{  plugins: {    entries: {      exa: {        config: {          webSearch: {            apiKey: "exa-...", // необязательно, если задан EXA_API_KEY            baseUrl: "https://api.exa.ai", // необязательно; OpenClaw добавляет /search          },        },      },    },  },  tools: {    web: {      search: {        provider: "exa",      },    },  },}

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

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

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

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

querystringrequired

Поисковый запрос.

countnumberdefault: 5

Количество возвращаемых результатов (1–100, с учётом ограничений типа поиска Exa).

Режим поиска.

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

Фильтр по времени. Нельзя использовать вместе с date_after/date_before.

date_afterstring

Результаты после этой даты (YYYY-MM-DD).

date_beforestring

Результаты до этой даты (YYYY-MM-DD).

contentsobject

Параметры извлечения содержимого (см. ниже).

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

Передайте объект contents, чтобы управлять извлекаемым содержимым результатов:

javascript

await web_search({  query: "объяснение архитектуры трансформера",  type: "neural",  contents: {    text: true, // полный текст страницы    highlights: { numSentences: 3 }, // ключевые предложения    summary: true, // сводка, созданная ИИ  },});

Параметр содержимого	Тип	Описание
`text`	`boolean \| { maxCharacters }`	Извлечь полный текст страницы
`highlights`	`boolean \| { maxCharacters, query, numSentences, highlightsPerUrl }`	Извлечь ключевые предложения
`summary`	`boolean \| { query }`	Сводка, созданная ИИ

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

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

Режим	Описание
`auto`	Exa выбирает лучший режим (по умолчанию)
`neural`	Семантический поиск по смыслу
`fast`	Быстрый поиск по ключевым словам
`deep`	Тщательный глубокий поиск
`deep-reasoning`	Глубокий поиск с рассуждением
`instant`	Самое быстрое получение результатов

Примечания

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

См. также

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

Was this useful?