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.

Tavily คือ API การค้นหาที่ออกแบบมาสำหรับแอปพลิเคชัน AI OpenClaw เปิดให้ใช้งานได้สองวิธี:
  • เป็นผู้ให้บริการ web_search สำหรับเครื่องมือค้นหาทั่วไป
  • เป็นเครื่องมือ Plugin แบบชัดเจน: tavily_search และ tavily_extract
Tavily ส่งคืนผลลัพธ์แบบมีโครงสร้างที่ปรับให้เหมาะสำหรับการใช้งานของ LLM พร้อมความลึกในการค้นหาที่กำหนดค่าได้ การกรองหัวข้อ ตัวกรองโดเมน สรุปคำตอบที่สร้างโดย AI และการดึงเนื้อหาจาก URL (รวมถึงหน้าที่เรนเดอร์ด้วย JavaScript)
คุณสมบัติค่า
รหัส Plugintavily
การยืนยันตัวตนTAVILY_API_KEY หรือ config apiKey
URL พื้นฐานhttps://api.tavily.com (ค่าเริ่มต้น)
เครื่องมือที่รวมมาtavily_search, tavily_extract

​
เริ่มต้นใช้งาน

1

รับ API key

สร้างบัญชี Tavily ที่ tavily.com จากนั้นสร้าง API key ในแดชบอร์ด
2

กำหนดค่า Plugin และผู้ให้บริการ

{
  plugins: {
    entries: {
      tavily: {
        enabled: true,
        config: {
          webSearch: {
            apiKey: "tvly-...", // optional if TAVILY_API_KEY is set
            baseUrl: "https://api.tavily.com",
          },
        },
      },
    },
  },
  tools: {
    web: {
      search: {
        provider: "tavily",
      },
    },
  },
}
3

ตรวจสอบว่าการค้นหาทำงาน

เรียกใช้ web_search จาก agent ใดก็ได้ หรือเรียก tavily_search โดยตรง
การเลือก Tavily ใน onboarding หรือ openclaw configure --section web จะเปิดใช้งาน Plugin Tavily ที่รวมมาให้โดยอัตโนมัติ

​
อ้างอิงเครื่องมือ

ใช้เครื่องมือนี้เมื่อต้องการตัวควบคุมการค้นหาเฉพาะของ Tavily แทน web_search ทั่วไป
พารามิเตอร์ประเภทข้อจำกัด / ค่าเริ่มต้นคำอธิบาย
querystringจำเป็นสตริงคำค้นหา ควรสั้นกว่า 400 อักขระ
search_depthenumbasic (ค่าเริ่มต้น), advancedadvanced ช้ากว่าแต่มีความเกี่ยวข้องสูงกว่า
topicenumgeneral (ค่าเริ่มต้น), news, financeกรองตามกลุ่มหัวข้อ
max_resultsinteger1-20จำนวนผลลัพธ์
include_answerbooleanค่าเริ่มต้น falseรวมสรุปคำตอบที่สร้างโดย AI ของ Tavily
time_rangeenumday, week, month, yearกรองผลลัพธ์ตามความใหม่
include_domainsstring array(ไม่มี)รวมเฉพาะผลลัพธ์จากโดเมนเหล่านี้
exclude_domainsstring array(ไม่มี)ยกเว้นผลลัพธ์จากโดเมนเหล่านี้
ข้อแลกเปลี่ยนของความลึกในการค้นหา:
ความลึกความเร็วความเกี่ยวข้องเหมาะสำหรับ
basicเร็วกว่าสูงคำค้นหาใช้งานทั่วไป (ค่าเริ่มต้น)
advancedช้ากว่าสูงสุดการวิจัยที่ต้องการความแม่นยำและการค้นหาข้อเท็จจริง

​
tavily_extract

