Skip to main content
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

1

Instalar el plugin

2

Ejecutar una instancia de SearXNG

También se puede usar cualquier implementación existente de SearXNG a la que se tenga acceso. Consulte la documentación de SearXNG para la configuración en producción.
3

Configurar

También se puede definir la variable de entorno y dejar que la detección automática la encuentre:

​
Configuración

Configuración de la instancia de SearXNG en el nivel del plugin:
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:
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
Para que funcione la API JSON de SearXNG, asegúrese de que la instancia de SearXNG tenga habilitado el formato json en su settings.yml, dentro de search.formats.

​
Contenido relacionado