Tavily

OpenClaw สามารถใช้ Tavily ได้ 2 วิธี:

• เป็นผู้ให้บริการ web_search
• เป็นเครื่องมือ Plugin แบบระบุชัดเจน: tavily_search และ tavily_extract

Tavily เป็น API สำหรับการค้นหาที่ออกแบบมาสำหรับแอปพลิเคชัน AI โดยส่งคืนผลลัพธ์แบบมีโครงสร้าง ที่ปรับให้เหมาะกับการใช้งานของ LLM รองรับการกำหนด search depth, การกรองตามหัวข้อ, ตัวกรองโดเมน, สรุปคำตอบที่สร้างโดย AI และการดึงเนื้อหาจาก URL (รวมถึงหน้าที่เรนเดอร์ด้วย JavaScript)

# รับคีย์ API

1. สร้างบัญชี Tavily ที่ tavily.com
2. สร้างคีย์ API ในแดชบอร์ด
3. จัดเก็บไว้ใน config หรือตั้งค่า TAVILY_API_KEY ในสภาพแวดล้อมของ Gateway

# กำหนดค่า Tavily search

{
  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",
      },
    },
  },
}

หมายเหตุ:

• การเลือก Tavily ระหว่าง onboarding หรือ openclaw configure --section web จะเปิดใช้งาน Plugin Tavily ที่มาพร้อมกันโดยอัตโนมัติ
• จัดเก็บ config ของ Tavily ไว้ใต้ plugins.entries.tavily.config.webSearch.*
• web_search ที่ใช้ Tavily รองรับ query และ count (สูงสุด 20 ผลลัพธ์)
• หากต้องการตัวควบคุมเฉพาะของ Tavily เช่น search_depth, topic, include_answer หรือตัวกรองโดเมน ให้ใช้ tavily_search

# เครื่องมือ Plugin ของ Tavily

# tavily_search

ใช้สิ่งนี้เมื่อคุณต้องการตัวควบคุมการค้นหาเฉพาะของ Tavily แทน web_search แบบทั่วไป

พารามิเตอร์	คำอธิบาย
query	สตริงคำค้นหา (ควรยาวไม่เกิน 400 อักขระ)
search_depth	basic (ค่าเริ่มต้น, สมดุล) หรือ advanced (เกี่ยวข้องสูงสุด, ช้ากว่า)
topic	general (ค่าเริ่มต้น), news (อัปเดตแบบเรียลไทม์), หรือ finance
max_results	จำนวนผลลัพธ์ 1-20 (ค่าเริ่มต้น: 5)
include_answer	รวมสรุปคำตอบที่สร้างโดย AI (ค่าเริ่มต้น: false)
time_range	กรองตามความใหม่: day, week, month หรือ year
include_domains	อาร์เรย์ของโดเมนที่ต้องการจำกัดผลลัพธ์ให้อยู่ภายใน
exclude_domains	อาร์เรย์ของโดเมนที่ต้องการตัดออกจากผลลัพธ์

Search depth:

Depth	ความเร็ว	ความเกี่ยวข้อง	เหมาะที่สุดสำหรับ
basic	เร็วกว่า	สูง	คำค้นหาใช้งานทั่วไป (ค่าเริ่มต้น)
advanced	ช้ากว่า	สูงสุด	ความแม่นยำ, ข้อเท็จจริงเฉพาะ, งานวิจัย

# tavily_extract

ใช้สิ่งนี้เพื่อดึงเนื้อหาที่สะอาดจาก URL หนึ่งหรือหลายรายการ รองรับ หน้าที่เรนเดอร์ด้วย JavaScript และรองรับการแบ่งเป็นชิ้นโดยโฟกัสตามคำค้นหาเพื่อการดึงข้อมูล แบบเจาะจง

พารามิเตอร์	คำอธิบาย
urls	อาร์เรย์ของ URL ที่ต้องการดึงข้อมูล (1-20 ต่อคำขอ)
query	จัดลำดับชิ้นเนื้อหาที่ดึงมาใหม่ตามความเกี่ยวข้องกับคำค้นหานี้
extract_depth	basic (ค่าเริ่มต้น, เร็ว) หรือ advanced (สำหรับหน้าที่ใช้ JS หนัก)
chunks_per_source	จำนวนชิ้นต่อ URL, 1-5 (ต้องใช้ร่วมกับ query)
include_images	รวม URL ของภาพในผลลัพธ์ (ค่าเริ่มต้น: false)

Extract depth:

Depth	ใช้เมื่อใด
basic	หน้าธรรมดา - ลองสิ่งนี้ก่อน
advanced	SPA ที่เรนเดอร์ด้วย JS, เนื้อหาแบบไดนามิก, ตาราง

เคล็ดลับ:

• สูงสุด 20 URL ต่อคำขอ แบ่งรายการที่ใหญ่กว่านี้เป็นหลายคำขอ
• ใช้ query + chunks_per_source เพื่อรับเฉพาะเนื้อหาที่เกี่ยวข้องแทนทั้งหน้า
• ลอง basic ก่อน; fallback ไปใช้ advanced หากเนื้อหาหายไปหรือไม่ครบถ้วน

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

ความต้องการ	เครื่องมือ
ค้นหาเว็บอย่างรวดเร็ว ไม่มีตัวเลือกพิเศษ	web_search
ค้นหาพร้อม depth, topic, คำตอบจาก AI	tavily_search
ดึงเนื้อหาจาก URL ที่ระบุ	tavily_extract

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

• ภาพรวม Web Search -- ผู้ให้บริการทั้งหมดและการตรวจจับอัตโนมัติ
• Firecrawl -- การค้นหา + การสแครปพร้อมการดึงเนื้อหา
• Exa Search -- การค้นหาแบบ neural พร้อมการดึงเนื้อหา