Tools

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

bash

openclaw plugins install @openclaw/exa-pluginopenclaw gateway restart

Lấy khóa API

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.

Lưu khóa

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

bash

openclaw configure --section web

Cấu hình

json5

{  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ụ

querystringrequired

Truy vấn tìm kiếm.

countnumberdefault: 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).

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_afterstring

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

date_beforestring

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

contentsobject

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ả:

javascript

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

Was this useful?