Przejdź do głównej treści

​
Brave Search API

OpenClaw obsługuje Brave Search API jako providera web_search.

​
Pobierz klucz API

  1. Utwórz konto Brave Search API na stronie https://brave.com/search/api/
  2. W panelu wybierz plan Search i wygeneruj klucz API.
  3. Zapisz klucz w konfiguracji lub ustaw BRAVE_API_KEY w środowisku Gateway.

​
Przykład konfiguracji

{
  plugins: {
    entries: {
      brave: {
        config: {
          webSearch: {
            apiKey: "BRAVE_API_KEY_HERE",
            mode: "web", // lub "llm-context"
          },
        },
      },
    },
  },
  tools: {
    web: {
      search: {
        provider: "brave",
        maxResults: 5,
        timeoutSeconds: 30,
      },
    },
  },
}
Ustawienia wyszukiwania Brave specyficzne dla providera znajdują się teraz pod plugins.entries.brave.config.webSearch.*. Starsze tools.web.search.apiKey nadal jest ładowane przez warstwę zgodności, ale nie jest już kanoniczną ścieżką konfiguracji. webSearch.mode kontroluje transport Brave:
  • web (domyślnie): zwykłe wyszukiwanie internetowe Brave z tytułami, adresami URL i fragmentami
  • llm-context: Brave LLM Context API z wcześniej wyodrębnionymi fragmentami tekstu i źródłami do osadzania w kontekście

​
Parametry narzędzia

ParametrOpis
queryZapytanie wyszukiwania (wymagane)
countLiczba wyników do zwrócenia (1-10, domyślnie: 5)
country2-literowy kod kraju ISO (np. “US”, “DE”)
languageKod języka ISO 639-1 dla wyników wyszukiwania (np. “en”, “de”, “fr”)
search_langKod języka wyszukiwania Brave (np. en, en-gb, zh-hans)
ui_langKod języka ISO dla elementów interfejsu
freshnessFiltr czasu: day (24 h), week, month lub year
date_afterTylko wyniki opublikowane po tej dacie (YYYY-MM-DD)
date_beforeTylko wyniki opublikowane przed tą datą (YYYY-MM-DD)
Przykłady: 
// Wyszukiwanie specyficzne dla kraju i języka
await web_search({
  query: "renewable energy",
  country: "DE",
  language: "de",
});

// Ostatnie wyniki (ostatni tydzień)
await web_search({
  query: "AI news",
  freshness: "week",
});

// Wyszukiwanie w zakresie dat
await web_search({
  query: "AI developments",
  date_after: "2024-01-01",
  date_before: "2024-06-30",
});

​
Uwagi

  • OpenClaw używa planu Brave Search. Jeśli masz starszą subskrypcję (np. oryginalny plan Free z 2000 zapytań miesięcznie), nadal jest ona ważna, ale nie obejmuje nowszych funkcji, takich jak LLM Context czy wyższe limity szybkości.
  • Każdy plan Brave obejmuje 5 USD miesięcznie darmowego kredytu (odnawialnego). Plan Search kosztuje 5 USD za 1000 żądań, więc kredyt pokrywa 1000 zapytań miesięcznie. Ustaw limit użycia w panelu Brave, aby uniknąć nieoczekiwanych opłat. Aktualne plany znajdziesz w portalu Brave API.
  • Plan Search obejmuje endpoint LLM Context i prawa do inferencji AI. Przechowywanie wyników w celu trenowania lub dostrajania modeli wymaga planu z jawnymi prawami do przechowywania. Zobacz Warunki korzystania z usługi Brave.
  • Tryb llm-context zwraca wpisy źródeł osadzonych w kontekście zamiast zwykłego kształtu fragmentów wyników wyszukiwania internetowego.
  • Tryb llm-context nie obsługuje ui_lang, freshness, date_after ani date_before.
  • ui_lang musi zawierać podtag regionu, np. en-US.
  • Wyniki są domyślnie buforowane przez 15 minut (można to skonfigurować przez cacheTtlMinutes).

​
Powiązane