Skip to main content

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.

เครื่องมือ web_fetch ทำ HTTP GET แบบธรรมดาและดึงเนื้อหาที่อ่านได้ (HTML เป็น markdown หรือข้อความ) เครื่องมือนี้ ไม่ เรียกใช้ JavaScript. สำหรับเว็บไซต์ที่ใช้ JS หนักหรือหน้าที่ป้องกันด้วยการเข้าสู่ระบบ ให้ใช้ เว็บเบราว์เซอร์ แทน

​
เริ่มต้นอย่างรวดเร็ว

web_fetch เปิดใช้งานตามค่าเริ่มต้น — ไม่ต้องกำหนดค่า Agent สามารถ เรียกใช้ได้ทันที: 
await web_fetch({ url: "https://example.com/article" });

​
พารามิเตอร์ของเครื่องมือ

​
url
string
required
URL ที่จะดึงข้อมูล รองรับเฉพาะ http(s) เท่านั้น
​
extractMode
'markdown' | 'text'
default:"markdown"
รูปแบบเอาต์พุตหลังจากดึงเนื้อหาหลักแล้ว
​
maxChars
number
ตัดเอาต์พุตให้เหลือจำนวนอักขระเท่านี้

​
วิธีการทำงาน

1

Fetch

ส่ง HTTP GET พร้อม User-Agent ที่คล้าย Chrome และส่วนหัว Accept-Language บล็อกชื่อโฮสต์ส่วนตัว/ภายในและตรวจสอบการเปลี่ยนเส้นทางซ้ำ
2

Extract

รัน Readability (การดึงเนื้อหาหลัก) กับการตอบกลับ HTML
3

Fallback (optional)

หาก Readability ล้มเหลวและมีการกำหนดค่า Firecrawl ไว้ จะลองใหม่ผ่าน Firecrawl API ด้วยโหมดหลบเลี่ยงบอต
4

Cache

ผลลัพธ์จะถูกแคชเป็นเวลา 15 นาที (กำหนดค่าได้) เพื่อลดการดึงข้อมูลซ้ำ จาก URL เดิม

​
การกำหนดค่า

{
  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 สำรอง

หากการดึงข้อมูลด้วย Readability ล้มเหลว web_fetch สามารถสำรองไปใช้ 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,
          },
        },
      },
    },
  },
}
plugins.entries.firecrawl.config.webFetch.apiKey รองรับออบเจ็กต์ SecretRef การกำหนดค่าเดิม tools.web.fetch.firecrawl.* จะถูกย้ายโดยอัตโนมัติด้วย openclaw doctor --fix
หากเปิดใช้งาน Firecrawl และ SecretRef ของมันยัง resolve ไม่ได้โดยไม่มี FIRECRAWL_API_KEY env สำรอง การเริ่มต้น Gateway จะล้มเหลวทันที
การ override baseUrl ของ Firecrawl ถูกจำกัดอย่างเข้มงวด: ทราฟฟิกที่โฮสต์จะใช้ https://api.firecrawl.dev; การ override แบบ self-hosted ต้องชี้ไปยัง endpoint ส่วนตัวหรือภายใน และ http:// จะยอมรับเฉพาะสำหรับเป้าหมายส่วนตัวเหล่านั้น
พฤติกรรม runtime ปัจจุบัน:
  • tools.web.fetch.provider เลือกผู้ให้บริการสำรองสำหรับการดึงข้อมูลอย่างชัดเจน
  • หากละ provider ไว้ OpenClaw จะตรวจหา provider สำหรับ web-fetch ตัวแรกที่พร้อมใช้งาน จากข้อมูลรับรองที่มีโดยอัตโนมัติ web_fetch ที่ไม่อยู่ใน sandbox สามารถใช้ plugins ที่ติดตั้งไว้ซึ่งประกาศ contracts.webFetchProviders และลงทะเบียน provider ที่ตรงกันใน runtime ได้ ปัจจุบัน provider ที่รวมมาให้คือ Firecrawl
  • การเรียก web_fetch แบบ sandboxed ยังคงจำกัดไว้เฉพาะ provider ที่รวมมาให้
  • หากปิดใช้งาน Readability web_fetch จะข้ามตรงไปยัง provider สำรองที่เลือกไว้ หากไม่มี provider ที่พร้อมใช้งาน จะล้มเหลวแบบปิด

​
พร็อกซี env ที่เชื่อถือได้

หาก deployment ของคุณต้องให้ web_fetch ผ่านพร็อกซีขาออก HTTP(S) ที่เชื่อถือได้ ให้ตั้งค่า tools.web.fetch.useTrustedEnvProxy: true ในโหมดนี้ OpenClaw ยังคงใช้การตรวจ SSRF ตามชื่อโฮสต์ก่อนส่งคำขอ แต่จะให้พร็อกซี resolve DNS แทนการทำ DNS pinning ภายในเครื่อง เปิดใช้สิ่งนี้เฉพาะเมื่อพร็อกซีถูกควบคุมโดยผู้ปฏิบัติการและบังคับใช้นโยบาย ขาออกหลังจากการ resolve DNS แล้วเท่านั้น
หากไม่ได้กำหนดค่าตัวแปร env สำหรับพร็อกซี HTTP(S) หรือโฮสต์เป้าหมายถูกยกเว้นโดย NO_PROXY web_fetch จะย้อนกลับไปใช้เส้นทางเข้มงวดปกติพร้อม DNS pinning ภายในเครื่อง

​
ขีดจำกัดและความปลอดภัย

  • maxChars ถูกจำกัดไม่ให้เกิน tools.web.fetch.maxCharsCap
  • เนื้อหาการตอบกลับถูกจำกัดที่ maxResponseBytes ก่อน parsing; การตอบกลับที่ใหญ่เกินไป จะถูกตัดพร้อมคำเตือน
  • ชื่อโฮสต์ส่วนตัว/ภายในถูกบล็อก
  • tools.web.fetch.ssrfPolicy.allowRfc2544BenchmarkRange และ tools.web.fetch.ssrfPolicy.allowIpv6UniqueLocalRange เป็นการ opt-in แบบจำกัด สำหรับสแต็กพร็อกซี fake-IP ที่เชื่อถือได้; อย่าตั้งค่าเว้นแต่พร็อกซีของคุณเป็นเจ้าของ ช่วงสังเคราะห์เหล่านั้นและบังคับใช้นโยบายปลายทางของตัวเอง
  • การเปลี่ยนเส้นทางจะถูกตรวจสอบและจำกัดด้วย maxRedirects
  • useTrustedEnvProxy เป็นการ opt-in ที่ชัดเจน และควรเปิดใช้เฉพาะกับ พร็อกซีที่ถูกควบคุมโดยผู้ปฏิบัติการซึ่งยังคงบังคับใช้นโยบายขาออกหลังจาก การ resolve DNS
  • web_fetch เป็นแบบ best-effort — บางเว็บไซต์ต้องใช้ เว็บเบราว์เซอร์

​
โปรไฟล์เครื่องมือ

หากคุณใช้โปรไฟล์เครื่องมือหรือ allowlists ให้เพิ่ม web_fetch หรือ group:web: 
{
  tools: {
    allow: ["web_fetch"],
    // or: allow: ["group:web"]  (includes web_fetch, web_search, and x_search)
  },
}

​
ที่เกี่ยวข้อง