Tìm kiếm Exa

Exa AI là nhà cung cấp web_search với các chế độ tìm kiếm nơ-ron, từ khóa và kết hợp, cùng khả năng trích xuất nội dung tích hợp sẵn (phần nổi bật, văn bản, bản tóm tắt).

​

Cài đặt Plugin

openclaw plugins install @openclaw/exa-plugin
openclaw gateway restart

​

Lấy khóa API

1. Tạo tài khoản

   Đăng ký tại exa.ai và tạo khóa API từ bảng điều khiển của bạn.

2. Lưu khóa

   Đặt EXA_API_KEY trong môi trường Gateway hoặc cấu hình bằng:

   openclaw configure --section web
   

​

Cấu hình

{
  plugins: {
    entries: {
      exa: {
        config: {
          webSearch: {
            apiKey: "exa-...", // không bắt buộc nếu đã đặt EXA_API_KEY
            baseUrl: "https://api.exa.ai", // không bắt buộc; OpenClaw nối thêm /search
          },
        },
      },
    },
  },
  tools: {
    web: {
      search: {
        provider: "exa",
      },
    },
  },
}

Phương án thay thế bằng biến môi trường: đặt EXA_API_KEY trong môi trường Gateway. Đối với bản cài đặt Gateway, hãy đặt biến này trong ~/.openclaw/.env. Xem Biến môi trường.

​

Ghi đè URL cơ sở

Đặt plugins.entries.exa.config.webSearch.baseUrl để định tuyến các yêu cầu tìm kiếm Exa qua một proxy tương thích hoặc điểm cuối thay thế. OpenClaw chuẩn hóa các máy chủ không có giao thức bằng cách thêm https:// vào đầu và nối thêm /search, trừ khi đường dẫn đã kết thúc bằng phần này. Điểm cuối đã phân giải là một phần của khóa bộ nhớ đệm tìm kiếm, vì vậy kết quả từ các điểm cuối khác nhau không bao giờ được dùng chung.

​

Tham số công cụ

query · string · bắt buộc

Truy vấn tìm kiếm.

count · number · mặc định: "5"

Số kết quả trả về (1-100, tùy thuộc vào giới hạn của loại tìm kiếm Exa).

type · 'auto' | 'neural' | 'fast' | 'deep' | 'deep-reasoning' | 'instant'

Chế độ tìm kiếm.

freshness · 'day' | 'week' | 'month' | 'year'

Bộ lọc thời gian. Không thể kết hợp với date_after/date_before.

date_after · string

Các kết quả sau ngày này (YYYY-MM-DD).

date_before · string

Các kết quả trước ngày này (YYYY-MM-DD).

contents · object

Các tùy chọn trích xuất nội dung (xem bên dưới).

​

Trích xuất nội dung

Truyền một đối tượng contents để kiểm soát nội dung được trích xuất trong kết quả:

await web_search({
  query: "transformer architecture explained",
  type: "neural",
  contents: {
    text: true, // toàn bộ văn bản của trang
    highlights: { numSentences: 3 }, // các câu chính
    summary: true, // bản tóm tắt bằng AI
  },
});

Tùy chọn nội dung	Kiểu	Mô tả
text	boolean | { maxCharacters }	Trích xuất toàn bộ văn bản của trang
highlights	boolean | { maxCharacters, query, numSentences, highlightsPerUrl }	Trích xuất các câu chính
summary	boolean | { query }	Bản tóm tắt do AI tạo

Nếu bỏ qua contents, Exa mặc định sử dụng { highlights: true } để kết quả bao gồm các đoạn trích chứa câu chính. Phần mô tả kết quả được lấy lần lượt từ phần nổi bật, sau đó là bản tóm tắt, rồi toàn bộ văn bản — tùy nội dung nào khả dụng trước. Kết quả cũng giữ nguyên các trường highlightScores và summary thô từ phản hồi API Exa khi có.

​

Chế độ tìm kiếm

Chế độ	Mô tả
auto	Exa chọn chế độ tốt nhất (mặc định)
neural	Tìm kiếm theo ngữ nghĩa/ý nghĩa
fast	Tìm kiếm nhanh theo từ khóa
deep	Tìm kiếm sâu và toàn diện
deep-reasoning	Tìm kiếm sâu có suy luận
instant	Kết quả nhanh nhất

​

Lưu ý

• count chấp nhận tối đa 100, tùy thuộc vào giới hạn của loại tìm kiếm Exa.
• Theo mặc định, kết quả được lưu vào bộ nhớ đệm trong 15 phút. Cấu hình các tùy chọn dùng chung tools.web.search.cacheTtlMinutes (phút) và tools.web.search.timeoutSeconds (mặc định 30 giây) để thay đổi thời gian lưu vào bộ nhớ đệm và thời gian chờ yêu cầu cho tất cả nhà cung cấp web_search, bao gồm Exa.

​

Liên quan

• Tổng quan về tìm kiếm trên web — tất cả nhà cung cấp và khả năng tự động phát hiện
• Brave Search — kết quả có cấu trúc với bộ lọc quốc gia/ngôn ngữ
• Perplexity Search — kết quả có cấu trúc với bộ lọc miền