Zum Hauptinhalt springen
OpenClaw kann Firecrawl auf drei Arten verwenden:
  • als web_search-Provider
  • als explizite Plugin-Tools: firecrawl_search und firecrawl_scrape
  • als Fallback-Extraktor für web_fetch
Es ist ein gehosteter Extraktions-/Suchdienst, der Bot-Umgehung und Caching unterstützt, was bei JS-lastigen Websites oder Seiten hilft, die einfache HTTP-Abrufe blockieren.

​
Plugin installieren

Installieren Sie das offizielle Plugin und starten Sie anschließend den Gateway neu: 
openclaw plugins install @openclaw/firecrawl-plugin
openclaw gateway restart

​
Keyless web_fetch und API-Schlüssel

Der explizit ausgewählte gehostete Firecrawl-web_fetch-Fallback unterstützt Starter-Zugriff ohne API-Schlüssel. Fügen Sie FIRECRAWL_API_KEY in der Gateway-Umgebung hinzu oder konfigurieren Sie ihn, wenn Sie höhere Limits benötigen. Firecrawl-web_search und firecrawl_scrape erfordern einen API-Schlüssel.

​
Firecrawl-Suche konfigurieren

{
  tools: {
    web: {
      search: {
        provider: "firecrawl",
      },
    },
  },
  plugins: {
    entries: {
      firecrawl: {
        enabled: true,
        config: {
          webSearch: {
            apiKey: "FIRECRAWL_API_KEY_HERE",
            baseUrl: "https://api.firecrawl.dev",
          },
        },
      },
    },
  },
}
Hinweise:
  • Die Auswahl von Firecrawl im Onboarding oder mit openclaw configure --section web aktiviert das installierte Firecrawl-Plugin automatisch.
  • web_search mit Firecrawl unterstützt query und count.
  • Verwenden Sie für Firecrawl-spezifische Steuerungen wie sources, categories oder Ergebnis-Scraping firecrawl_search.
  • baseUrl verwendet standardmäßig das gehostete Firecrawl unter https://api.firecrawl.dev. Selbst gehostete Überschreibungen sind nur für private/interne Endpunkte erlaubt; HTTP wird nur für diese privaten Ziele akzeptiert.
  • FIRECRAWL_BASE_URL ist der gemeinsame Env-Fallback für Firecrawl-Such- und Scrape-Basis-URLs.

​
Firecrawl-web_fetch-Fallback konfigurieren

{
  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,
          },
        },
      },
    },
  },
}
Hinweise:
  • Der explizit ausgewählte Firecrawl-web_fetch-Fallback funktioniert ohne API-Schlüssel. Wenn konfiguriert, sendet OpenClaw plugins.entries.firecrawl.config.webFetch.apiKey oder FIRECRAWL_API_KEY für höhere Limits.
  • Die Auswahl von Firecrawl während des Onboardings oder mit openclaw configure --section web aktiviert das Plugin und wählt Firecrawl für web_fetch aus, sofern nicht bereits ein anderer Fetch-Provider konfiguriert ist.
  • firecrawl_scrape erfordert einen API-Schlüssel.
  • maxAgeMs steuert, wie alt zwischengespeicherte Ergebnisse sein dürfen (ms). Standardwert ist 2 Tage.
  • Die Legacy-Konfiguration tools.web.fetch.firecrawl.* wird durch openclaw doctor --fix automatisch migriert.
  • Firecrawl-Scrape-/Basis-URL-Überschreibungen folgen derselben Hosted-/Privat-Regel wie die Suche: Öffentlicher gehosteter Traffic verwendet https://api.firecrawl.dev; selbst gehostete Überschreibungen müssen auf private/interne Endpunkte auflösen.
  • firecrawl_scrape lehnt offensichtliche private, Loopback-, Metadata- und Nicht-HTTP(S)-Ziel-URLs ab, bevor sie an Firecrawl weitergeleitet werden, entsprechend dem Ziel-Sicherheitsvertrag von web_fetch für explizite Firecrawl-Scrape-Aufrufe.
firecrawl_scrape verwendet dieselben Einstellungen und Env-Variablen aus plugins.entries.firecrawl.config.webFetch.* wieder, einschließlich des erforderlichen API-Schlüssels.

​
Selbst gehostetes Firecrawl

Legen Sie plugins.entries.firecrawl.config.webSearch.baseUrl, plugins.entries.firecrawl.config.webFetch.baseUrl oder FIRECRAWL_BASE_URL fest, wenn Sie Firecrawl selbst betreiben. OpenClaw akzeptiert http:// nur für Loopback-, private Netzwerk-, .local-, .internal- oder .localhost-Ziele. Öffentliche benutzerdefinierte Hosts werden abgelehnt, damit Firecrawl-API-Schlüssel nicht versehentlich an beliebige Endpunkte gesendet werden.

​
Firecrawl-Plugin-Tools

Verwenden Sie dies, wenn Sie Firecrawl-spezifische Suchsteuerungen statt des generischen web_search wünschen. Kernparameter:
  • query
  • count
  • sources
  • categories
  • scrapeResults
  • timeoutSeconds

​
firecrawl_scrape

Verwenden Sie dies für JS-lastige oder bot-geschützte Seiten, bei denen einfaches web_fetch schwach ist. Kernparameter:
  • url
  • extractMode
  • maxChars
  • onlyMainContent
  • maxAgeMs
  • proxy
  • storeInCache
  • timeoutSeconds

​
Stealth / Bot-Umgehung

Firecrawl stellt einen Parameter für den Proxy-Modus zur Bot-Umgehung bereit (basic, stealth oder auto). OpenClaw verwendet für Firecrawl-Anfragen immer proxy: "auto" plus storeInCache: true. Wenn proxy weggelassen wird, verwendet Firecrawl standardmäßig auto. auto versucht es erneut mit Stealth-Proxys, wenn ein einfacher Versuch fehlschlägt, was mehr Credits verbrauchen kann als Basic-only-Scraping.

​
Wie web_fetch Firecrawl verwendet

web_fetch-Extraktionsreihenfolge:
  1. Readability (lokal)
  2. Firecrawl (wenn ausgewählt oder automatisch aus konfigurierten Zugangsdaten erkannt)
  3. Einfache HTML-Bereinigung (letzter Fallback)
Der Auswahlregler ist tools.web.fetch.provider. Wenn Sie ihn weglassen, erkennt OpenClaw automatisch den ersten bereiten Web-Fetch-Provider aus den verfügbaren Zugangsdaten. Das offizielle Firecrawl-Plugin stellt diesen Fallback bereit.

​
Verwandt