ใช้เครื่องมือนี้เพื่อดึงเนื้อหาที่สะอาดจาก URL หนึ่งรายการหรือหลายรายการ รองรับหน้าที่เรนเดอร์ด้วย JavaScript และรองรับการแบ่งส่วนตามคำค้นหาเพื่อการดึงข้อมูลแบบเจาะจง
พารามิเตอร์ประเภทข้อจำกัด / ค่าเริ่มต้นคำอธิบาย
urlsstring arrayจำเป็น, 1-20URL ที่ต้องการดึงเนื้อหา
querystring(ไม่บังคับ)จัดอันดับส่วนที่ดึงมาใหม่ตามความเกี่ยวข้องกับคำค้นหานี้
extract_depthenumbasic (ค่าเริ่มต้น), advancedใช้ advanced สำหรับหน้าที่ใช้ JS หนัก, SPA หรือตารางแบบไดนามิก
chunks_per_sourceinteger1-5; ต้องมี queryจำนวนส่วนที่ส่งคืนต่อ URL เกิดข้อผิดพลาดหากตั้งค่าโดยไม่มี query
include_imagesbooleanค่าเริ่มต้น falseรวม URL รูปภาพในผลลัพธ์
ข้อแลกเปลี่ยนของความลึกในการดึงข้อมูล:
ความลึกควรใช้เมื่อใด
basicหน้าง่าย ๆ ลองใช้ตัวนี้ก่อน
advancedSPA ที่เรนเดอร์ด้วย JS, เนื้อหาแบบไดนามิก, ตาราง
แบ่งรายการ URL ขนาดใหญ่เป็นการเรียก tavily_extract หลายครั้ง (สูงสุด 20 รายการต่อคำขอ) ใช้ query ร่วมกับ chunks_per_source เพื่อรับเฉพาะเนื้อหาที่เกี่ยวข้องแทนหน้าทั้งหมด

​
การเลือกเครื่องมือที่เหมาะสม

ความต้องการเครื่องมือ
ค้นหาเว็บอย่างรวดเร็ว ไม่มีตัวเลือกพิเศษweb_search
ค้นหาพร้อมความลึก หัวข้อ คำตอบจาก AItavily_search
ดึงเนื้อหาจาก URL ที่ระบุtavily_extract
เครื่องมือ web_search ทั่วไปที่ใช้ Tavily เป็นผู้ให้บริการรองรับ query และ count (สูงสุด 20 ผลลัพธ์) สำหรับตัวควบคุมเฉพาะของ Tavily (search_depth, topic, include_answer, ตัวกรองโดเมน, ช่วงเวลา) ให้ใช้ tavily_search แทน

​
การกำหนดค่าขั้นสูง

ไคลเอนต์ Tavily ค้นหา API key ตามลำดับนี้:
  1. plugins.entries.tavily.config.webSearch.apiKey (แก้ไขผ่าน SecretRefs)
  2. TAVILY_API_KEY จากสภาพแวดล้อม Gateway
tavily_extract จะแจ้งข้อผิดพลาดการตั้งค่าหากไม่มีทั้งสองรายการ
แทนที่ plugins.entries.tavily.config.webSearch.baseUrl หากคุณส่ง Tavily ผ่านพร็อกซี ค่าเริ่มต้นคือ https://api.tavily.com
tavily_extract ปฏิเสธการเรียกที่ส่ง chunks_per_source โดยไม่มี query Tavily จัดอันดับส่วนต่าง ๆ ตามความเกี่ยวข้องกับคำค้นหา ดังนั้นพารามิเตอร์นี้จึงไม่มีความหมายหากไม่มีคำค้นหา

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

ภาพรวมการค้นหาเว็บ

ผู้ให้บริการทั้งหมดและกฎการตรวจจับอัตโนมัติ

Firecrawl

การค้นหาพร้อมการสแครปและการดึงเนื้อหา

Exa Search

การค้นหาแบบ neural พร้อมการดึงเนื้อหา

การกำหนดค่า

สคีมา config แบบเต็มสำหรับรายการ Plugin และการกำหนดเส้นทางเครื่องมือ