Tools

Поиск Brave

OpenClaw поддерживает Brave Search API как провайдера web_search.

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

Создайте учётную запись Brave Search API на странице https://brave.com/search/api/
На панели управления выберите план Search и создайте ключ API.
Сохраните ключ в конфигурации или задайте BRAVE_API_KEY в окружении Gateway.

Пример конфигурации

json5

{  plugins: {    entries: {      brave: {        config: {          webSearch: {            apiKey: "BRAVE_API_KEY_HERE",            mode: "web", // или "llm-context"            baseUrl: "https://api.search.brave.com", // необязательное переопределение прокси/базового URL          },        },      },    },  },  tools: {    web: {      search: {        provider: "brave",        maxResults: 5,        timeoutSeconds: 30,      },    },  },}

Настройки поиска Brave, относящиеся к этому провайдеру, находятся в plugins.entries.brave.config.webSearch.*; это канонический путь конфигурации. Общий параметр верхнего уровня tools.web.search.apiKey и параметр с ограниченной областью действия tools.web.search.brave.* по-прежнему загружаются посредством объединения для совместимости, но в новой конфигурации следует использовать указанный выше путь в области плагина.

webSearch.mode управляет транспортом Brave:

web (по умолчанию): обычный веб-поиск Brave с заголовками, URL-адресами и фрагментами
llm-context: Brave LLM Context API с предварительно извлечёнными фрагментами текста и источниками для привязки ответа к фактам

webSearch.baseUrl позволяет направлять запросы Brave через доверенный совместимый с Brave прокси-сервер или шлюз. OpenClaw добавляет /res/v1/web/search или /res/v1/llm/context к настроенному базовому URL и включает базовый URL в ключ кэша. Для общедоступных конечных точек необходимо использовать https://; http:// допускается только для доверенных прокси-серверов на интерфейсе обратной петли или в частной сети.

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

querystringrequired

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

countnumberdefault: 5

Количество возвращаемых результатов (1–10).

countrystring

Двухбуквенный код страны ISO (например, US, DE).

languagestring

Код языка ISO 639-1 для результатов поиска (например, en, de, fr).

search_langstring

Код языка поиска Brave (например, en, en-gb, zh-hans).

ui_langstring

Код языка ISO для элементов интерфейса.

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

Фильтр по времени — day означает 24 часа.

date_afterstring

Только результаты, опубликованные после этой даты (YYYY-MM-DD).

date_beforestring

Только результаты, опубликованные до этой даты (YYYY-MM-DD).

Примеры:

javascript

// Поиск с учётом страны и языкаawait web_search({  query: "возобновляемая энергия",  country: "DE",  language: "de",}); // Недавние результаты (за последнюю неделю)await web_search({  query: "новости ИИ",  freshness: "week",}); // Поиск по диапазону датawait web_search({  query: "развитие ИИ",  date_after: "2024-01-01",  date_before: "2024-06-30",});

Примечания

OpenClaw использует план Brave Search. Если у вас есть устаревшая подписка (например, первоначальный бесплатный план с 2 000 запросов в месяц), она остаётся действительной, но не включает новые возможности, такие как LLM Context или более высокие ограничения частоты запросов.
Каждый план Brave включает бесплатный возобновляемый кредит в размере $5 в месяц. План Search стоит $5 за 1 000 запросов, поэтому кредит покрывает 1 000 запросов в месяц. Установите ограничение использования на панели управления Brave, чтобы избежать непредвиденных расходов. Актуальные планы см. на портале Brave API.
План Search включает конечную точку LLM Context и права на выполнение ИИ-инференса. Для хранения результатов с целью обучения или настройки моделей требуется план, явно предоставляющий права на хранение. См. Условия предоставления услуг Brave.
Режим llm-context возвращает записи с подтверждающими источниками вместо обычной структуры фрагментов веб-поиска.
Режим llm-context поддерживает freshness и ограниченные диапазоны date_after + date_before. Он не поддерживает ui_lang; значение date_before без date_after отклоняется, поскольку Brave требует, чтобы пользовательские диапазоны актуальности включали начальную и конечную даты.
ui_lang должен включать подтег региона, например en-US.
По умолчанию результаты кэшируются на 15 минут (настраивается с помощью cacheTtlMinutes).
Пользовательские значения webSearch.baseUrl включаются в идентификатор кэша Brave, поэтому ответы разных прокси-серверов не конфликтуют.
Включите диагностический флаг brave.http, чтобы при устранении неполадок журналировать URL-адреса и параметры запросов Brave, состояние и длительность ответов, а также события попадания, промаха и записи кэша поиска. Флаг никогда не журналирует ключ API или тела ответов, однако поисковые запросы могут содержать конфиденциальные данные.

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

Обзор веб-поиска -- все провайдеры и автоматическое обнаружение
Поиск Perplexity -- структурированные результаты с фильтрацией по доменам
Поиск Exa -- нейронный поиск с извлечением содержимого

Was this useful?