Tools

Поиск Exa

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

Установка Plugin

Установите официальный Plugin, затем перезапустите Gateway:

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-...", // 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, чтобы включить:

javascript

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-ответами

Связанные материалы

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

Was this useful?