Chuyển đến nội dung chính

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.

OpenClaw có thể sử dụng Tavily theo hai cách:
  • làm nhà cung cấp web_search
  • làm các công cụ Plugin rõ ràng: tavily_search và tavily_extract
Tavily là một API tìm kiếm được thiết kế cho các ứng dụng AI, trả về kết quả có cấu trúc được tối ưu hóa để LLM sử dụng. Tavily hỗ trợ độ sâu tìm kiếm có thể cấu hình, lọc theo chủ đề, bộ lọc miền, bả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 trang được JavaScript kết xuất).

​
Lấy API key

  1. Tạo tài khoản Tavily tại tavily.com.
  2. Tạo API key trong dashboard.
  3. Lưu khóa đó trong cấu hình hoặc đặt TAVILY_API_KEY trong môi trường Gateway.

​
Cấu hình tìm kiếm Tavily

{
  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",
      },
    },
  },
}
Ghi chú:
  • Chọn Tavily trong onboarding hoặc openclaw configure --section web sẽ tự động bật Plugin Tavily được tích hợp sẵn.
  • Lưu cấu hình Tavily trong plugins.entries.tavily.config.webSearch.*.
  • web_search với Tavily hỗ trợ query và count (tối đa 20 kết quả).
  • Với các điều khiển riêng của Tavily như search_depth, topic, include_answer, hoặc bộ lọc miền, hãy dùng tavily_search.

​
Công cụ Plugin Tavily

Dùng công cụ này khi bạn muốn các điều khiển tìm kiếm riêng của Tavily thay vì web_search chung.
Tham sốMô tả
queryChuỗi truy vấn tìm kiếm (giữ dưới 400 ký tự)
search_depthbasic (mặc định, cân bằng) hoặc advanced (độ liên quan cao nhất, chậm hơn)
topicgeneral (mặc định), news (cập nhật theo thời gian thực), hoặc finance
max_resultsSố lượng kết quả, 1-20 (mặc định: 5)
include_answerBao gồm bản tóm tắt câu trả lời do AI tạo (mặc định: false)
time_rangeLọc theo độ mới: day, week, month, hoặc year
include_domainsMảng các miền để giới hạn kết quả
exclude_domainsMảng các miền để loại khỏi kết quả
Độ sâu tìm kiếm:
Độ sâuTốc độĐộ liên quanPhù hợp nhất cho
basicNhanh hơnCaoTruy vấn đa dụng (mặc định)
advancedChậm hơnCao nhấtĐộ chính xác, sự kiện cụ thể, nghiên cứu

​
tavily_extract

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 JavaScript kết xuất và hỗ trợ chia đoạn tập trung theo truy vấn để trích xuất có mục tiêu.
Tham sốMô tả
urlsMảng URL cần trích xuất (1-20 mỗi yêu cầu)
queryXếp hạng lại các đoạn đã trích xuất theo độ liên quan với truy vấn này
extract_depthbasic (mặc định, nhanh) hoặc advanced (cho các trang nhiều JS)
chunks_per_sourceSố đoạn trên mỗi URL, 1-5 (yêu cầu query)
include_imagesBao gồm URL hình ảnh trong kết quả (mặc định: false)
Độ sâu trích xuất:
Độ sâuKhi nào nên dùng
basicTrang đơn giản - hãy thử lựa chọn này trước
advancedSPA được JS kết xuất, nội dung động, bảng
Mẹo:
  • Tối đa 20 URL mỗi yêu cầu. Chia danh sách lớn hơn thành nhiều lệnh gọi.
  • Dùng query + chunks_per_source để chỉ lấy nội dung liên quan thay vì toàn bộ trang.
  • Thử basic trước; chuyển sang advanced nếu nội dung bị thiếu hoặc không đầy đủ.

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

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ừ URL cụ thểtavily_extract

​
Liên quan

  • Tổng quan Web Search — tất cả nhà cung cấp và tự động phát hiện
  • Firecrawl — tìm kiếm + thu thập dữ liệu 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