Tìm kiếm Brave

OpenClaw hỗ trợ API Brave Search làm nhà cung cấp web_search.

Lấy khóa API

1. Tạo tài khoản API Brave Search tại https://brave.com/search/api/
2. Trong bảng điều khiển, chọn gói Search và tạo khóa API.
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", // hoặc "llm-context"            baseUrl: "https://api.search.brave.com", // tùy chọn ghi đè URL proxy/URL cơ sở          },        },      },    },  },  tools: {    web: {      search: {        provider: "brave",        maxResults: 5,        timeoutSeconds: 30,      },    },  },}

Các cài đặt tìm kiếm dành riêng cho nhà cung cấp Brave nằm trong plugins.entries.brave.config.webSearch.*; đây là đường dẫn cấu hình chuẩn.

webSearch.mode điều khiển phương thức truyền tải của 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: API Brave LLM Context với các đoạn văn bản và nguồn được trích xuất sẵn để làm căn cứ

webSearch.baseUrl có thể chuyển các yêu cầu Brave đến một proxy tương thích với Brave đáng tin cậy hoặc gateway. OpenClaw nối thêm /res/v1/web/search hoặc /res/v1/llm/context vào URL cơ sở đã cấu hình và đưa URL cơ sở vào khóa bộ nhớ đệm. Các điểm cuối công khai phải sử dụng https://; http:// chỉ được chấp nhận cho các máy chủ proxy loopback đáng tin cậy hoặc thuộc mạng riêng.

Tham số công cụ

Ví dụ:

// 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 ngàyawait web_search({  query: "các phát triển về AI",  date_after: "2024-01-01",  date_before: "2024-06-30",});

Ghi chú

• OpenClaw sử dụng gói Search của Brave. 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 tín dụng miễn phí mỗi tháng (được gia hạn). Gói Search có giá $5 cho mỗi 1.000 yêu cầu, nên khoản tín dụng này chi trả cho 1.000 truy vấn/tháng. Hãy đặt giới hạn sử dụng trong bảng điều khiển Brave để tránh các khoản phí ngoài dự kiến. Xem cổng thông tin API Brave để 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 một 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ì cấu trúc đoạn trích tìm kiếm web thông thường.
• Chế độ llm-context hỗ trợ freshness và các khoảng date_after + date_before có giới hạn. Chế độ này không hỗ trợ ui_lang; date_before không có date_after sẽ bị từ chối vì Brave yêu cầu các khoảng thời gian tùy chỉnh phải bao gồm cả ngày bắt đầu và ngày kết thúc.
• ui_lang phải bao gồm một thẻ phụ khu vực như en-US.
• Theo mặc định, kết quả được lưu vào bộ nhớ đệm trong 15 phút (có thể cấu hình qua cacheTtlMinutes).
• Các giá trị webSearch.baseUrl tùy chỉnh được đưa vào định danh bộ nhớ đệm Brave, nên các phản hồi dành riêng cho proxy không xung đột với nhau.
• Bật cờ chẩn đoán brave.http để ghi nhật ký URL/tham số truy vấn của yêu cầu Brave, trạng thái/thời gian phản hồi và các sự kiện trúng/trượt/ghi bộ nhớ đệm tìm kiếm khi khắc phục sự cố. Cờ này không bao giờ ghi nhật ký khóa API hoặc nội dung phản hồi, nhưng truy vấn tìm kiếm có thể chứa thông tin nhạy cảm.

Liên quan

• Tổng quan về Tìm kiếm web -- tất cả nhà cung cấp và tính năng tự động phát hiện
• Tìm kiếm Perplexity -- kết quả có cấu trúc với tính năng lọc miền
• Tìm kiếm Exa -- tìm kiếm nơ-ron với tính năng trích xuất nội dung