Búsqueda de Brave

​

Obtener una clave de API

1. Crea una cuenta de Brave Search API en https://brave.com/search/api/
2. En el panel, elige el plan Search y genera una clave de API.
3. Guarda la clave en la configuración o define 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"
            baseUrl: "https://api.search.brave.com", // optional proxy/base URL override
          },
        },
      },
    },
  },
  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: Brave LLM Context API con fragmentos de texto y fuentes preextraídos para fundamentación

​

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 2000 consultas/mes), sigue siendo válida, pero no incluye funciones más recientes como LLM Context ni límites de frecuencia más altos.
• Cada plan de Brave incluye $5/mes en crédito gratuito (renovable). El plan Search cuesta $5 por cada 1000 solicitudes, por lo que el crédito cubre 1000 consultas/mes. Define tu límite de uso en el panel de Brave para evitar cargos inesperados. Consulta el portal de API de Brave para ver los planes actuales.
• El plan Search incluye el endpoint de 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 los Términos de servicio de Brave.
• El modo llm-context devuelve entradas de fuentes fundamentadas en lugar del formato normal de fragmento de búsqueda web.
• El modo llm-context admite freshness y rangos acotados de date_after + date_before. No admite ui_lang; date_before sin date_after se rechaza porque Brave requiere que los rangos de actualización personalizados incluyan fecha de inicio y fecha de fin.
• ui_lang debe incluir un subcódigo regional como en-US.
• Los resultados se almacenan en caché durante 15 minutos de forma predeterminada (configurable mediante cacheTtlMinutes).
• Los valores personalizados de webSearch.baseUrl se incluyen en la identidad de caché de Brave, por lo que las respuestas específicas del proxy no entran en conflicto.
• Activa la marca de diagnóstico brave.http para registrar las URL/parámetros de consulta de las solicitudes de Brave, el estado/tiempo de respuesta y los eventos de acierto/fallo/escritura de la caché de búsqueda durante la solución de problemas. La marca nunca registra la clave de API ni los cuerpos de respuesta, pero las consultas de búsqueda pueden ser sensibles.

​

Relacionado

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