Búsqueda de SearXNG

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

Ventajas:

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

Configuración

openclaw plugins install @openclaw/searxng-plugin

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

openclaw configure --section web# Seleccione "searxng" como proveedor

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

Configuración

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

Configuración de la instancia de SearXNG en el nivel del Plugin:

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

baseUrl también acepta un objeto SecretRef (por ejemplo, { source: "env", id: "SEARXNG_BASE_URL" }).

Variable de entorno

Defina SEARXNG_BASE_URL como alternativa a la configuración:

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

Orden de resolución: la cadena baseUrl configurada, después una SecretRef de entorno insertada en baseUrl y, por último, SEARXNG_BASE_URL. Cuando no se ha definido ninguna de las rutas de configuración, SEARXNG_BASE_URL está presente y no se ha elegido un proveedor explícito, la detección automática selecciona SearXNG.

Referencia de configuración del Plugin

La llamada a la herramienta web_search también acepta count (entre 1 y 10 resultados), categories y language como valores de sustitución para cada llamada.

Notas

• API JSON -- usa el endpoint nativo format=json de SearXNG, no la extracción de HTML
• URL de resultados de imágenes -- los resultados de la categoría de imágenes incluyen img_src cuando SearXNG devuelve una URL directa de la imagen
• Sin clave de API -- funciona de inmediato con cualquier instancia de SearXNG
• Validación de la URL base -- baseUrl debe ser una URL http:// o https:// válida
• Protección de red -- las URL base http:// deben apuntar a un host privado de confianza o de local loopback (los hosts públicos deben usar https://); las URL base https:// que se resuelven a una dirección privada o interna reciben la misma autorización para servicios autoalojados, mientras que las URL base https:// que se resuelven públicamente mantienen una protección estricta contra SSRF
• Orden de detección automática -- SearXNG requiere una baseUrl configurada (orden 200 entre los proveedores que ya tienen las credenciales requeridas). Los proveedores sin clave, como DuckDuckGo u Ollama Web Search, nunca prevalecen de forma implícita en la detección automática; solo se activan mediante una elección explícita de provider
• Autoalojado -- usted controla la instancia, las consultas y los motores de búsqueda de origen
• Categorías usa general de forma predeterminada cuando no se configura
• Alternativa de categoría -- si una solicitud de una categoría distinta de general se completa correctamente, pero no devuelve resultados, OpenClaw vuelve a intentar la misma consulta una vez con general antes de devolver un conjunto de resultados vacío
• Almacenamiento en caché de resultados -- las consultas idénticas (misma consulta, cantidad, categorías, idioma y URL base) se almacenan en caché dentro del proceso durante un TTL breve
• Requisito de versión -- el Plugin declara minHostVersion: >=2026.6.9

Contenido relacionado

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