Tools
Firecrawl
OpenClaw は Firecrawl を 3 つの方法で使用できます。
web_searchプロバイダーとして- 明示的な Plugin ツールとして:
firecrawl_searchとfirecrawl_scrape web_fetchのフォールバック抽出器として
これは、ボット回避とキャッシュをサポートするホスト型の抽出/検索サービスであり、 JS の多いサイトやプレーンな HTTP fetch をブロックするページに役立ちます。
Plugin をインストールする
公式 Plugin をインストールし、Gateway を再起動します。
openclaw plugins install @openclaw/firecrawl-pluginopenclaw gateway restartキーなし web_fetch と API キー
明示的に選択されたホスト型 Firecrawl の web_fetch フォールバックは、API キーなしのスターター
アクセスをサポートします。より高い制限が必要な場合は、Gateway 環境に
FIRECRAWL_API_KEY を追加するか、設定してください。Firecrawl web_search と
firecrawl_scrape には API キーが必要です。
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はデフォルトでhttps://api.firecrawl.devのホスト型 Firecrawl になります。セルフホストのオーバーライドはプライベート/内部エンドポイントに対してのみ許可されます。HTTP はそれらのプライベートターゲットに対してのみ受け入れられます。FIRECRAWL_BASE_URLは、Firecrawl 検索とスクレイプのベース URL に対する共有 env フォールバックです。
Firecrawl web_fetch フォールバックを設定する
{ 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, }, }, }, }, },}注記:
- 明示的に選択された Firecrawl
web_fetchフォールバックは API キーなしで動作します。設定されている場合、OpenClaw はより高い制限のためにplugins.entries.firecrawl.config.webFetch.apiKeyまたはFIRECRAWL_API_KEYを送信します。 - オンボーディング中または
openclaw configure --section webで Firecrawl を選択すると、別の fetch プロバイダーがすでに設定されていない限り、Plugin が有効になり、web_fetchに Firecrawl が選択されます。 firecrawl_scrapeには API キーが必要です。maxAgeMsはキャッシュ結果をどれだけ古いものまで許可するかを制御します (ms)。デフォルトは 2 日です。- レガシーの
tools.web.fetch.firecrawl.*設定はopenclaw doctor --fixによって自動移行されます。 - Firecrawl のスクレイプ/ベース URL オーバーライドは、検索と同じホスト型/プライベートのルールに従います。公開ホスト型トラフィックは
https://api.firecrawl.devを使用します。セルフホストのオーバーライドはプライベート/内部エンドポイントに解決される必要があります。 firecrawl_scrapeは、Firecrawl に転送する前に、明らかなプライベート、ループバック、メタデータ、非 HTTP(S) のターゲット URL を拒否し、明示的な Firecrawl スクレイプ呼び出しに対するweb_fetchのターゲット安全性コントラクトと一致させます。
firecrawl_scrape は、必須 API キーを含め、同じ 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 は、ループバック、プライベートネットワーク、.local、.internal、または .localhost
ターゲットに対してのみ http:// を受け入れます。Firecrawl API キーが誤って任意のエンドポイントに
送信されないよう、公開カスタムホストは拒否されます。
Firecrawl Plugin ツール
firecrawl_search
汎用の web_search ではなく、Firecrawl 固有の検索制御を使用したい場合に使用します。
コアパラメーター:
querycountsourcescategoriesscrapeResultstimeoutSeconds
firecrawl_scrape
プレーンな web_fetch が弱い、JS の多いページやボット保護されたページに使用します。
コアパラメーター:
urlextractModemaxCharsonlyMainContentmaxAgeMsproxystoreInCachetimeoutSeconds
ステルス / ボット回避
Firecrawl は、ボット回避のための proxy mode パラメーター (basic、stealth、または auto) を公開しています。
OpenClaw は Firecrawl リクエストに対して常に proxy: "auto" と storeInCache: true を使用します。
proxy が省略された場合、Firecrawl のデフォルトは auto です。auto は basic の試行が失敗した場合にステルスプロキシで再試行するため、basic のみのスクレイピングより多くのクレジットを使用する場合があります。
web_fetch が Firecrawl を使用する方法
web_fetch の抽出順序:
- Readability (ローカル)
- Firecrawl (選択されている場合、または設定済み認証情報から自動検出された場合)
- 基本 HTML クリーンアップ (最後のフォールバック)
選択ノブは tools.web.fetch.provider です。省略すると、OpenClaw は
利用可能な認証情報から最初に準備できた web-fetch プロバイダーを自動検出します。
公式 Firecrawl Plugin がそのフォールバックを提供します。
関連
- Web Search 概要 -- すべてのプロバイダーと自動検出
- Web Fetch -- Firecrawl フォールバック付き web_fetch ツール
- Tavily -- 検索 + 抽出ツール
