OpenClawDocs
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this page

Tools

Firecrawl

OpenClaw puede usar Firecrawl de tres maneras:

  • como proveedor de web_search
  • como herramientas explícitas del plugin: firecrawl_search y firecrawl_scrape
  • como extractor de respaldo para web_fetch

Es un servicio alojado de extracción y búsqueda que permite eludir bots y usar caché, lo que resulta útil con sitios que dependen en gran medida de JS o páginas que bloquean las solicitudes HTTP simples.

Instalar el plugin

Instale el plugin oficial y, a continuación, reinicie el Gateway:

bash
openclaw plugins install @openclaw/firecrawl-pluginopenclaw gateway restart

Acceso sin clave y claves de API

Firecrawl registra dos proveedores de web_search:

  • Búsqueda de Firecrawl (firecrawl) — usa la API alojada /v2/search con su clave; se detecta automáticamente cuando hay una clave presente.
  • Búsqueda de Firecrawl (gratuita) (firecrawl-free) — usa el nivel inicial alojado sin clave; no se requiere ninguna clave de API. Es solo opcional y nunca se selecciona automáticamente, ya que seleccionarlo envía sus consultas de búsqueda al nivel gratuito de Firecrawl.

El respaldo de web_fetch de Firecrawl seleccionado explícitamente tampoco requiere clave. Las herramientas explícitas firecrawl_search y firecrawl_scrape requieren una clave de API. Añada FIRECRAWL_API_KEY al entorno del Gateway o configúrela para obtener límites más altos.

Configurar la búsqueda de Firecrawl

json5
{  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 durante la incorporación o en openclaw configure --section web activa automáticamente el plugin de Firecrawl instalado.
  • Elija Búsqueda de Firecrawl (gratuita) durante la incorporación (o establezca provider: "firecrawl-free") para ejecutarla sin clave de API. El proveedor Búsqueda de Firecrawl con clave envía plugins.entries.firecrawl.config.webSearch.apiKey o FIRECRAWL_API_KEY.
  • web_search con Firecrawl admite query y count.
  • Para controles específicos de Firecrawl como sources, categories o la extracción de resultados, use firecrawl_search.
  • baseUrl usa de forma predeterminada Firecrawl alojado en https://api.firecrawl.dev. Las sustituciones autoalojadas solo se permiten para puntos de conexión privados o internos; HTTP solo se acepta para esos destinos privados.
  • FIRECRAWL_BASE_URL es la variable de entorno de respaldo compartida para las URL base de búsqueda y extracción de Firecrawl.
  • Las solicitudes de búsqueda de Firecrawl tienen de forma predeterminada un tiempo de espera de 30 segundos; el parámetro timeoutSeconds de firecrawl_search lo sustituye para cada llamada.

Configurar el respaldo de Firecrawl para web_fetch

json5
{  tools: {    web: {      fetch: {        provider: "firecrawl", // la selección explícita activa el respaldo sin clave      },    },  },  plugins: {    entries: {      firecrawl: {        enabled: true,        config: {          webFetch: {            baseUrl: "https://api.firecrawl.dev",            onlyMainContent: true,            maxAgeMs: 172800000,            timeoutSeconds: 60,          },        },      },    },  },}

Notas:

  • El respaldo de web_fetch de Firecrawl seleccionado explícitamente funciona sin una clave de API. Cuando se configura, OpenClaw envía plugins.entries.firecrawl.config.webFetch.apiKey o FIRECRAWL_API_KEY para obtener límites más altos.
  • Elegir Firecrawl durante la incorporación o en openclaw configure --section web activa el plugin y selecciona Firecrawl para web_fetch, a menos que ya se haya configurado otro proveedor de obtención.
  • firecrawl_scrape requiere una clave de API.
  • maxAgeMs controla la antigüedad máxima de los resultados almacenados en caché (ms). El valor predeterminado es 172,800,000 ms (2 días).
  • onlyMainContent usa de forma predeterminada true; timeoutSeconds usa de forma predeterminada 60.
  • La configuración heredada de tools.web.fetch.firecrawl.* y tools.web.search.firecrawl.* se migra automáticamente mediante openclaw doctor --fix.
  • Las sustituciones de extracción y URL base de Firecrawl siguen la misma regla de alojamiento y privacidad que la búsqueda: el tráfico público alojado usa https://api.firecrawl.dev; las sustituciones autoalojadas deben resolverse en puntos de conexión privados o internos.
  • firecrawl_scrape rechaza las URL de destino que sean claramente privadas, de bucle invertido, de metadatos o que no usen HTTP(S) antes de reenviarlas a Firecrawl, de acuerdo con el contrato de seguridad de destinos de web_fetch para llamadas explícitas de extracción de Firecrawl.

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

Firecrawl autoalojado

Establezca plugins.entries.firecrawl.config.webSearch.baseUrl, plugins.entries.firecrawl.config.webFetch.baseUrl o FIRECRAWL_BASE_URL cuando ejecute Firecrawl por su cuenta. OpenClaw acepta http:// solo para destinos de bucle invertido, redes privadas, .local, .internal o .localhost. Los hosts públicos personalizados se rechazan para evitar que las claves de API de Firecrawl se envíen por accidente a puntos de conexión arbitrarios.

Herramientas del plugin de Firecrawl

Use esta herramienta cuando necesite controles de búsqueda específicos de Firecrawl en lugar de web_search genérico. Requiere una clave de API.

Parámetros:

  • query
  • count (1-100)
  • sources
  • categories
  • includeDomains / excludeDomains (solo nombres de host; se excluyen mutuamente)
  • tbs (filtro temporal, por ejemplo, qdr:d, qdr:w, sbd:1)
  • location y country (segmentación geográfica)
  • scrapeResults
  • timeoutSeconds

firecrawl_scrape

Use esta herramienta para páginas que dependen en gran medida de JS o están protegidas contra bots, donde web_fetch simple no resulta eficaz.

Parámetros:

  • url
  • extractMode
  • maxChars
  • onlyMainContent
  • maxAgeMs
  • proxy
  • storeInCache
  • timeoutSeconds

Modo sigiloso y elusión de bots

firecrawl_scrape y el respaldo de Firecrawl para web_fetch usan de forma predeterminada proxy: "auto" junto con storeInCache: true, a menos que el autor de la llamada sustituya esos parámetros. firecrawl_search y el proveedor de Firecrawl para web_search no tienen controles proxy/storeInCache; el modo de proxy sigiloso solo se aplica a las solicitudes de extracción u obtención.

El modo proxy de Firecrawl controla la elusión de bots (basic, stealth o auto). auto vuelve a intentarlo con proxies sigilosos si falla un intento básico, lo que puede consumir más créditos que una extracción limitada al modo básico.

Cómo usa Firecrawl web_fetch

Orden de extracción de web_fetch:

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

El control de selección es tools.web.fetch.provider. Si se omite, OpenClaw detecta automáticamente el primer proveedor de obtención web listo a partir de las credenciales disponibles. El plugin oficial de Firecrawl proporciona ese respaldo.

Temas relacionados

Was this useful?
On this page

On this page