> ## Documentation Index
> Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Firecrawl

OpenClaw може використовувати **Firecrawl** трьома способами:

* як провайдера `web_search`
* як явні інструменти Plugin: `firecrawl_search` і `firecrawl_scrape`
* як резервний екстрактор для `web_fetch`

Це розміщений сервіс витягування даних і пошуку, який підтримує обхід бот-захисту та кешування,
що допомагає із сайтами з великою кількістю JS або сторінками, які блокують звичайні HTTP-запити.

## Установлення Plugin

Установіть офіційний Plugin, а потім перезапустіть Gateway:

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw plugins install @openclaw/firecrawl-plugin
openclaw gateway restart
```

## web\_fetch без ключа й API-ключі

Явно вибраний резервний розміщений Firecrawl для `web_fetch` підтримує стартовий
доступ без API-ключа. Додайте `FIRECRAWL_API_KEY` у середовище gateway
або налаштуйте його, коли потрібні вищі ліміти. Firecrawl `web_search` і
`firecrawl_scrape` потребують API-ключа.

## Налаштування пошуку Firecrawl

```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
{
  tools: {
    web: {
      search: {
        provider: "firecrawl",
      },
    },
  },
  plugins: {
    entries: {
      firecrawl: {
        enabled: true,
        config: {
          webSearch: {
            apiKey: "FIRECRAWL_API_KEY_HERE",
            baseUrl: "https://api.firecrawl.dev",
          },
        },
      },
    },
  },
}
```

Примітки:

* Вибір Firecrawl під час onboarding або `openclaw configure --section web` автоматично вмикає встановлений Plugin Firecrawl.
* `web_search` із Firecrawl підтримує `query` і `count`.
* Для специфічних елементів керування Firecrawl, як-от `sources`, `categories` або scraping результатів, використовуйте `firecrawl_search`.
* `baseUrl` за замовчуванням вказує на розміщений Firecrawl за адресою `https://api.firecrawl.dev`. Самостійно розміщені перевизначення дозволені лише для приватних/внутрішніх кінцевих точок; HTTP приймається лише для таких приватних цілей.
* `FIRECRAWL_BASE_URL` є спільним резервним значенням env для базових URL пошуку й scrape у Firecrawl.

## Налаштування резервного Firecrawl для web\_fetch

```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
{
  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` для вищих лімітів.
* Вибір Firecrawl під час onboarding або `openclaw configure --section web` вмикає Plugin і вибирає Firecrawl для `web_fetch`, якщо інший провайдер fetch ще не налаштований.
* `firecrawl_scrape` потребує API-ключа.
* `maxAgeMs` керує тим, наскільки старими можуть бути кешовані результати (мс). За замовчуванням — 2 дні.
* Застаріла конфігурація `tools.web.fetch.firecrawl.*` автоматично мігрується командою `openclaw doctor --fix`.
* Перевизначення URL для scrape/base у Firecrawl дотримуються того самого правила для розміщених/приватних цілей, що й пошук: публічний розміщений трафік використовує `https://api.firecrawl.dev`; самостійно розміщені перевизначення мають резолвитися у приватні/внутрішні кінцеві точки.
* `firecrawl_scrape` відхиляє очевидні приватні, loopback, metadata та не-HTTP(S) цільові URL перед пересиланням їх до Firecrawl, відповідно до контракту безпеки цілей `web_fetch` для явних викликів scrape Firecrawl.

`firecrawl_scrape` повторно використовує ті самі налаштування `plugins.entries.firecrawl.config.webFetch.*` і змінні env, зокрема потрібний API-ключ.

### Самостійно розміщений Firecrawl

Установіть `plugins.entries.firecrawl.config.webSearch.baseUrl`,
`plugins.entries.firecrawl.config.webFetch.baseUrl` або `FIRECRAWL_BASE_URL`,
коли запускаєте Firecrawl самостійно. OpenClaw приймає `http://` лише для цілей
loopback, приватної мережі, `.local`, `.internal` або `.localhost`. Публічні користувацькі
хости відхиляються, щоб API-ключі Firecrawl випадково не надсилалися на довільні кінцеві точки.

## Інструменти Plugin Firecrawl

### `firecrawl_search`

Використовуйте це, коли потрібні специфічні елементи керування пошуком Firecrawl замість загального `web_search`.

Основні параметри:

* `query`
* `count`
* `sources`
* `categories`
* `scrapeResults`
* `timeoutSeconds`

### `firecrawl_scrape`

Використовуйте це для сторінок із великою кількістю JS або захистом від ботів, де звичайний `web_fetch` слабкий.

Основні параметри:

* `url`
* `extractMode`
* `maxChars`
* `onlyMainContent`
* `maxAgeMs`
* `proxy`
* `storeInCache`
* `timeoutSeconds`

## Непомітність / обхід бот-захисту

Firecrawl надає параметр **proxy mode** для обходу бот-захисту (`basic`, `stealth` або `auto`).
OpenClaw завжди використовує `proxy: "auto"` разом із `storeInCache: true` для запитів Firecrawl.
Якщо proxy опущено, Firecrawl за замовчуванням використовує `auto`. `auto` повторює спробу зі stealth-проксі, якщо базова спроба не вдалася, що може використовувати більше кредитів,
ніж scraping лише в basic-режимі.

## Як `web_fetch` використовує Firecrawl

Порядок витягування в `web_fetch`:

1. Readability (локально)
2. Firecrawl (коли вибрано або автоматично виявлено з налаштованих облікових даних)
3. Базове очищення HTML (останній резервний варіант)

Перемикач вибору — `tools.web.fetch.provider`. Якщо його опустити, OpenClaw
автоматично виявляє першого готового провайдера web-fetch з доступних облікових даних.
Офіційний Plugin Firecrawl надає цей резервний варіант.

## Пов’язане

* [Огляд Web Search](/uk/tools/web) -- усі провайдери й автоматичне виявлення
* [Web Fetch](/uk/tools/web-fetch) -- інструмент web\_fetch із резервним Firecrawl
* [Tavily](/uk/tools/tavily) -- інструменти пошуку й витягування даних