---
read_when:
- Bạn muốn sử dụng Exa cho web_search
- Bạn cần có EXA_API_KEY
- Bạn muốn tìm kiếm bằng mạng nơ-ron hoặc trích xuất nội dung
summary: Tìm kiếm Exa AI -- tìm kiếm nơ-ron và từ khóa kèm trích xuất nội dung
title: Tìm kiếm Exa
x-i18n:
generated_at: "2026-05-02T10:54:32Z"
model: gpt-5.5
provider: openai
source_hash: d2ddf83c5130208eadc78eccb10aebf67af11b05690d75a817d6999f79be5fc3
source_path: tools/exa-search.md
workflow: 16
---
OpenClaw hỗ trợ [Exa AI](https://exa.ai/) làm nhà cung cấp `web_search`. Exa
cung cấp các chế độ tìm kiếm neural, từ khóa và kết hợp với 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, tóm tắt).
## Lấy khóa API
Đăng ký tại [exa.ai](https://exa.ai/) và tạo khóa API từ bảng điều khiển
của bạn.
Đặ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-...", // optional if EXA_API_KEY is set
baseUrl: "https://api.exa.ai", // optional; OpenClaw appends /search
},
},
},
},
},
tools: {
web: {
search: {
provider: "exa",
},
},
},
}
```
**Phương án thay thế bằng 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 trong `~/.openclaw/.env`.
## Ghi đè URL cơ sở
Đặt `plugins.entries.exa.config.webSearch.baseUrl` khi các yêu cầu tìm kiếm Exa
cần đi qua một proxy tương thích hoặc điểm cuối Exa thay thế. OpenClaw
chuẩn hóa các máy chủ trần bằng cách thêm `https://` vào trước và thêm `/search` trừ khi
đường dẫn đã kết thúc ở đó. Điểm cuối đã phân giải được đưa vào khóa bộ nhớ đệm
tìm kiếm, nên kết quả từ các điểm cuối Exa khác nhau sẽ không được chia sẻ.
## Tham số công cụ
Truy vấn tìm kiếm.
Số kết quả cần trả về (1–100).
Chế độ tìm kiếm.
Bộ lọc thời gian.
Kết quả sau ngày này (`YYYY-MM-DD`).
Kết quả trước ngày này (`YYYY-MM-DD`).
Tùy chọn trích xuất nội dung (xem bên dưới).
### Trích xuất nội dung
Exa có thể trả về nội dung đã trích xuất cùng với kết quả tìm kiếm. Truyền một đối tượng `contents`
để bật:
```javascript
await web_search({
query: "transformer architecture explained",
type: "neural",
contents: {
text: true, // full page text
highlights: { numSentences: 3 }, // key sentences
summary: true, // AI summary
},
});
```
| Tùy chọn Contents | Loại | Mô tả |
| --------------- | --------------------------------------------------------------------- | ---------------------- |
| `text` | `boolean \| { maxCharacters }` | Trích xuất toàn bộ văn bản trang |
| `highlights` | `boolean \| { maxCharacters, query, numSentences, highlightsPerUrl }` | Trích xuất các câu chính |
| `summary` | `boolean \| { query }` | Tóm tắt do AI tạo |
### 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 ngữ nghĩa/dựa trên ý nghĩa |
| `fast` | Tìm kiếm từ khóa nhanh |
| `deep` | Tìm kiếm sâu kỹ lưỡng |
| `deep-reasoning` | Tìm kiếm sâu có lập luận |
| `instant` | Kết quả nhanh nhất |
## Ghi chú
- Nếu không cung cấp tùy chọn `contents`, Exa mặc định dùng `{ highlights: true }`
để kết quả bao gồm các đoạn trích câu chính
- Kết quả giữ nguyên các trường `highlightScores` và `summary` từ phản hồi API
của Exa khi có
- Mô tả kết quả được lấy từ phần nổi bật trước, rồi đến tóm tắt, rồi đến
toàn văn — tùy nội dung nào có sẵn
- Không thể kết hợp `freshness` và `date_after`/`date_before` — hãy dùng một
chế độ lọc thời gian
- Mỗi truy vấn có thể trả về tối đa 100 kết quả (tùy thuộc vào giới hạn
của loại tìm kiếm Exa)
- Kết quả được lưu vào bộ nhớ đệm trong 15 phút theo mặc định (có thể cấu hình qua
`cacheTtlMinutes`)
- Exa là một tích hợp API chính thức với phản hồi JSON có cấu trúc
## Liên quan
- [Tổng quan Web Search](/vi/tools/web) -- tất cả nhà cung cấp và tự động phát hiện
- [Brave Search](/vi/tools/brave-search) -- kết quả có cấu trúc với bộ lọc quốc gia/ngôn ngữ
- [Perplexity Search](/vi/tools/perplexity-search) -- kết quả có cấu trúc với lọc miền