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

Tools

Firecrawl

OpenClaw può usare Firecrawl in tre modi:

  • come provider di web_search
  • come strumenti Plugin espliciti: firecrawl_search e firecrawl_scrape
  • come estrattore di riserva per web_fetch

È un servizio ospitato di estrazione e ricerca che supporta l'aggiramento dei bot e la memorizzazione nella cache, risultando utile con siti che fanno largo uso di JavaScript o pagine che bloccano le normali richieste HTTP.

Installare il Plugin

Installa il Plugin ufficiale, quindi riavvia il Gateway:

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

web_fetch senza chiave e chiavi API

Il fallback web_fetch ospitato di Firecrawl selezionato esplicitamente offre un accesso iniziale senza chiave API. Aggiungi FIRECRAWL_API_KEY nell'ambiente del Gateway o configuralo quando hai bisogno di limiti più elevati. web_search e firecrawl_scrape di Firecrawl richiedono una chiave API.

Configurare la ricerca Firecrawl

json5
{  tools: {    web: {      search: {        provider: "firecrawl",      },    },  },  plugins: {    entries: {      firecrawl: {        enabled: true,        config: {          webSearch: {            apiKey: "FIRECRAWL_API_KEY_HERE",            baseUrl: "https://api.firecrawl.dev",          },        },      },    },  },}

Note:

  • La scelta di Firecrawl durante la configurazione iniziale o tramite openclaw configure --section web abilita automaticamente il Plugin Firecrawl installato.
  • web_search con Firecrawl supporta query e count.
  • Per controlli specifici di Firecrawl come sources, categories o l'estrazione dei risultati, usa firecrawl_search.
  • Il valore predefinito di baseUrl è il servizio Firecrawl ospitato all'indirizzo https://api.firecrawl.dev. Le sostituzioni con servizi self-hosted sono consentite solo per endpoint privati/interni; HTTP è accettato solo per tali destinazioni private.
  • FIRECRAWL_BASE_URL è il valore di riserva condiviso dell'ambiente per gli URL di base di ricerca ed estrazione di Firecrawl.
  • Le richieste di ricerca Firecrawl hanno un timeout predefinito di 30 secondi; il parametro timeoutSeconds di firecrawl_search lo sostituisce per ogni chiamata.

Configurare il fallback web_fetch di Firecrawl

json5
{  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,          },        },      },    },  },}

Note:

  • Il fallback web_fetch di Firecrawl selezionato esplicitamente funziona senza una chiave API. Se configurata, OpenClaw invia plugins.entries.firecrawl.config.webFetch.apiKey o FIRECRAWL_API_KEY per ottenere limiti più elevati.
  • La scelta di Firecrawl durante la configurazione iniziale o tramite openclaw configure --section web abilita il Plugin e seleziona Firecrawl per web_fetch, a meno che non sia già configurato un altro provider di recupero.
  • firecrawl_scrape richiede una chiave API.
  • maxAgeMs controlla l'età massima consentita per i risultati nella cache (ms). Il valore predefinito è 172.800.000 ms (2 giorni).
  • Il valore predefinito di onlyMainContent è true; quello di timeoutSeconds è 60.
  • La configurazione legacy tools.web.fetch.firecrawl.* e tools.web.search.firecrawl.* viene migrata automaticamente da openclaw doctor --fix.
  • Le sostituzioni dell'URL di base e di estrazione di Firecrawl seguono la stessa regola ospitato/privato della ricerca: il traffico pubblico ospitato usa https://api.firecrawl.dev; le sostituzioni self-hosted devono risolversi in endpoint privati/interni.
  • firecrawl_scrape rifiuta URL di destinazione palesemente privati, di loopback, di metadati e non HTTP(S) prima di inoltrarli a Firecrawl, rispettando il contratto di sicurezza delle destinazioni di web_fetch per le chiamate esplicite di estrazione Firecrawl.

firecrawl_scrape riutilizza le stesse impostazioni e variabili di ambiente plugins.entries.firecrawl.config.webFetch.*, inclusa la chiave API obbligatoria.

Firecrawl self-hosted

Imposta plugins.entries.firecrawl.config.webSearch.baseUrl, plugins.entries.firecrawl.config.webFetch.baseUrl o FIRECRAWL_BASE_URL quando esegui autonomamente Firecrawl. OpenClaw accetta http:// solo per destinazioni di loopback, reti private, .local, .internal o .localhost. Gli host pubblici personalizzati vengono rifiutati per evitare che le chiavi API di Firecrawl siano inviate accidentalmente a endpoint arbitrari.

Strumenti del Plugin Firecrawl

Usalo quando vuoi controlli di ricerca specifici di Firecrawl anziché il generico web_search.

Parametri:

  • query
  • count
  • sources
  • categories
  • scrapeResults
  • timeoutSeconds

firecrawl_scrape

Usalo per pagine che fanno largo uso di JavaScript o sono protette dai bot, per le quali il normale web_fetch è poco efficace.

Parametri:

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

Modalità invisibile / aggiramento dei bot

firecrawl_scrape e il fallback Firecrawl di web_fetch usano per impostazione predefinita proxy: "auto" insieme a storeInCache: true, a meno che il chiamante non sostituisca tali parametri. firecrawl_search e il provider Firecrawl di web_search non dispongono dei controlli proxy/storeInCache; la modalità proxy invisibile si applica solo alle richieste di estrazione/recupero.

La modalità proxy di Firecrawl controlla l'aggiramento dei bot (basic, stealth o auto). auto riprova con proxy invisibili se un tentativo di base non riesce, il che può utilizzare più crediti rispetto all'estrazione esclusivamente di base.

Come web_fetch usa Firecrawl

Ordine di estrazione di web_fetch:

  1. Readability (locale)
  2. Provider di recupero configurato, come Firecrawl (quando selezionato o rilevato automaticamente dalle credenziali configurate)
  3. Pulizia HTML di base (ultimo fallback)

L'opzione di selezione è tools.web.fetch.provider. Se la ometti, OpenClaw rileva automaticamente il primo provider di recupero web pronto in base alle credenziali disponibili. Il Plugin Firecrawl ufficiale fornisce tale fallback.

Argomenti correlati

Was this useful?
On this page

On this page