> ## Documentation Index
> Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Firecrawl

OpenClaw puede usar **Firecrawl** de tres formas:

* como proveedor de `web_search`
* como herramientas explícitas del Plugin: `firecrawl_search` y `firecrawl_scrape`
* como extractor de reserva para `web_fetch`

Es un servicio alojado de extracción/búsqueda que admite evasión de bots y almacenamiento en caché, lo que ayuda con sitios con mucho JS o páginas que bloquean las recuperaciones HTTP simples.

## Instalar Plugin

Instala el Plugin oficial y luego reinicia Gateway:

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw plugins install @openclaw/firecrawl-plugin
openclaw gateway restart
```

## web\_fetch sin clave y claves de API

La reserva `web_fetch` alojada de Firecrawl seleccionada explícitamente admite acceso inicial sin una clave de API. Añade `FIRECRAWL_API_KEY` en el entorno del gateway o configúrala cuando necesites límites más altos. `web_search` de Firecrawl y `firecrawl_scrape` requieren una clave de API.

## Configurar la búsqueda de Firecrawl

```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
{
  tools: {
    web: {
      search: {
        provider: "firecrawl",
      },
    },
  },
  plugins: {
    entries: {
      firecrawl: {
        enabled: true,
        config: {
          webSearch: {
            apiKey: "FIRECRAWL_API_KEY_HERE",
            baseUrl: "https://api.firecrawl.dev",
          },
        },
      },
    },
  },
}
```

Notas:

* Elegir Firecrawl en la incorporación o `openclaw configure --section web` activa automáticamente el Plugin de Firecrawl instalado.
* `web_search` con Firecrawl admite `query` y `count`.
* Para controles específicos de Firecrawl como `sources`, `categories` o extracción de resultados, usa `firecrawl_search`.
* `baseUrl` usa de forma predeterminada Firecrawl alojado en `https://api.firecrawl.dev`. Las sobrescrituras autoalojadas solo se permiten para puntos de conexión privados/internos; HTTP solo se acepta para esos destinos privados.
* `FIRECRAWL_BASE_URL` es la reserva de entorno compartida para las URL base de búsqueda y extracción de Firecrawl.
* Las solicitudes de búsqueda de Firecrawl tienen un tiempo de espera predeterminado de 30 segundos; el parámetro `timeoutSeconds` de `firecrawl_search` lo sobrescribe por llamada.

## Configurar la reserva web\_fetch de Firecrawl

```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
{
  tools: {
    web: {
      fetch: {
        provider: "firecrawl", // explicit selection enables keyless fallback
      },
    },
  },
  plugins: {
    entries: {
      firecrawl: {
        enabled: true,
        config: {
          webFetch: {
            baseUrl: "https://api.firecrawl.dev",
            onlyMainContent: true,
            maxAgeMs: 172800000,
            timeoutSeconds: 60,
          },
        },
      },
    },
  },
}
```

Notas:

* La reserva `web_fetch` de Firecrawl seleccionada explícitamente funciona sin una clave de API. Cuando está configurada, OpenClaw envía `plugins.entries.firecrawl.config.webFetch.apiKey` o `FIRECRAWL_API_KEY` para límites más altos.
* Elegir Firecrawl durante la incorporación o `openclaw configure --section web` activa el Plugin y selecciona Firecrawl para `web_fetch`, salvo que ya haya otro proveedor de recuperación configurado.
* `firecrawl_scrape` requiere una clave de API.
* `maxAgeMs` controla la antigüedad permitida de los resultados en caché (ms). El valor predeterminado es 172,800,000 ms (2 días).
* `onlyMainContent` tiene como valor predeterminado `true`; `timeoutSeconds` tiene como valor predeterminado 60.
* La configuración heredada `tools.web.fetch.firecrawl.*` y `tools.web.search.firecrawl.*` se migra automáticamente mediante `openclaw doctor --fix`.
* Las sobrescrituras de URL base/extracción de Firecrawl siguen la misma regla alojado/privado que la búsqueda: el tráfico público alojado usa `https://api.firecrawl.dev`; las sobrescrituras autoalojadas deben resolverse a puntos de conexión privados/internos.
* `firecrawl_scrape` rechaza URL de destino obviamente privadas, loopback, de metadatos y que no sean HTTP(S) antes de reenviarlas a Firecrawl, en consonancia con el contrato de seguridad de destino de `web_fetch` para llamadas explícitas de extracción de Firecrawl.

`firecrawl_scrape` reutiliza la misma configuración y variables de entorno `plugins.entries.firecrawl.config.webFetch.*`, incluida su clave de API obligatoria.

### Firecrawl autoalojado

Configura `plugins.entries.firecrawl.config.webSearch.baseUrl`, `plugins.entries.firecrawl.config.webFetch.baseUrl` o `FIRECRAWL_BASE_URL` cuando ejecutes Firecrawl por tu cuenta. OpenClaw acepta `http://` solo para destinos loopback, de red privada, `.local`, `.internal` o `.localhost`. Los hosts personalizados públicos se rechazan para que las claves de API de Firecrawl no se envíen por accidente a puntos de conexión arbitrarios.

## Herramientas del Plugin de Firecrawl

### `firecrawl_search`

Usa esto cuando quieras controles de búsqueda específicos de Firecrawl en lugar de `web_search` genérico.

Parámetros:

* `query`
* `count`
* `sources`
* `categories`
* `scrapeResults`
* `timeoutSeconds`

### `firecrawl_scrape`

Usa esto para páginas con mucho JS o protegidas contra bots donde `web_fetch` simple es débil.

Parámetros:

* `url`
* `extractMode`
* `maxChars`
* `onlyMainContent`
* `maxAgeMs`
* `proxy`
* `storeInCache`
* `timeoutSeconds`

## Sigilo / evasión de bots

`firecrawl_scrape` y la reserva de Firecrawl de `web_fetch` usan de forma predeterminada `proxy: "auto"` más `storeInCache: true`, salvo que el llamador sobrescriba esos parámetros. `firecrawl_search` y el proveedor de Firecrawl de `web_search` no tienen controles `proxy`/`storeInCache`; el modo de proxy sigiloso solo se aplica a solicitudes de extracción/recuperación.

El modo `proxy` de Firecrawl controla la evasión de bots (`basic`, `stealth` o `auto`). `auto` reintenta con proxies sigilosos si falla un intento básico, lo que puede usar más créditos que una extracción solo básica.

## Cómo `web_fetch` usa Firecrawl

Orden de extracción de `web_fetch`:

1. Readability (local)
2. Proveedor de recuperación configurado, como Firecrawl (cuando se selecciona o se detecta automáticamente a partir de credenciales configuradas)
3. Limpieza HTML básica (última reserva)

El control de selección es `tools.web.fetch.provider`. Si lo omites, OpenClaw detecta automáticamente el primer proveedor de web-fetch listo a partir de las credenciales disponibles. El Plugin oficial de Firecrawl proporciona esa reserva.

## Relacionado

* [Descripción general de Web Search](/es/tools/web) -- todos los proveedores y la detección automática
* [Web Fetch](/es/tools/web-fetch) -- herramienta web\_fetch con reserva de Firecrawl
* [Tavily](/es/tools/tavily) -- herramientas de búsqueda + extracción