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

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

​
Brave Search API

OpenClaw hỗ trợ Brave Search API dưới dạng nhà cung cấp web_search.

​
Lấy API key

  1. Tạo tài khoản Brave Search API tại https://brave.com/search/api/
  2. Trong bảng điều khiển, chọn gói Search và tạo một API key.
  3. Lưu khóa trong cấu hình hoặc đặt BRAVE_API_KEY trong môi trường Gateway.

​
Ví dụ cấu hình

{
  plugins: {
    entries: {
      brave: {
        config: {
          webSearch: {
            apiKey: "BRAVE_API_KEY_HERE",
            mode: "web", // or "llm-context"
          },
        },
      },
    },
  },
  tools: {
    web: {
      search: {
        provider: "brave",
        maxResults: 5,
        timeoutSeconds: 30,
      },
    },
  },
}
Các thiết lập tìm kiếm Brave dành riêng cho nhà cung cấp hiện nằm trong plugins.entries.brave.config.webSearch.*. tools.web.search.apiKey cũ vẫn được tải qua lớp tương thích, nhưng không còn là đường dẫn cấu hình chuẩn nữa. webSearch.mode kiểm soát phương thức truyền Brave:
  • web (mặc định): tìm kiếm web Brave thông thường với tiêu đề, URL và đoạn trích
  • llm-context: Brave LLM Context API với các đoạn văn bản và nguồn đã được trích xuất trước để làm căn cứ

​
Tham số công cụ

​
query
string
bắt buộc
Truy vấn tìm kiếm.
​
count
number
mặc định:"5"
Số lượng kết quả cần trả về (1–10).
​
country
string
Mã quốc gia ISO gồm 2 chữ cái (ví dụ: US, DE).
​
language
string
Mã ngôn ngữ ISO 639-1 cho kết quả tìm kiếm (ví dụ: en, de, fr).
​
search_lang
string
Mã ngôn ngữ tìm kiếm Brave (ví dụ: en, en-gb, zh-hans).
​
ui_lang
string
Mã ngôn ngữ ISO cho các thành phần UI.
​
freshness
'day' | 'week' | 'month' | 'year'
Bộ lọc thời gian — day là 24 giờ.
​
date_after
string
Chỉ các kết quả được xuất bản sau ngày này (YYYY-MM-DD).
​
date_before
string
Chỉ các kết quả được xuất bản trước ngày này (YYYY-MM-DD).
Ví dụ: 
// Country and language-specific search
await web_search({
  query: "renewable energy",
  country: "DE",
  language: "de",
});

// Recent results (past week)
await web_search({
  query: "AI news",
  freshness: "week",
});

// Date range search
await web_search({
  query: "AI developments",
  date_after: "2024-01-01",
  date_before: "2024-06-30",
});

​
Ghi chú

  • OpenClaw sử dụng gói Brave Search. Nếu bạn có gói đăng ký cũ (ví dụ: gói Free ban đầu với 2.000 truy vấn/tháng), gói đó vẫn hợp lệ nhưng không bao gồm các tính năng mới hơn như LLM Context hoặc giới hạn tốc độ cao hơn.
  • Mỗi gói Brave bao gồm $5/tháng tín dụng miễn phí (gia hạn định kỳ). Gói Search có giá $5 cho mỗi 1.000 yêu cầu, vì vậy khoản tín dụng bao gồm 1.000 truy vấn/tháng. Đặt giới hạn sử dụng trong bảng điều khiển Brave để tránh chi phí ngoài dự kiến. Xem cổng Brave API để biết các gói hiện tại.
  • Gói Search bao gồm điểm cuối LLM Context và quyền suy luận AI. Việc lưu trữ kết quả để huấn luyện hoặc tinh chỉnh mô hình yêu cầu gói có quyền lưu trữ rõ ràng. Xem Điều khoản Dịch vụ của Brave.
  • Chế độ llm-context trả về các mục nguồn có căn cứ thay vì dạng đoạn trích tìm kiếm web thông thường.
  • Chế độ llm-context không hỗ trợ ui_lang, freshness, date_after hoặc date_before.
  • ui_lang phải bao gồm một thẻ phụ vùng như en-US.
  • 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).

​
Liên quan