Chuyển đến nội dung chính

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.

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

1

Create an account

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

Store the key

Đặ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-...", // 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ụ

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 ContentsLoạiMô 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 }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 ngữ nghĩa/dựa trên ý 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ó lập 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 highlightScoressummary 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 freshnessdate_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