API de Brave Search

OpenClaw soporta la API de Brave Search como proveedor de web_search.

Obtener una clave API

Crea una cuenta de Brave Search API en https://brave.com/search/api/
En el panel de control, elige el plan Search y genera una clave API.
Guarda la clave en la configuración o establece BRAVE_API_KEY en el entorno del Gateway.

Ejemplo de configuración

{
  tools: {
    web: {
      search: {
        provider: "brave",
        apiKey: "BRAVE_API_KEY_HERE",
        maxResults: 5,
        timeoutSeconds: 30,
      },
    },
  },
}

Parámetros de la herramienta

Parámetro	Descripción
`query`	Consulta de búsqueda (obligatorio)
`count`	Número de resultados a devolver (1-10, por defecto: 5)
`country`	Código de país ISO de 2 letras (ej., “US”, “DE”)
`language`	Código de idioma ISO 639-1 para los resultados (ej., “en”, “de”, “fr”)
`ui_lang`	Código de idioma ISO para elementos de la interfaz
`freshness`	Filtro temporal: `day` (24h), `week`, `month` o `year`
`date_after`	Solo resultados publicados después de esta fecha (YYYY-MM-DD)
`date_before`	Solo resultados publicados antes de esta fecha (YYYY-MM-DD)

Ejemplos:

// Búsqueda por país e idioma
await web_search({
  query: "renewable energy",
  country: "DE",
  language: "de",
});

// Resultados recientes (última semana)
await web_search({
  query: "AI news",
  freshness: "week",
});

// Búsqueda por rango de fechas
await web_search({
  query: "AI developments",
  date_after: "2024-01-01",
  date_before: "2024-06-30",
});

Notas

OpenClaw usa el plan Search de Brave. Si tienes una suscripción anterior (por ejemplo, el plan Free original con 2.000 consultas/mes), sigue siendo válida pero no incluye funcionalidades más recientes como LLM Context o límites de tasa más altos.
Cada plan de Brave incluye $5/mes de crédito gratuito (renovable). El plan Search cuesta $5 por cada 1.000 solicitudes, así que el crédito cubre 1.000 consultas/mes. Configura tu límite de uso en el panel de Brave para evitar cargos inesperados. Consulta el portal de la API de Brave para ver los planes actuales.
El plan Search incluye el endpoint de LLM Context y los derechos de inferencia de IA. Almacenar resultados para entrenar o ajustar modelos requiere un plan con derechos explícitos de almacenamiento. Consulta los Términos de servicio de Brave.
Los resultados se cachean durante 15 minutos por defecto (configurable con cacheTtlMinutes).

Consulta Web tools para la configuración completa de web_search.