Ir al contenido
OpenClaw Docs

Brave Search

API de Brave Search

Sección titulada «API de Brave Search»

OpenClaw admite la API de Brave Search como proveedor web_search.

Obtener una clave de API

Sección titulada «Obtener una clave de API»
  1. Cree una cuenta de API de Brave Search en https://brave.com/search/api/
  2. En el panel, elija el plan Search y genere una clave de API.
  3. Guarde la clave en la configuración o configure BRAVE_API_KEY en el entorno de Gateway.

Ejemplo de configuración

Sección titulada «Ejemplo de configuración»
{
  plugins: {
    entries: {
      brave: {
        config: {
          webSearch: {
            apiKey: "BRAVE_API_KEY_HERE",
            mode: "web", // or "llm-context"
          },
        },
      },
    },
  },
  tools: {
    web: {
      search: {
        provider: "brave",
        maxResults: 5,
        timeoutSeconds: 30,
      },
    },
  },
}

La configuración específica de búsqueda de Brave ahora reside en plugins.entries.brave.config.webSearch.*. El tools.web.search.apiKey heredado todavía se carga a través de la capa de compatibilidad, pero ya no es la ruta de configuración canónica.

webSearch.mode controla el transporte de Brave:

  • web (predeterminado): búsqueda web normal de Brave con títulos, URL y fragmentos
  • llm-context: API de contexto LLM de Brave con fragmentos de texto preextraídos y fuentes para la fundamentación

Parámetros de la herramienta

Sección titulada «Parámetros de la herramienta»
ParámetroDescripción
queryConsulta de búsqueda (obligatorio)
countNúmero de resultados a devolver (1-10, predeterminado: 5)
countryCódigo de país ISO de 2 letras (por ejemplo, “US”, “DE”)
languageCódigo de idioma ISO 639-1 para los resultados de búsqueda (por ejemplo, “en”, “de”, “fr”)
search_langCódigo de idioma de búsqueda de Brave (por ejemplo, en, en-gb, zh-hans)
ui_langCódigo de idioma ISO para elementos de la interfaz de usuario
freshnessFiltro de tiempo: day (24h), week, month o year
date_afterSolo resultados publicados después de esta fecha (AAAA-MM-DD)
date_beforeSolo resultados publicados antes de esta fecha (AAAA-MM-DD)

Ejemplos:

// 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",
});

Notas

Sección titulada «Notas»
  • OpenClaw utiliza el plan Search de Brave. Si tiene una suscripción heredada (por ejemplo, el plan Free original con 2.000 consultas/mes), sigue siendo válida pero no incluye funciones más nuevas como el contexto LLM o límites de tasa más altos.
  • Cada plan de Brave incluye $5/mes en crédito gratuito (renovable). El plan Search cuesta $5 por cada 1.000 solicitudes, por lo que el crédito cubre 1.000 consultas/mes. Establezca su límite de uso en el panel de Brave para evitar cargos inesperados. Consulte el portal de la API de Brave para conocer los planes actuales.
  • El plan Search incluye el punto final de contexto LLM y derechos de inferencia de IA. Almacenar resultados para entrenar o ajustar modelos requiere un plan con derechos de almacenamiento explícitos. Vea los Términos de servicio de Brave.
  • El modo llm-context devuelve entradas de fuente fundamentadas en lugar de la forma normal de fragmento de búsqueda web.
  • El modo llm-context no admite ui_lang, freshness, date_after o date_before.
  • ui_lang debe incluir una subetiqueta de región como en-US.
  • Los resultados se almacenan en caché durante 15 minutos de forma predeterminada (configurable mediante cacheTtlMinutes).

Relacionado

Sección titulada «Relacionado»