Herramientas Web

OpenClaw incluye dos herramientas web ligeras:

- ''web_search'' — Busca en la web via Brave Search API (predeterminado) o Perplexity Sonar (directo o via OpenRouter).

- ''web_fetch'' — Obtención HTTP + extracción legible (HTML → markdown/texto).

Estas no son automatización de navegador. Para sitios con mucho JS o logins, usa la

''Herramienta de Navegador''.

- ''web_search'' llama a tu proveedor configurado y retorna resultados.

- Brave (predeterminado): retorna resultados estructurados (título, URL, fragmento).

- Perplexity: retorna respuestas sintetizadas por IA con citas de búsqueda web en tiempo real.

- Los resultados se cachean por consulta durante 15 minutos (configurable).

- ''web_fetch'' hace un HTTP GET simple y extrae contenido legible

(HTML → markdown/texto). No ejecuta JavaScript.

- ''web_fetch'' está habilitado por defecto (a menos que se deshabilite explícitamente).

| Proveedor | Pros | Contras | Clave API |

| - | -- | -- |

| ''perplexity/sonar'' | Q&A rápido con búsqueda web | Búsquedas rápidas |

| ''perplexity/sonar-pro'' (predeterminado) | Razonamiento multi-paso con búsqueda web | Preguntas complejas |

| ''perplexity/sonar-reasoning-pro'' | Análisis de cadena de pensamiento | Investigación profunda |

Busca en la web usando tu proveedor configurado.

- ''tools.web.search.enabled'' no debe ser ''false'' (predeterminado: habilitado)

- Clave API para tu proveedor elegido:

- ''Brave'': ''BRAVE_API_KEY'' o ''tools.web.search.apiKey''

- ''Perplexity'': ''OPENROUTER_API_KEY'', ''PERPLEXITY_API_KEY'', o ''tools.web.search.perplexity.apiKey''

- ''query'' (requerido)

- ''count'' (1–10; predeterminado desde config)

- ''country'' (opcional): código de país de 2 letras para resultados específicos de región (ej., "DE", "US", "ALL"). Si se omite, Brave elige su región predeterminada.

- ''search_lang'' (opcional): código de idioma ISO para resultados de búsqueda (ej., "de", "en", "fr")

- ''ui_lang'' (opcional): código de idioma ISO para elementos de UI

- ''freshness'' (opcional, solo Brave): filtrar por tiempo de descubrimiento (''pd'', ''pw'', ''pm'', ''py'', o ''YYYY-MM-DDtoYYYY-MM-DD'')

Ejemplos:

// Búsqueda específica de alemán
await web_search('{'
  query: "TV online schauen",
  count: 10,
  country: "DE",
  search_lang: "de",
'}');

// Búsqueda en francés con UI en francés
await web_search('{'
  query: "actualités",
  country: "FR",
  search_lang: "fr",
  ui_lang: "fr",
'}');

// Resultados recientes (última semana)
await web_search('{'
  query: "TMBG interview",
  freshness: "pw",
'}');

Obtiene una URL y extrae contenido legible.

- ''tools.web.fetch.enabled'' no debe ser ''false'' (predeterminado: habilitado)

- Fallback opcional de Firecrawl: establece ''tools.web.fetch.firecrawl.apiKey'' o ''FIRECRAWL_API_KEY''.

- ''url'' (requerido, solo http/https)

- ''extractMode'' (''markdown'' | ''text'')

- ''maxChars'' (truncar páginas largas)

Notas:

- ''web_fetch'' usa Readability (extracción de contenido principal) primero, luego Firecrawl (si está configurado). Si ambos fallan, la herramienta retorna un error.

- Las solicitudes de Firecrawl usan modo de elusión de bots y cachean resultados por defecto.

- ''web_fetch'' envía un User-Agent tipo Chrome y ''Accept-Language'' por defecto; anula ''userAgent'' si es necesario.

- ''web_fetch'' bloquea hostnames privados/internos y re-verifica redirecciones (limita con ''maxRedirects'').

- ''web_fetch'' es extracción de mejor esfuerzo; algunos sitios necesitarán la herramienta de navegador.

- Ver ''Firecrawl'' para configuración de claves y detalles del servicio.

- Las respuestas se cachean (predeterminado 15 minutos) para reducir obtenciones repetidas.

- Si usas perfiles de herramienta/listas permitidas, añade ''web_search''/''web_fetch'' o ''group:web''.

- Si falta la clave de Brave, ''web_search'' retorna una breve pista de configuración con un enlace a docs.