> ## Documentation Index
> Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Tìm kiếm Exa

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, kèm khả năng trích
xuất nội dung tích hợp sẵn (đoạn nổi bật, văn bản, bản tóm tắt).

## Cài đặt Plugin

Cài đặt Plugin chính thức, rồi khởi động lại Gateway:

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw plugins install @openclaw/exa-plugin
openclaw gateway restart
```

## Lấy khóa API

<Steps>
  <Step title="Tạo tài khoản">
    Đă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.
  </Step>

  <Step title="Lưu khóa">
    Đặt `EXA_API_KEY` trong môi trường Gateway, hoặc cấu hình qua:

    ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
    openclaw configure --section web
    ```
  </Step>
</Steps>

## Cấu hình

```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
{
  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 môi trường thay thế:** đặt `EXA_API_KEY` trong môi trường Gateway.
Với bản cài đặt gateway, hãy đặt khóa 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 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 bằng phần đó. Đ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
dùng chung.

## Tham số công cụ

<ParamField path="query" type="string" required>
  Truy vấn tìm kiếm.
</ParamField>

<ParamField path="count" type="number">
  Số kết quả cần trả về (1–100).
</ParamField>

<ParamField path="type" type="'auto' | 'neural' | 'fast' | 'deep' | 'deep-reasoning' | 'instant'">
  Chế độ tìm kiếm.
</ParamField>

<ParamField path="freshness" type="'day' | 'week' | 'month' | 'year'">
  Bộ lọc thời gian.
</ParamField>

<ParamField path="date_after" type="string">
  Kết quả sau ngày này (`YYYY-MM-DD`).
</ParamField>

<ParamField path="date_before" type="string">
  Kết quả trước ngày này (`YYYY-MM-DD`).
</ParamField>

<ParamField path="contents" type="object">
  Tùy chọn trích xuất nội dung (xem bên dưới).
</ParamField>

### 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 theme={"theme":{"light":"min-light","dark":"min-dark"}}
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 nội dung | Kiểu                                                                  | 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 }`                                                | Bản 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 theo ngữ nghĩa/ý 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ó suy 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 xác định từ đoạn nổi bật trước, rồi đến bả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ới `date_after`/`date_before` — hãy dùng một
  chế độ lọc thời gian
* Có thể trả về tối đa 100 kết quả cho mỗi truy vấn (tùy thuộc vào giới hạn
  loại tìm kiếm của Exa)
* Kết quả được lưu trong 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ính năng 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 bộ lọc miền