Búsqueda de SearXNG

OpenClaw admite SearXNG como proveedor de web_search autoalojado y sin clave. SearXNG es un motor de metabúsqueda de código abierto que agrega resultados de Google, Bing, DuckDuckGo y otras fuentes.

Ventajas:

• Gratis e ilimitado -- no se requiere clave de API ni suscripción comercial
• Privacidad / aislamiento de red -- las consultas nunca salen de tu red
• Funciona en cualquier lugar -- sin restricciones regionales en las API comerciales de búsqueda

# Configuración

docker run -d -p 8888:8080 searxng/searxng

openclaw configure --section web
# Select "searxng" as the provider

export SEARXNG_BASE_URL="http://localhost:8888"

# Configuración

{
  tools: {
    web: {
      search: {
        provider: "searxng",
      },
    },
  },
}

Configuración de nivel de Plugin para la instancia de SearXNG:

{
  plugins: {
    entries: {
      searxng: {
        config: {
          webSearch: {
            baseUrl: "http://localhost:8888",
            categories: "general,news", // optional
            language: "en", // optional
          },
        },
      },
    },
  },
}

El campo baseUrl también acepta objetos SecretRef.

Reglas de transporte:

• https:// funciona para hosts SearXNG públicos o privados
• http:// solo se acepta para hosts de red privada de confianza o de loopback
• los hosts SearXNG públicos deben usar https://
• los hosts privados/internos usan la protección de red autoalojada; los hosts públicos https:// permanecen en la protección estricta de búsqueda web y no pueden redirigir a direcciones privadas

# Variable de entorno

Define SEARXNG_BASE_URL como alternativa a la configuración:

export SEARXNG_BASE_URL="http://localhost:8888"

Cuando SEARXNG_BASE_URL está definida y no hay ningún proveedor explícito configurado, la detección automática elige SearXNG automáticamente (con la prioridad más baja -- cualquier proveedor respaldado por API con una clave gana primero).

# Referencia de configuración del Plugin

# Notas

• API JSON -- usa el endpoint nativo format=json de SearXNG, no extracción de HTML
• URL de resultados de imagen -- los resultados de categoría de imagen incluyen img_src cuando SearXNG devuelve una URL directa de imagen
• Sin clave de API -- funciona con cualquier instancia de SearXNG desde el principio
• Validación de URL base -- baseUrl debe ser una URL http:// o https:// válida; los hosts públicos deben usar https://
• Protección de red -- los endpoints SearXNG privados/internos optan por el acceso a red privada; los endpoints SearXNG públicos https:// mantienen una protección SSRF estricta
• Orden de detección automática -- SearXNG se comprueba al final (orden 200) en la detección automática. Los proveedores respaldados por API con claves configuradas se ejecutan primero, luego DuckDuckGo (orden 100) y luego Ollama Web Search (orden 110)
• Autoalojado -- tú controlas la instancia, las consultas y los motores de búsqueda ascendentes
• Categorías usa general de forma predeterminada cuando no está configurado
• Reserva de categoría -- si una solicitud de categoría que no es general se completa correctamente pero devuelve cero resultados, OpenClaw reintenta la misma consulta una vez con general antes de devolver un conjunto de resultados vacío

# Relacionado

• Descripción general de búsqueda web -- todos los proveedores y la detección automática
• Búsqueda de DuckDuckGo -- otra alternativa sin clave
• Búsqueda de Brave -- resultados estructurados con nivel gratuito