Herramientas web en OpenClaw: Búsqueda y extracción de contenido

Seguro te ha pasado: tu IA responde con datos de hace dos años o alucina porque no puede verificar un hecho actual. Integrar búsqueda web suele ser un dolor de cabeza, lleno de configuraciones pesadas y parsers que se rompen a la primera.

OpenClaw incluye dos herramientas ligeras para solucionar esto: web_search y web_fetch. No son herramientas de automatización de navegadores, sino utilidades directas para obtener datos limpios sin complicaciones.

Requisitos previos

OpenClaw instalado y funcionando.
Una API key de un proveedor compatible (Brave, Perplexity, Gemini, Grok o Kimi).
Acceso a la terminal para configurar el Gateway.
Node.js configurado en tu entorno.

Inicio rápido

Para activar la búsqueda web en menos de 5 minutos, sigue estos pasos:

Configura tu API key: Ejecuta el comando openclaw configure --section web en tu terminal.
Elige un proveedor: Te recomiendo Perplexity Search API si buscas resultados estructurados con filtros avanzados de fecha y dominio.
Llama a la herramienta: Una vez configurada, puedes usar web_search directamente.

Aquí tienes un ejemplo de cómo configurar Perplexity en tu archivo de configuración:

{
  tools: {
    web: {
      search: {
        enabled: true,
        provider: "perplexity",
        perplexity: {
          apiKey: "pplx-...", // opcional si PERPLEXITY_API_KEY está configurada
        },
      },
    },
  },
}

Proveedores de búsqueda

OpenClaw detecta automáticamente qué proveedor usar basándose en las llaves disponibles en tu entorno (siguiendo el orden: Brave, Gemini, Kimi, Perplexity, Grok).

Proveedor	Pros	API Key
Perplexity Search API	Rápido, resultados estructurados, filtros de dominio y frescura.	`PERPLEXITY_API_KEY`
Brave Search API	Rápido y estructurado.	`BRAVE_API_KEY`
Gemini	Google Search grounding, respuestas sintetizadas por IA.	`GEMINI_API_KEY`
Grok	Respuestas con grounding web de xAI.	`XAI_API_KEY`

Uso de Gemini (Google Search grounding)

Si prefieres respuestas sintetizadas con citas directas de Google, configura Gemini así:

{
  tools: {
    web: {
      search: {
        provider: "gemini",
        gemini: {
          apiKey: "AIza...",
          model: "gemini-2.5-flash",
        },
      },
    },
  },
}

Extracción de contenido con web_fetch

Cuando ya tienes una URL y necesitas el texto limpio, web_fetch entra en juego. Convierte HTML a markdown o texto plano usando Readability. Si una página se resiste, puedes activar Firecrawl como fallback.

Configuración de web_fetch:

{
  tools: {
    web: {
      fetch: {
        enabled: true,
        maxChars: 50000,
        timeoutSeconds: 30,
        cacheTtlMinutes: 15,
        firecrawl: {
          enabled: true,
          apiKey: "tu_api_key",
        },
      },
    },
  },
}

Ejemplo de uso de parámetros:

// Búsqueda específica en español y resultados recientes
await web_search({
  query: "noticias de IA",
  country: "ES",
  language: "es",
  freshness: "week",
});

// Extracción de una URL específica
await web_fetch({
  url: "https://ejemplo.com/articulo",
  extractMode: "markdown",
});

Solución de problemas

Error de API key: Si web_search falla, verifica que la variable de entorno (como BRAVE_API_KEY) esté cargada en el proceso del Gateway o definida en ~/.openclaw/.env.
Contenido vacío en web_fetch: Esta herramienta no ejecuta JavaScript. Si intentas leer un sitio que depende de frameworks de cliente o requiere login, usa la Browser tool.
Redirecciones bloqueadas: web_fetch bloquea por seguridad redirecciones a IPs privadas o internas. Revisa que la URL sea pública.
Resultados de búsqueda limitados: El parámetro count por defecto es 5. Puedes aumentarlo hasta 10 si necesitas más fuentes.

¿Necesitas ayuda con la configuración inicial? Prueba el AI Setup Assistant.

Próximos pasos

OpenClaw Expert

Sigues atascado?

Si esta pagina no resolvio tu caso, pregunta a OpenClaw Expert para pasos concretos.