Chuyển đến nội dung chính
OpenClaw hỗ trợ 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: 
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 qua:
openclaw configure --section web

​
Cấu hình

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

​
query
string
bắt buộc
Truy vấn tìm kiếm.
​
count
number
Số kết quả cần trả về (1–100).
​
type
'auto' | 'neural' | 'fast' | 'deep' | 'deep-reasoning' | 'instant'
Chế độ tìm kiếm.
​
freshness
'day' | 'week' | 'month' | 'year'
Bộ lọc thời gian.
​
date_after
string
Kết quả sau ngày này (YYYY-MM-DD).
​
date_before
string
Kết quả trước ngày này (YYYY-MM-DD).
​
contents
object
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: 
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 dungKiểuMô tả
textboolean | { maxCharacters }Trích xuất toàn bộ văn bản trang
highlightsboolean | { maxCharacters, query, numSentences, highlightsPerUrl }Trích xuất các câu chính
summaryboolean | { query }Bản tóm tắt do AI tạo

​
Chế độ tìm kiếm

Chế độMô tả
autoExa chọn chế độ tốt nhất (mặc định)
neuralTìm kiếm theo ngữ nghĩa/ý nghĩa
fastTìm kiếm từ khóa nhanh
deepTìm kiếm sâu kỹ lưỡng
deep-reasoningTìm kiếm sâu có suy luận
instantKế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 — tất cả nhà cung cấp và tính 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