جلب الويب

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

​

البدء السريع

await web_fetch({ url: "https://example.com/article" });

​

معاملات الأداة

​

كيف تعمل

​

الإعداد

{
  tools: {
    web: {
      fetch: {
        enabled: true, // default: true
        provider: "firecrawl", // optional; omit for auto-detect
        maxChars: 50000, // max output chars
        maxCharsCap: 50000, // hard cap for maxChars param
        maxResponseBytes: 2000000, // max download size before truncation
        timeoutSeconds: 30,
        cacheTtlMinutes: 15,
        maxRedirects: 3,
        useTrustedEnvProxy: false, // let a trusted HTTP(S) env proxy resolve DNS
        readability: true, // use Readability extraction
        userAgent: "Mozilla/5.0 ...", // override User-Agent
        ssrfPolicy: {
          allowRfc2544BenchmarkRange: true, // opt-in for trusted fake-IP proxies using 198.18.0.0/15
          allowIpv6UniqueLocalRange: true, // opt-in for trusted fake-IP proxies using fc00::/7
        },
      },
    },
  },
}

​

الخيار الاحتياطي Firecrawl

{
  tools: {
    web: {
      fetch: {
        provider: "firecrawl", // optional; omit for auto-detect from available credentials
      },
    },
  },
  plugins: {
    entries: {
      firecrawl: {
        enabled: true,
        config: {
          webFetch: {
            apiKey: "fc-...", // optional if FIRECRAWL_API_KEY is set
            baseUrl: "https://api.firecrawl.dev",
            onlyMainContent: true,
            maxAgeMs: 86400000, // cache duration (1 day)
            timeoutSeconds: 60,
          },
        },
      },
    },
  },
}

• يحدد tools.web.fetch.provider موفر خيار الجلب الاحتياطي صراحةً.
• إذا حُذف provider، يكتشف OpenClaw تلقائيًا أول موفر web-fetch جاهز من بيانات الاعتماد المتاحة. يمكن لـ web_fetch غير المعزول استخدام Plugins المثبتة التي تعلن contracts.webFetchProviders وتُسجّل موفرًا مطابقًا في وقت التشغيل. حاليًا الموفر المضمّن هو Firecrawl.
• تبقى استدعاءات web_fetch المعزولة مقتصرة على الموفرين المضمّنين.
• إذا كان Readability معطلًا، يتخطى web_fetch مباشرةً إلى الخيار الاحتياطي للموفر المحدد. إذا لم يتوفر أي موفر، فإنه يفشل بشكل مغلق.

​

وكيل البيئة الموثوق

​

الحدود والسلامة

• يُقيّد maxChars إلى tools.web.fetch.maxCharsCap
• يُحدّ جسم الاستجابة عند maxResponseBytes قبل التحليل؛ وتُقتطع الاستجابات كبيرة الحجم مع تحذير
• تُحظر أسماء المضيفين الخاصة/الداخلية
• يُعد tools.web.fetch.ssrfPolicy.allowRfc2544BenchmarkRange و tools.web.fetch.ssrfPolicy.allowIpv6UniqueLocalRange تفعيلين اختياريين ضيقين لمكدسات وكلاء fake-IP الموثوقة؛ اتركهما غير مضبوطين ما لم يكن وكيلك يمتلك تلك النطاقات الاصطناعية ويفرض سياسة وجهته الخاصة
• تُفحص عمليات إعادة التوجيه وتُحد بواسطة maxRedirects
• يُعد useTrustedEnvProxy تفعيلًا اختياريًا صريحًا ويجب ألا يُمكّن إلا للوكلاء الخاضعين لتحكم المشغّل الذين لا يزالون يفرضون سياسة الصادر بعد حل DNS
• web_fetch جهدها الأفضل — بعض المواقع تحتاج إلى متصفح الويب

​

ملفات تعريف الأدوات

{
  tools: {
    allow: ["web_fetch"],
    // or: allow: ["group:web"]  (includes web_fetch, web_search, and x_search)
  },
}

​

ذات صلة

• بحث الويب — ابحث في الويب باستخدام موفرين متعددين
• متصفح الويب — أتمتة متصفح كاملة للمواقع المعتمدة بكثافة على JS
• Firecrawl — أدوات البحث والكشط من Firecrawl