Перейти к основному содержанию
OpenClaw поддерживает Brave Search API как провайдер web_search.

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

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

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

{
  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 или прокси-хостов в частной сети.

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

​
query
string
обязательно
Поисковый запрос.
​
count
number
по умолчанию:"5"
Количество результатов для возврата (1–10).
​
country
string
Двухбуквенный код страны ISO (например, US, DE).
​
language
string
Код языка ISO 639-1 для результатов поиска (например, en, de, fr).
​
search_lang
string
Код языка поиска Brave (например, en, en-gb, zh-hans).
​
ui_lang
string
Код языка ISO для элементов UI.
​
freshness
'day' | 'week' | 'month' | 'year'
Фильтр по времени — day означает 24 часа.
​
date_after
string
Только результаты, опубликованные после этой даты (YYYY-MM-DD).
​
date_before
string
Только результаты, опубликованные до этой даты (YYYY-MM-DD).
Примеры: 
// Country and language-specific search
await web_search({
  query: "renewable energy",
  country: "DE",
  language: "de",
});

// Recent results (past week)
await web_search({
  query: "AI news",
  freshness: "week",
});

// Date range search
await 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 — нейронный поиск с извлечением контента