Saltar al contenido principal

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

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

1

Run a SearXNG instance

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

Configure

openclaw configure --section web
# Select "searxng" as the provider
O define 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",
      },
    },
  },
}
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

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 resultados como en, de o fr

​
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
Para que la API JSON de SearXNG funcione, asegúrate de que tu instancia de SearXNG tenga el formato json habilitado en su settings.yml, bajo search.formats.

​
Relacionado