Firecrawl

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

​

Встановлення плагіна

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

​

Доступ без ключа та ключі API

• Пошук Firecrawl (firecrawl) — використовує розміщений у хмарі API /v2/search із вашим ключем; автоматично виявляється за наявності ключа.
• Пошук Firecrawl (безплатний) (firecrawl-free) — використовує розміщений у хмарі початковий рівень без ключа; ключ API не потрібен. Він доступний лише за явним вибором і ніколи не вибирається автоматично, оскільки його вибір надсилає ваші пошукові запити до безплатного рівня Firecrawl.

​

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

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

• Вибір Firecrawl під час початкового налаштування або openclaw configure --section web автоматично вмикає встановлений плагін Firecrawl.
• Виберіть Пошук Firecrawl (безплатний) під час початкового налаштування (або встановіть provider: "firecrawl-free"), щоб працювати без ключа API. Провайдер Пошук Firecrawl із ключем надсилає plugins.entries.firecrawl.config.webSearch.apiKey або FIRECRAWL_API_KEY.
• web_search із Firecrawl підтримує query і count.
• Для специфічних елементів керування Firecrawl, як-от sources, categories або видобування даних із результатів, використовуйте firecrawl_search.
• baseUrl за замовчуванням використовує розміщений у хмарі Firecrawl за адресою https://api.firecrawl.dev. Перевизначення для самостійно розміщених екземплярів дозволені лише для приватних або внутрішніх кінцевих точок; HTTP приймається лише для таких приватних цілей.
• FIRECRAWL_BASE_URL — спільна резервна змінна середовища для базових URL-адрес пошуку й видобування даних Firecrawl.
• Стандартний час очікування пошукових запитів Firecrawl становить 30 секунд; параметр timeoutSeconds інструмента firecrawl_search перевизначає його для окремого виклику.

​

Налаштування резервного засобу 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,
          },
        },
      },
    },
  },
}

• Явно вибраний резервний засіб web_fetch Firecrawl працює без ключа API. Якщо його налаштовано, OpenClaw надсилає plugins.entries.firecrawl.config.webFetch.apiKey або FIRECRAWL_API_KEY для отримання вищих лімітів.
• Вибір Firecrawl під час початкового налаштування або openclaw configure --section web вмикає плагін і вибирає Firecrawl для web_fetch, якщо інший провайдер отримання даних ще не налаштований.
• firecrawl_scrape потребує ключа API.
• maxAgeMs визначає допустимий вік кешованих результатів (мс). Значення за замовчуванням — 172,800,000 мс (2 дні).
• onlyMainContent за замовчуванням має значення true; timeoutSeconds за замовчуванням має значення 60.
• Застарілу конфігурацію tools.web.fetch.firecrawl.* і tools.web.search.firecrawl.* автоматично переносить openclaw doctor --fix.
• Перевизначення URL-адрес видобування даних і базових URL-адрес Firecrawl дотримуються того самого правила щодо розміщених у хмарі та приватних ресурсів, що й пошук: публічний хмарний трафік використовує https://api.firecrawl.dev; перевизначення для самостійно розміщених екземплярів мають відповідати приватним або внутрішнім кінцевим точкам.
• firecrawl_scrape відхиляє очевидно приватні, зворотні, метадані та цільові URL-адреси, що не використовують HTTP(S), перш ніж передавати їх Firecrawl, відповідно до контракту безпеки цілей web_fetch для явних викликів видобування даних Firecrawl.

​

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

​

Інструменти плагіна Firecrawl

​

firecrawl_search

• query
• count (1-100)
• sources
• categories
• includeDomains / excludeDomains (лише імена хостів; взаємовиключні)
• tbs (часовий фільтр, наприклад qdr:d, qdr:w, sbd:1)
• location і country (географічне націлювання)
• scrapeResults
• timeoutSeconds

​

firecrawl_scrape

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

​

Прихований режим і обхід захисту від ботів

​

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

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

​

Пов’язані матеріали

• Огляд вебпошуку — усі провайдери й автоматичне виявлення
• Отримання вебданих — інструмент web_fetch із резервним засобом Firecrawl
• Tavily — інструменти пошуку й видобування даних