---
read_when:
    - คุณต้องการการค้นหาเว็บที่ขับเคลื่อนด้วย Tavily
    - คุณต้องใช้คีย์ API ของ Tavily
    - คุณต้องการใช้ Tavily เป็นผู้ให้บริการ `web_search`
    - คุณต้องการดึงเนื้อหาจาก URL
summary: เครื่องมือค้นหาและดึงข้อมูลของ Tavily
title: Tavily
x-i18n:
    generated_at: "2026-04-24T09:38:40Z"
    model: gpt-5.4
    provider: openai
    source_hash: 9af858cd8507e3ebe6614f0695f568ce589798c816c8475685526422a048ef1a
    source_path: tools/tavily.md
    workflow: 15
---

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

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

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

## รับคีย์ API

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

## กำหนดค่า Tavily search

```json5
{
  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](/th/tools/web) -- ผู้ให้บริการทั้งหมดและการตรวจจับอัตโนมัติ
- [Firecrawl](/th/tools/firecrawl) -- การค้นหา + การสแครปพร้อมการดึงเนื้อหา
- [Exa Search](/th/tools/exa-search) -- การค้นหาแบบ neural พร้อมการดึงเนื้อหา
