​

Firecrawl

• كموفّر web_search
• كأدوات plugin صريحة: firecrawl_search و firecrawl_scrape
• كأداة استخراج بديلة لـ web_fetch

​

الحصول على مفتاح API

1. أنشئ حساب Firecrawl وأنشئ مفتاح API.
2. خزّنه في التهيئة أو عيّن FIRECRAWL_API_KEY في بيئة gateway.

​

تهيئة بحث 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 إلى تمكين plugin Firecrawl المضمّن تلقائيًا.
• يدعم web_search مع Firecrawl كلًا من query و count.
• لاستخدام عناصر تحكم خاصة بـ Firecrawl مثل sources أو categories أو استخراج النتائج، استخدم firecrawl_search.
• يجب أن تبقى أي تجاوزات لـ baseUrl على https://api.firecrawl.dev.
• يُعد FIRECRAWL_BASE_URL خيار env الاحتياطي المشترك لعناوين Firecrawl الأساسية للبحث والاستخراج.

​

تهيئة Firecrawl scrape + بديل web_fetch

{
  plugins: {
    entries: {
      firecrawl: {
        enabled: true,
        config: {
          webFetch: {
            apiKey: "FIRECRAWL_API_KEY_HERE",
            baseUrl: "https://api.firecrawl.dev",
            onlyMainContent: true,
            maxAgeMs: 172800000,
            timeoutSeconds: 60,
          },
        },
      },
    },
  },
}

• لا تُجرى محاولات البديل Firecrawl إلا عند توفر مفتاح API (plugins.entries.firecrawl.config.webFetch.apiKey أو FIRECRAWL_API_KEY).
• يتحكم maxAgeMs في عمر النتائج المخزنة مؤقتًا المسموح به (بالملي ثانية). الافتراضي هو يومان.
• تُرحَّل تلقائيًا تهيئة tools.web.fetch.firecrawl.* القديمة بواسطة openclaw doctor --fix.
• تقتصر تجاوزات Firecrawl scrape/base URL على https://api.firecrawl.dev.

​

أدوات plugin Firecrawl

​

firecrawl_search

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

​

firecrawl_scrape

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

​

Stealth / تجاوز آليات مكافحة الروبوتات

​

كيف يستخدم web_fetch Firecrawl

1. Readability (محلي)
2. Firecrawl (إذا تم اختياره أو اكتشافه تلقائيًا باعتباره بديل web-fetch النشط)
3. تنظيف HTML أساسي (البديل الأخير)

​

ذو صلة

• نظرة عامة على Web Search — جميع الموفّرين والكشف التلقائي
• Web Fetch — أداة web_fetch مع بديل Firecrawl
• Tavily — أدوات البحث + الاستخراج