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

Tools

Firecrawl

OpenClaw kan Firecrawl op drie manieren gebruiken:

  • als de web_search-provider
  • als expliciete Plugin-tools: firecrawl_search en firecrawl_scrape
  • als fallback-extractor voor web_fetch

Het is een gehoste extractie- en zoekservice die botomzeiling en caching ondersteunt, wat helpt bij sites die sterk afhankelijk zijn van JS of pagina's die gewone HTTP-ophaalacties blokkeren.

Plugin installeren

Installeer de officiële Plugin en start daarna de Gateway opnieuw:

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

web_fetch zonder sleutel en API-sleutels

De expliciet geselecteerde gehoste Firecrawl-fallback voor web_fetch ondersteunt basistoegang zonder API-sleutel. Voeg FIRECRAWL_API_KEY toe aan de Gateway-omgeving of configureer deze wanneer u hogere limieten nodig hebt. Firecrawl web_search en firecrawl_scrape vereisen een API-sleutel.

Firecrawl-zoekfunctie configureren

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

Opmerkingen:

  • Als u Firecrawl kiest tijdens de onboarding of via openclaw configure --section web, wordt de geïnstalleerde Firecrawl-Plugin automatisch ingeschakeld.
  • web_search met Firecrawl ondersteunt query en count.
  • Gebruik firecrawl_search voor Firecrawl-specifieke opties zoals sources, categories of het scrapen van resultaten.
  • baseUrl gebruikt standaard de gehoste Firecrawl-service op https://api.firecrawl.dev. Zelfgehoste alternatieven zijn alleen toegestaan voor privé- of interne eindpunten; HTTP wordt uitsluitend geaccepteerd voor dergelijke privélocaties.
  • FIRECRAWL_BASE_URL is de gedeelde omgevingsfallback voor de basis-URL's van Firecrawl-zoek- en scrapeverzoeken.
  • Firecrawl-zoekverzoeken hebben standaard een time-out van 30 seconden; de parameter timeoutSeconds van firecrawl_search overschrijft deze per aanroep.

Firecrawl-fallback voor web_fetch configureren

json5
{  tools: {    web: {      fetch: {        provider: "firecrawl", // expliciete selectie schakelt de fallback zonder sleutel in      },    },  },  plugins: {    entries: {      firecrawl: {        enabled: true,        config: {          webFetch: {            baseUrl: "https://api.firecrawl.dev",            onlyMainContent: true,            maxAgeMs: 172800000,            timeoutSeconds: 60,          },        },      },    },  },}

Opmerkingen:

  • De expliciet geselecteerde Firecrawl-fallback voor web_fetch werkt zonder API-sleutel. Wanneer deze is geconfigureerd, stuurt OpenClaw plugins.entries.firecrawl.config.webFetch.apiKey of FIRECRAWL_API_KEY mee voor hogere limieten.
  • Als u Firecrawl kiest tijdens de onboarding of via openclaw configure --section web, wordt de Plugin ingeschakeld en wordt Firecrawl geselecteerd voor web_fetch, tenzij al een andere ophaalprovider is geconfigureerd.
  • firecrawl_scrape vereist een API-sleutel.
  • maxAgeMs bepaalt hoe oud gecachete resultaten mogen zijn (ms). De standaardwaarde is 172.800.000 ms (2 dagen).
  • onlyMainContent is standaard true; timeoutSeconds is standaard 60.
  • Verouderde configuratie onder tools.web.fetch.firecrawl.* en tools.web.search.firecrawl.* wordt automatisch gemigreerd door openclaw doctor --fix.
  • Alternatieve URL's voor Firecrawl-scraping en de basis-URL volgen dezelfde regel voor gehoste en privéomgevingen als de zoekfunctie: openbaar gehost verkeer gebruikt https://api.firecrawl.dev; zelfgehoste alternatieven moeten verwijzen naar privé- of interne eindpunten.
  • firecrawl_scrape weigert duidelijk privé-, local-loopback-, metadata- en niet-HTTP(S)-doel-URL's voordat deze naar Firecrawl worden doorgestuurd, overeenkomstig het doelbeveiligingscontract van web_fetch voor expliciete Firecrawl-scrapeaanroepen.

firecrawl_scrape hergebruikt dezelfde instellingen en omgevingsvariabelen onder plugins.entries.firecrawl.config.webFetch.*, inclusief de vereiste API-sleutel.

Zelfgehoste Firecrawl

Stel plugins.entries.firecrawl.config.webSearch.baseUrl, plugins.entries.firecrawl.config.webFetch.baseUrl of FIRECRAWL_BASE_URL in wanneer u Firecrawl zelf uitvoert. OpenClaw accepteert http:// alleen voor local loopback-, privénetwerk-, .local-, .internal- of .localhost-doelen. Aangepaste openbare hosts worden geweigerd, zodat Firecrawl-API-sleutels niet per ongeluk naar willekeurige eindpunten worden verzonden.

Firecrawl-Plugin-tools

Gebruik dit wanneer u Firecrawl-specifieke zoekopties wilt in plaats van de algemene web_search.

Parameters:

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

firecrawl_scrape

Gebruik dit voor pagina's die sterk afhankelijk zijn van JS of tegen bots zijn beveiligd en waarvoor gewone web_fetch tekortschiet.

Parameters:

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

Stealthmodus/botomzeiling

firecrawl_scrape en de Firecrawl-fallback voor web_fetch gebruiken standaard proxy: "auto" en storeInCache: true, tenzij de aanroeper deze parameters overschrijft. firecrawl_search en de Firecrawl-provider voor web_search hebben geen opties voor proxy/storeInCache; de stealth-proxymodus is alleen van toepassing op scrape- en ophaalverzoeken.

De proxy-modus van Firecrawl regelt de botomzeiling (basic, stealth of auto). auto probeert het opnieuw met stealth-proxy's als een eenvoudige poging mislukt, wat meer tegoed kan kosten dan scraping met uitsluitend de basismodus.

Hoe web_fetch Firecrawl gebruikt

Extractievolgorde van web_fetch:

  1. Readability (lokaal)
  2. Geconfigureerde ophaalprovider, zoals Firecrawl (wanneer deze is geselecteerd of automatisch is gedetecteerd op basis van geconfigureerde aanmeldgegevens)
  3. Eenvoudige HTML-opschoning (laatste fallback)

De selectieoptie is tools.web.fetch.provider. Als u deze weglaat, detecteert OpenClaw automatisch de eerste beschikbare provider voor het ophalen van webinhoud op basis van de beschikbare aanmeldgegevens. De officiële Firecrawl-Plugin biedt die fallback.

Gerelateerd

Was this useful?
On this page

On this page