​

Brave Search API

​

Lấy API key

1. Tạo tài khoản Brave Search API tại https://brave.com/search/api/
2. Trong dashboard, chọn gói Search và tạo API key.
3. Lưu key vào cấu hình hoặc thiết lập 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",
          },
        },
      },
    },
  },
  tools: {
    web: {
      search: {
        provider: "brave",
        maxResults: 5,
        timeoutSeconds: 30,
      },
    },
  },
}

​

Tham số công cụ

// Tìm kiếm theo quốc gia và ngôn ngữ
await web_search({
  query: "năng lượng tái tạo",
  country: "DE",
  language: "de",
});

// Kết quả gần đây (tuần qua)
await web_search({
  query: "tin tức AI",
  freshness: "week",
});

// Tìm kiếm theo khoảng thời gian
await web_search({
  query: "phát triển AI",
  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), nó vẫn hợp lệ nhưng không bao gồm các tính năng mới như LLM Context hoặc giới hạn tốc độ cao hơn.
• Mỗi gói Brave bao gồm 5 USD/tháng tín dụng miễn phí (tự động gia hạn). Gói Search có giá 5 USD cho mỗi 1,000 yêu cầu, vì vậy tín dụng bao phủ 1,000 truy vấn/tháng. Đặt giới hạn sử dụng trong dashboard Brave để tránh phí không mong muốn. Xem cổng API Brave để biết các gói hiện tại.
• Gói Search bao gồm endpoint LLM Context và quyền suy luận AI. 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.
• Kết quả được lưu trong bộ nhớ đệm mặc định 15 phút (có thể cấu hình qua cacheTtlMinutes).