Tools

Tìm kiếm Exa

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

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

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

    querystringrequired

    Truy vấn tìm kiếm.

    countnumber

    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_afterstring

    Kết quả sau ngày này (YYYY-MM-DD).

    date_beforestring

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

    contentsobject

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