​

API de Brave Search

​

Obtener una API key

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

​

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,
      },
    },
  },
}

• web (predeterminado): búsqueda web normal de Brave con títulos, URL y fragmentos
• llm-context: API LLM Context de Brave con fragmentos de texto extraídos previamente y fuentes para grounding

​

Parámetros de la herramienta

// 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

• OpenClaw usa el plan Search de Brave. Si tienes 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 LLM Context ni 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. Establece 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 LLM Context y derechos de inferencia de IA. Almacenar resultados para entrenar o ajustar modelos requiere un plan con derechos de almacenamiento explícitos. Consulta las Condiciones del servicio de Brave.
• El modo llm-context devuelve entradas de fuentes con grounding en lugar del formato normal de fragmentos de búsqueda web.
• El modo llm-context no admite ui_lang, freshness, date_after ni 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

• Resumen de Web Search — todos los proveedores y detección automática
• Perplexity Search — resultados estructurados con filtrado por dominio
• Exa Search — búsqueda neuronal con extracción de contenido