Búsqueda de SearXNG

OpenClaw admite SearXNG como proveedor 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 la 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 un SecretRef de entorno insertado en baseUrl y, por último, SEARXNG_BASE_URL. Cuando no se establece ninguna de las rutas de configuración y SEARXNG_BASE_URL está presente sin que se haya elegido explícitamente un proveedor, la detección automática selecciona SearXNG.

Referencia de configuración del plugin

La llamada a la herramienta web_search también acepta count (1-10 resultados), categories y language como valores de reemplazo por 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 bucle invertido (los hosts públicos deben usar https://); las URL base https:// que se resuelven en una dirección privada o interna reciben la misma concesión para autoalojamiento, mientras que las URL base https:// que se resuelven públicamente mantienen una protección SSRF estricta
• Orden de detección automática: SearXNG requiere un baseUrl configurado (orden 200 entre los proveedores que ya disponen de la credencial requerida). Los proveedores sin clave, como DuckDuckGo u Ollama Web Search, nunca se imponen implícitamente en la detección automática; solo se activan al elegir explícitamente provider
• Autoalojado: se controlan la instancia, las consultas y los motores de búsqueda ascendentes
• Categorías: el valor predeterminado es general cuando no se configuran
• Alternativa de categoría: si una solicitud de 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