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", // or "llm-context"            baseUrl: "https://api.search.brave.com", // optional proxy/base URL override          },        },      },    },  },  tools: {    web: {      search: {        provider: "brave",        maxResults: 5,        timeoutSeconds: 30,      },    },  },}

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

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:// принимается только для доверенного loopback или прокси-хостов в частной сети.

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

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 для элементов UI.

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

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

date_afterstring

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

date_beforestring

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

Примеры:

javascript

// Country and language-specific searchawait web_search({  query: "renewable energy",  country: "DE",  language: "de",}); // Recent results (past week)await web_search({  query: "AI news",  freshness: "week",}); // Date range searchawait web_search({  query: "AI developments",  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 и права на AI inference. Для сохранения результатов с целью обучения или настройки моделей требуется план с явными правами на хранение. См. Условия обслуживания 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 или тела ответов, но поисковые запросы могут быть чувствительными.

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

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

Was this useful?