Firecrawl

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

​

Plugin のインストール

openclaw plugins install @openclaw/firecrawl-plugin
openclaw gateway restart

​

キーなし web_fetch と 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 に対する共有環境フォールバックです。
• Firecrawl 検索リクエストのデフォルトタイムアウトは 30 秒です。firecrawl_search の timeoutSeconds パラメーターで呼び出しごとに上書きできます。

​

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 を選択すると、Plugin が有効になり、別の fetch プロバイダーがすでに設定されていない限り、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

​

Firecrawl Plugin ツール

​

firecrawl_search

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

​

firecrawl_scrape

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

​

ステルス / Bot 回避

​

web_fetch が Firecrawl を使用する方法

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

​

関連

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