Chuyển đến nội dung chính
Tavily là một API tìm kiếm được thiết kế cho các ứng dụng AI. OpenClaw cung cấp Tavily theo hai cách:
  • làm nhà cung cấp web_search cho công cụ tìm kiếm chung
  • làm các công cụ Plugin rõ ràng: tavily_search và tavily_extract
Tavily trả về kết quả có cấu trúc được tối ưu hóa để LLM sử dụng, với độ sâu tìm kiếm có thể cấu hình, lọc theo chủ đề, bộ lọc miền, tóm tắt câu trả lời do AI tạo và trích xuất nội dung từ URL (bao gồm cả các trang được kết xuất bằng JavaScript).
Thuộc tínhGiá trị
ID Plugintavily
Gói@openclaw/tavily-plugin
Xác thựcTAVILY_API_KEY hoặc cấu hình apiKey
URL cơ sởhttps://api.tavily.com (mặc định)
Công cụtavily_search, tavily_extract

​
Bắt đầu

1

Cài đặt Plugin

openclaw plugins install @openclaw/tavily-plugin
2

Lấy khóa API

Tạo tài khoản Tavily tại tavily.com, sau đó tạo khóa API trong bảng điều khiển.
3

Cấu hình Plugin và nhà cung cấp

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

Xác minh tìm kiếm chạy được

Kích hoạt web_search từ bất kỳ agent nào, hoặc gọi trực tiếp tavily_search.
Chọn Tavily trong quá trình onboarding hoặc openclaw configure --section web sẽ cài đặt và bật Plugin Tavily chính thức khi cần.

​
Tham chiếu công cụ

Sử dụng công cụ này khi bạn muốn các điều khiển tìm kiếm dành riêng cho Tavily thay vì web_search chung.
Tham sốKiểuRàng buộc / mặc địnhMô tả
querystringbắt buộcChuỗi truy vấn tìm kiếm. Giữ dưới 400 ký tự.
search_depthenumbasic (mặc định), advancedadvanced chậm hơn nhưng có độ liên quan cao hơn.
topicenumgeneral (mặc định), news, financeLọc theo nhóm chủ đề.
max_resultsinteger1-20Số lượng kết quả.
include_answerbooleanmặc định falseBao gồm tóm tắt câu trả lời do Tavily AI tạo.
time_rangeenumday, week, month, yearLọc kết quả theo độ gần đây.
include_domainsstring array(không có)Chỉ bao gồm kết quả từ các miền này.
exclude_domainsstring array(không có)Loại trừ kết quả từ các miền này.
Đánh đổi về độ sâu tìm kiếm:
Độ sâuTốc độĐộ liên quanPhù hợp nhất cho
basicNhanh hơnCaoTruy vấn mục đích chung (mặc định).
advancedChậm hơnCao nhấtNghiên cứu chính xác và xác minh sự kiện.

​
tavily_extract

Sử dụng công cụ này để trích xuất nội dung sạch từ một hoặc nhiều URL. Xử lý các trang được kết xuất bằng JavaScript và hỗ trợ chia đoạn tập trung theo truy vấn để trích xuất có mục tiêu.
Tham sốKiểuRàng buộc / mặc địnhMô tả
urlsstring arraybắt buộc, 1-20URL để trích xuất nội dung.
querystring(tùy chọn)Xếp hạng lại các đoạn đã trích xuất theo mức liên quan với truy vấn này.
extract_depthenumbasic (mặc định), advancedDùng advanced cho các trang nhiều JS, SPA hoặc bảng động.
chunks_per_sourceinteger1-5; yêu cầu querySố đoạn trả về trên mỗi URL. Báo lỗi nếu đặt mà không có query.
include_imagesbooleanmặc định falseBao gồm URL hình ảnh trong kết quả.
Đánh đổi về độ sâu trích xuất:
Độ sâuKhi nào nên dùng
basicTrang đơn giản. Hãy thử tùy chọn này trước.
advancedSPA được kết xuất bằng JS, nội dung động, bảng.
Chia danh sách URL lớn hơn thành nhiều lệnh gọi tavily_extract (tối đa 20 mỗi yêu cầu). Dùng query cùng với chunks_per_source để chỉ lấy nội dung liên quan thay vì toàn bộ trang.

​
Chọn đúng công cụ

Nhu cầuCông cụ
Tìm kiếm web nhanh, không có tùy chọn đặc biệtweb_search
Tìm kiếm với độ sâu, chủ đề, câu trả lời AItavily_search
Trích xuất nội dung từ các URL cụ thểtavily_extract
Công cụ web_search chung với Tavily làm nhà cung cấp hỗ trợ query và count (tối đa 20 kết quả). Đối với các điều khiển dành riêng cho Tavily (search_depth, topic, include_answer, bộ lọc miền, khoảng thời gian), hãy dùng tavily_search thay thế.

​
Cấu hình nâng cao

Máy khách Tavily tra cứu khóa API theo thứ tự sau:
  1. plugins.entries.tavily.config.webSearch.apiKey (được phân giải thông qua SecretRefs).
  2. TAVILY_API_KEY từ môi trường Gateway.
tavily_extract phát sinh lỗi thiết lập nếu không có khóa nào.
Ghi đè plugins.entries.tavily.config.webSearch.baseUrl nếu bạn đặt Tavily phía sau proxy. Mặc định là https://api.tavily.com.
tavily_extract từ chối các lệnh gọi truyền chunks_per_source mà không có query. Tavily xếp hạng các đoạn theo mức liên quan với truy vấn, vì vậy tham số này không có ý nghĩa nếu không có truy vấn.

​
Liên quan

Tổng quan Web Search

Tất cả nhà cung cấp và quy tắc tự động phát hiện.

Firecrawl

Tìm kiếm kèm scraping với trích xuất nội dung.

Exa Search

Tìm kiếm neural với trích xuất nội dung.

Cấu hình

Lược đồ cấu hình đầy đủ cho mục nhập Plugin và định tuyến công cụ.