Tools

Пошук Exa

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

Установлення Plugin

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: "transformer architecture explained",  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?