Saltar al contenido principal

​
Búsqueda con SearXNG

OpenClaw es compatible con SearXNG como proveedor de web_search autoalojado y sin claves. 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 requiere clave API ni suscripción comercial
  • Privacidad / entorno aislado — las consultas nunca salen de tu red
  • Funciona en cualquier lugar — sin restricciones regionales de las API de búsqueda comerciales

​
Configuración

1

Ejecuta una instancia de SearXNG

docker run -d -p 8888:8080 searxng/searxng
O usa cualquier implementación existente de SearXNG a la que tengas acceso. Consulta la documentación de SearXNG para una configuración de producción.
2

Configura

openclaw configure --section web
# Select "searxng" as the provider
O establece la variable de entorno y deja que la detección automática la encuentre:
export SEARXNG_BASE_URL="http://localhost:8888"

​
Configuración

{
  tools: {
    web: {
      search: {
        provider: "searxng",
      },
    },
  },
}
Ajustes a 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 de SearXNG públicos o privados
  • http:// solo se acepta para hosts de red privada de confianza o loopback
  • los hosts públicos de SearXNG deben usar https://

​
Variable de entorno

Establece SEARXNG_BASE_URL como alternativa a la configuración: 
export SEARXNG_BASE_URL="http://localhost:8888"
Cuando SEARXNG_BASE_URL está establecida y no hay ningún proveedor configurado explícitamente, la detección automática selecciona SearXNG automáticamente (con la prioridad más baja — cualquier proveedor respaldado por API con clave gana primero).

​
Referencia de configuración del plugin

CampoDescripción
baseUrlURL base de tu instancia de SearXNG (obligatorio)
categoriesCategorías separadas por comas como general, news o science
languageCódigo de idioma para los resultados, como en, de o fr

​
Notas

  • API JSON — usa el endpoint nativo format=json de SearXNG, no scraping HTML
  • Sin clave API — funciona con cualquier instancia de SearXNG desde el primer momento
  • Validación de URL base — baseUrl debe ser una URL válida http:// o https://; los hosts públicos deben usar https://
  • 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 después Ollama Web Search (orden 110)
  • Autoalojado — tú controlas la instancia, las consultas y los motores de búsqueda ascendentes
  • categories usa general por defecto cuando no está configurado
Para que la API JSON de SearXNG funcione, asegúrate de que tu instancia de SearXNG tenga habilitado el formato json en settings.yml bajo search.formats.

​
Relacionado