English简体中文繁體中文日本語EspañolPortuguês (BR)한국어DeutschFrançaisالعربيةItalianoTiếng ViệtNederlandsTürkçeУкраїнськаBahasa IndonesiaPolskiفارسیไทย

Tools

Firecrawl

OpenClaw は Firecrawl を 3 つの方法で使用できます。

  • web_search プロバイダーとして
  • 明示的な Plugin ツールとして: firecrawl_search と firecrawl_scrape
  • web_fetch のフォールバック抽出器として

これは、ボット回避とキャッシュに対応したホスト型の抽出/検索サービスで、 JS の多いサイトや、通常の HTTP フェッチをブロックするページで役立ちます。

API キーを取得する

  1. Firecrawl アカウントを作成し、API キーを生成します。
  2. config に保存するか、Gateway 環境で FIRECRAWL_API_KEY を設定します。

Firecrawl 検索を設定する

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

注:

  • オンボーディングまたは openclaw configure --section web で Firecrawl を選択すると、同梱の Firecrawl Plugin が自動的に有効になります。
  • Firecrawl を使う web_search は query と count に対応しています。
  • sources、categories、結果のスクレイピングなど Firecrawl 固有の制御には、firecrawl_search を使用します。
  • baseUrl のデフォルトは、ホスト型 Firecrawl の https://api.firecrawl.dev です。セルフホストの上書きはプライベート/内部エンドポイントに対してのみ許可されます。HTTP はそれらのプライベートターゲットに対してのみ受け入れられます。
  • FIRECRAWL_BASE_URL は、Firecrawl の検索およびスクレイプのベース URL 用の共有 env フォールバックです。

Firecrawl スクレイプ + web_fetch フォールバックを設定する

{
  plugins: {
    entries: {
      firecrawl: {
        enabled: true,
        config: {
          webFetch: {
            apiKey: "FIRECRAWL_API_KEY_HERE",
            baseUrl: "https://api.firecrawl.dev",
            onlyMainContent: true,
            maxAgeMs: 172800000,
            timeoutSeconds: 60,
          },
        },
      },
    },
  },
}

注:

  • Firecrawl フォールバックの試行は、API キーが利用可能な場合（plugins.entries.firecrawl.config.webFetch.apiKey または FIRECRAWL_API_KEY）にのみ実行されます。
  • maxAgeMs はキャッシュ結果をどれだけ古いものまで許可するか（ms）を制御します。デフォルトは 2 日です。
  • レガシーの tools.web.fetch.firecrawl.* config は、openclaw doctor --fix によって自動移行されます。
  • Firecrawl のスクレイプ/ベース URL の上書きは、検索と同じホスト型/プライベートのルールに従います。公開ホスト型トラフィックは https://api.firecrawl.dev を使用します。セルフホストの上書きは、プライベート/内部エンドポイントに解決される必要があります。
  • firecrawl_scrape は、明示的な Firecrawl スクレイプ呼び出しについて web_fetch のターゲット安全性契約に合わせ、Firecrawl に転送する前に、明らかなプライベート、loopback、メタデータ、および非 HTTP(S) のターゲット URL を拒否します。

firecrawl_scrape は、同じ plugins.entries.firecrawl.config.webFetch.* 設定と env vars を再利用します。

セルフホスト Firecrawl

Firecrawl を自分で実行する場合は、plugins.entries.firecrawl.config.webSearch.baseUrl、 plugins.entries.firecrawl.config.webFetch.baseUrl、または FIRECRAWL_BASE_URL を設定します。OpenClaw は、loopback、プライベートネットワーク、.local、.internal、または .localhost のターゲットに対してのみ http:// を受け入れます。公開カスタム ホストは拒否されるため、Firecrawl API キーが誤って任意のエンドポイントに送信されることはありません。

Firecrawl Plugin ツール

汎用の web_search ではなく、Firecrawl 固有の検索制御が必要な場合に使用します。

主要パラメーター:

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

firecrawl_scrape

通常の web_fetch が弱い、JS の多いページやボット保護されたページに使用します。

主要パラメーター:

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

ステルス / ボット回避

Firecrawl は、ボット回避用の プロキシモード パラメーター（basic、stealth、または auto）を公開しています。 OpenClaw は、Firecrawl リクエストに対して常に proxy: "auto" と storeInCache: true を使用します。 proxy が省略された場合、Firecrawl のデフォルトは auto です。auto は、基本的な試行が失敗した場合にステルスプロキシで再試行するため、basic のみのスクレイピングより多くのクレジットを使用する場合があります。

web_fetch が Firecrawl を使用する仕組み

web_fetch の抽出順序:

  1. Readability（ローカル）
  2. Firecrawl（アクティブな web-fetch フォールバックとして選択または自動検出された場合）
  3. 基本的な HTML クリーンアップ（最後のフォールバック）

選択ノブは tools.web.fetch.provider です。省略した場合、OpenClaw は利用可能な認証情報から最初の準備済み web-fetch プロバイダーを自動検出します。 現在、同梱プロバイダーは Firecrawl です。

関連

  • Web Search の概要 -- すべてのプロバイダーと自動検出
  • Web Fetch -- Firecrawl フォールバック付きの web_fetch ツール
  • Tavily -- 検索 + 抽出ツール