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

Tools

Firecrawl

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

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

これは、ボット回避とキャッシュをサポートするホステッド型の抽出・検索サービスです。JavaScript を多用するサイトや、通常の HTTP フェッチをブロックするページで役立ちます。

Plugin のインストール

公式 Plugin をインストールしてから、Gateway を再起動します。

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

キーレスアクセスと API キー

Firecrawl は 2 つの web_search プロバイダーを登録します。

  • Firecrawl 検索 (firecrawl) — キーを使用してホステッド型の /v2/search API にアクセスします。 キーが存在する場合は自動検出されます。
  • Firecrawl 検索（無料） (firecrawl-free) — API キーを必要としない、ホステッド型のキーレススターター ティアを使用します。検索クエリが Firecrawl の無料ティアに送信されるため、これは明示的に選択した場合のみ使用され、 自動選択されることはありません。

明示的に選択した Firecrawl の web_fetch フォールバックもキーレスです。明示的な firecrawl_search および firecrawl_scrape ツールには API キーが必要です。より高い上限を利用するには、 Gateway 環境に FIRECRAWL_API_KEY を追加するか、設定してください。

Firecrawl 検索の設定

json5
{  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 が自動的に有効になります。
  • API キーなしでキーレス実行するには、オンボーディングで **Firecrawl 検索（無料）**を選択するか、provider: "firecrawl-free" を設定します。キーを使用する Firecrawl 検索プロバイダーは、plugins.entries.firecrawl.config.webSearch.apiKey または FIRECRAWL_API_KEY を送信します。
  • Firecrawl での web_search は、query および count をサポートします。
  • sources、categories、結果のスクレイピングなど、Firecrawl 固有の制御には firecrawl_search を使用します。
  • baseUrl のデフォルトは、https://api.firecrawl.dev のホステッド型 Firecrawl です。セルフホスト型のオーバーライドはプライベートまたは内部エンドポイントに限り許可され、HTTP はそのようなプライベートターゲットに対してのみ受け入れられます。
  • FIRECRAWL_BASE_URL は、Firecrawl の検索およびスクレイピングのベース URL に共通する環境変数フォールバックです。
  • Firecrawl の検索リクエストのデフォルトタイムアウトは 30 秒です。firecrawl_search の timeoutSeconds パラメーターで、呼び出しごとに上書きできます。

Firecrawl web_fetch フォールバックの設定

json5
{  tools: {    web: {      fetch: {        provider: "firecrawl", // 明示的に選択するとキーレスフォールバックが有効になります      },    },  },  plugins: {    entries: {      firecrawl: {        enabled: true,        config: {          webFetch: {            baseUrl: "https://api.firecrawl.dev",            onlyMainContent: true,            maxAgeMs: 172800000,            timeoutSeconds: 60,          },        },      },    },  },}

注:

  • 明示的に選択した Firecrawl の web_fetch フォールバックは、API キーなしで動作します。設定されている場合、OpenClaw はより高い上限を利用するために plugins.entries.firecrawl.config.webFetch.apiKey または FIRECRAWL_API_KEY を送信します。
  • オンボーディングまたは openclaw configure --section web で Firecrawl を選択すると、Plugin が有効になり、別のフェッチプロバイダーがすでに設定されていない限り、web_fetch に Firecrawl が選択されます。
  • firecrawl_scrape には API キーが必要です。
  • maxAgeMs は、キャッシュされた結果を使用できる最大経過時間（ms）を制御します。デフォルトは 172,800,000 ms（2 日）です。
  • onlyMainContent のデフォルトは true、timeoutSeconds のデフォルトは 60 です。
  • 従来の tools.web.fetch.firecrawl.* および tools.web.search.firecrawl.* の設定は、openclaw doctor --fix によって自動的に移行されます。
  • Firecrawl のスクレイピングおよびベース URL のオーバーライドには、検索と同じホステッド／プライベート規則が適用されます。公開ホステッドトラフィックは https://api.firecrawl.dev を使用し、セルフホスト型のオーバーライドはプライベートまたは内部エンドポイントに解決される必要があります。
  • firecrawl_scrape は、明らかなプライベート、ループバック、メタデータ、および非 HTTP(S) のターゲット URL を Firecrawl に転送する前に拒否します。これは、明示的な Firecrawl スクレイピング呼び出しにおける web_fetch のターゲット安全性契約と一致します。

firecrawl_scrape は、必須の API キーを含む同じ plugins.entries.firecrawl.config.webFetch.* 設定および環境変数を再利用します。

セルフホスト型 Firecrawl

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

Firecrawl Plugin ツール

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

パラメーター:

  • query
  • count (1-100)
  • sources
  • categories
  • includeDomains / excludeDomains（ホスト名のみ、相互排他）
  • tbs（時間フィルター。例: qdr:d、qdr:w、sbd:1）
  • location および country（地域ターゲティング）
  • scrapeResults
  • timeoutSeconds

firecrawl_scrape

通常の web_fetch では十分に処理できない、JavaScript を多用するページやボット保護されたページに使用します。

パラメーター:

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

ステルス／ボット回避

呼び出し元がパラメーターを上書きしない限り、firecrawl_scrape および web_fetch の Firecrawl フォールバックは、デフォルトで proxy: "auto" と storeInCache: true を使用します。firecrawl_search および web_search の Firecrawl プロバイダーには、proxy/storeInCache の制御はありません。ステルスプロキシモードは、スクレイピング／フェッチリクエストにのみ適用されます。

Firecrawl の proxy モードは、ボット回避（basic、stealth、または auto）を制御します。auto は基本的な試行に失敗した場合にステルスプロキシで再試行するため、基本スクレイピングのみの場合より多くのクレジットを使用する可能性があります。

web_fetch による Firecrawl の使用方法

web_fetch の抽出順序:

  1. Readability（ローカル）
  2. Firecrawl などの設定済みフェッチプロバイダー（選択されている場合、または設定済みの認証情報から自動検出された場合）
  3. 基本的な HTML クリーンアップ（最後のフォールバック）

選択設定は tools.web.fetch.provider です。省略した場合、OpenClaw は利用可能な認証情報から、準備ができている最初のウェブフェッチプロバイダーを自動検出します。公式 Firecrawl Plugin がこのフォールバックを提供します。

関連項目

Was this useful?
On this page

On this page