Firecrawl

• come provider web_search
• come strumenti espliciti del plugin: firecrawl_search e firecrawl_scrape
• come estrattore di fallback per web_fetch

​

Installare il plugin

openclaw plugins install @openclaw/firecrawl-plugin
openclaw gateway restart

​

Accesso senza chiave e chiavi API

• Firecrawl Search (firecrawl) — usa l’API /v2/search ospitata con la propria chiave; viene rilevato automaticamente quando è presente una chiave.
• Firecrawl Search (Free) (firecrawl-free) — usa il livello iniziale ospitato senza chiave; non è richiesta alcuna chiave API. È disponibile solo previa adesione e non viene mai selezionato automaticamente, poiché la selezione invia le query di ricerca al livello gratuito di Firecrawl.

​

Configurare la ricerca Firecrawl

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

• La scelta di Firecrawl durante l’onboarding o in openclaw configure --section web abilita automaticamente il plugin Firecrawl installato.
• Scegliere Firecrawl Search (Free) durante l’onboarding (oppure impostare provider: "firecrawl-free") per l’esecuzione senza chiave API. Il provider Firecrawl Search con chiave invia plugins.entries.firecrawl.config.webSearch.apiKey o FIRECRAWL_API_KEY.
• web_search con Firecrawl supporta query e count.
• Per i controlli specifici di Firecrawl, come sources, categories o lo scraping dei risultati, usare firecrawl_search.
• baseUrl usa per impostazione predefinita Firecrawl ospitato all’indirizzo https://api.firecrawl.dev. Le sostituzioni self-hosted sono consentite solo per endpoint privati/interni; HTTP è accettato solo per tali destinazioni private.
• FIRECRAWL_BASE_URL è il fallback condiviso delle variabili di ambiente per gli URL di base della ricerca e dello scraping di Firecrawl.
• Le richieste di ricerca Firecrawl hanno per impostazione predefinita un timeout di 30 secondi; il parametro timeoutSeconds di firecrawl_search lo sostituisce per ogni chiamata.

​

Configurare il fallback web_fetch di Firecrawl

{
  tools: {
    web: {
      fetch: {
        provider: "firecrawl", // la selezione esplicita abilita il fallback senza chiave
      },
    },
  },
  plugins: {
    entries: {
      firecrawl: {
        enabled: true,
        config: {
          webFetch: {
            baseUrl: "https://api.firecrawl.dev",
            onlyMainContent: true,
            maxAgeMs: 172800000,
            timeoutSeconds: 60,
          },
        },
      },
    },
  },
}

• Il fallback web_fetch di Firecrawl selezionato esplicitamente funziona senza una chiave API. Quando è configurato, OpenClaw invia plugins.entries.firecrawl.config.webFetch.apiKey o FIRECRAWL_API_KEY per ottenere limiti più elevati.
• La scelta di Firecrawl durante l’onboarding o in 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 memorizzati nella cache (ms). Il valore predefinito è 172.800.000 ms (2 giorni).
• onlyMainContent usa per impostazione predefinita true; il valore predefinito di timeoutSeconds è 60.
• La configurazione legacy tools.web.fetch.firecrawl.* e tools.web.search.firecrawl.* viene migrata automaticamente da openclaw doctor --fix.
• Le sostituzioni degli URL di scraping/base 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 gli URL di destinazione palesemente privati, di loopback, di metadati e non HTTP(S) prima di inoltrarli a Firecrawl, in conformità al contratto di sicurezza delle destinazioni di web_fetch per le chiamate esplicite di scraping Firecrawl.

​

Firecrawl self-hosted

​

Strumenti del plugin Firecrawl

​

firecrawl_search

• query
• count (1-100)
• sources
• categories
• includeDomains / excludeDomains (solo nomi host; si escludono a vicenda)
• tbs (filtro temporale, ad esempio qdr:d, qdr:w, sbd:1)
• location e country (targeting geografico)
• scrapeResults
• timeoutSeconds

​

firecrawl_scrape

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

​

Modalità stealth / aggiramento dei bot

​

Come web_fetch usa Firecrawl

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

​

Argomenti correlati

• Panoramica della ricerca web — tutti i provider e il rilevamento automatico
• Recupero web — strumento web_fetch con fallback Firecrawl
• Tavily — strumenti di ricerca ed estrazione