OpenClawDocs
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this page

Tools

Tavily

Tavily là một API tìm kiếm được thiết kế cho các ứng dụng AI. OpenClaw cung cấp API này theo hai cách:

  • dưới dạng nhà cung cấp web_search cho công cụ tìm kiếm dùng chung
  • dưới dạng các công cụ Plugin riê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, bộ lọc chủ đề, bộ lọc miền, bản tóm tắt câu trả lời do AI tạo và khả năng 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ính Giá trị
ID Plugin tavily
Gói @openclaw/tavily-plugin
Xác thực Biến môi trường TAVILY_API_KEY hoặc cấu hình apiKey
URL cơ sở https://api.tavily.com (mặc định); biến môi trường TAVILY_BASE_URL hoặc cấu hình baseUrl để ghi đè
Thời gian chờ 30 giây cho tìm kiếm, 60 giây cho trích xuất (mặc định)
Công cụ tavily_search, tavily_extract

Bắt đầu

  • Cài đặt Plugin

    bash
    openclaw plugins install @openclaw/tavily-plugin

  • 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.

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

    json5
    {  plugins: {    entries: {      tavily: {        enabled: true,        config: {          webSearch: {            apiKey: "tvly-...", // không bắt buộc nếu đã đặt TAVILY_API_KEY            baseUrl: "https://api.tavily.com",          },        },      },    },  },  tools: {    web: {      search: {        provider: "tavily",      },    },  },}

  • Xác minh tìm kiếm hoạt động

    Kích hoạt một lượt web_search từ bất kỳ tác nhân nào hoặc gọi trực tiếp tavily_search.

    • Tham chiếu công cụ

    Sử dụng công cụ này khi bạn muốn dùng các tùy chọn kiểm soát tìm kiếm riêng của Tavily thay vì web_search dùng chung.

    Tham số Kiểu Ràng buộc / mặc định Mô tả
    query chuỗi bắt buộc Chuỗi truy vấn tìm kiếm.
    search_depth enum basic (mặc định), advanced advanced chậm hơn nhưng có độ liên quan cao hơn.
    topic enum general (mặc định), news, finance Lọc theo nhóm chủ đề.
    max_results số nguyên 1-20, mặc định 5 Số lượng kết quả.
    include_answer boolean mặc định false Bao gồm bản tóm tắt câu trả lời do AI Tavily tạo.
    time_range enum day, week, month, year Lọc kết quả theo mức độ gần đây.
    include_domains mảng chuỗi (không có) Chỉ bao gồm kết quả từ các miền này.
    exclude_domains mảng chuỗi (không có) Loại trừ kết quả từ các miền này.

    Sự đánh đổi về độ sâu tìm kiếm:

    Độ sâu Tốc độ Độ liên quan Phù hợp nhất cho
    basic Nhanh hơn Cao Các truy vấn đa dụng (mặc định).
    advanced Chậm hơn Cao nhất Nghiên cứu chính xác và tìm kiếm thông tin thực tế.

    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. Công cụ xử lý được các trang kết xuất bằng JavaScript và hỗ trợ phân đoạn tập trung vào truy vấn để trích xuất có mục tiêu.

    Tham số Kiểu Ràng buộc / mặc định Mô tả
    urls mảng chuỗi bắt buộc, 1-20 Các URL cần trích xuất nội dung.
    query chuỗi (không bắt buộc) Xếp hạng lại các phân đoạn đã trích xuất theo mức độ liên quan đến truy vấn này.
    extract_depth enum basic (mặc định), advanced Dùng advanced cho các trang nặng về JS, SPA hoặc bảng động.
    chunks_per_source số nguyên 1-5; yêu cầu query Số phân đoạn trả về trên mỗi URL. Sẽ báo lỗi nếu đặt mà không có query.
    include_images boolean mặc định false Bao gồm URL hình ảnh trong kết quả.

    Sự đánh đổi về độ sâu trích xuất:

    Độ sâu Khi nào nên dùng
    basic Các trang đơn giản. Hãy thử tùy chọn này trước.
    advanced SPA được kết xuất bằng JS, nội dung động, bảng.

    Chọn công cụ phù hợp

    Nhu cầu Công cụ
    Tìm kiếm web nhanh, không cần tùy chọn đặc biệt web_search
    Tìm kiếm với độ sâu, chủ đề, câu trả lời AI tavily_search
    Trích xuất nội dung từ các URL cụ thể tavily_extract

    Cấu hình nâng cao

    Thứ tự phân giải khóa API

    Máy khách Tavily tìm 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.

    Cả tavily_search và tavily_extract đều phát sinh lỗi thiết lập nếu không có giá trị nào trong hai nguồn trên.

    URL cơ sở tùy chỉnh

    Ghi đè plugins.entries.tavily.config.webSearch.baseUrl hoặc đặt TAVILY_BASE_URL nếu bạn chuyển tiếp Tavily qua proxy. Cấu hình được ưu tiên hơn biến môi trường. Giá trị mặc định là https://api.tavily.com.

    `chunks_per_source` yêu cầu `query`

    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 phân đoạn theo mức độ liên quan đến truy vấn, vì vậy tham số này không có ý nghĩa nếu thiếu truy vấn.

    Liên quan

    Tổng quan về tìm kiếm web

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

    Tìm kiếm kết hợp thu thập dữ liệu và trích xuất nội dung.
    Tìm kiếm Exa

    Tìm kiếm nơ-ron kết hợp trích xuất nội dung.
    Cấu hình

    Lược đồ cấu hình đầy đủ cho các mục Plugin và định tuyến công cụ.
    Was this useful?
    On this page

    On this page