OpenClaw从入门到应用——工具（Tools）：Brave Search

作者：von  Neumann
通过OpenClaw实现副业收入：《OpenClaw赚钱实录：从“养龙虾“到可持续变现的实践指南》
Brave Search

Brave Search API

OpenClaw 支持将 Brave Search API 作为 web_search（网络搜索）工具的提供者。Brave Search 是一个注重隐私的搜索引擎，其 API 为开发者提供了高质量、实时的网页搜索能力，非常适合集成到 AI 代理或应用程序中。
获取 API 密钥

在 https://blog.csdn.net/hy592070616/article/details/81707766 创建一个 Brave Search API 账户。在控制台（Dashboard）中，选择 Search（搜索）计划并生成一个 API 密钥。将该密钥存储在配置文件中，或在 Gateway（网关）环境中设置 BRAVE_API_KEY 环境变量。

补充说明：建议在生产环境中优先使用环境变量来管理敏感凭证，避免将 API 密钥硬编码在代码或配置文件中提交至版本控制系统，以确保安全性。

配置示例

1. {
2.   tools: {
3.     web: {
4.       search: {
5.         provider: "brave",
6.         apiKey: "BRAVE_API_KEY_HERE", // 在此处填入你的 Brave API 密钥
7.         maxResults: 5, // 默认最大返回结果数
8.         timeoutSeconds: 30, // 请求超时时间（秒）
9.       },
10.     },
11.   },
12. }

复制代码

工具参数

参数	描述
query	搜索查询语句（必填）
count	返回的结果数量（范围 1-10，默认值：5）
country	2 字母 ISO 国家代码（例如：“US”、“DE”、“CN”）
language	搜索结果的 ISO 639-1 语言代码（例如：“en”、“de”、“fr”、“zh”）
ui_lang	UI 元素的 ISO 语言代码
freshness	时间过滤器：day（24小时内）、week（一周内）、month（一月内）或 year（一年内）
date_after	仅返回此日期之后发布的结果（格式：YYYY-MM-DD）
date_before	仅返回此日期之前发布的结果（格式：YYYY-MM-DD）

示例：

1. // 针对特定国家和语言的搜索awaitweb_search({query:"renewable energy",country:"DE",language:"de",});// 获取最近的结果（过去一周）awaitweb_search({query:"AI news",freshness:"week",});// 指定日期范围搜索awaitweb_search({query:"AI developments",date_after:"2024-01-01",date_before:"2024-06-30",});

复制代码

注意事项

OpenClaw 使用的是 Brave Search（搜索）计划。如果您拥有旧版订阅（例如每月 2,000 次查询的原始免费计划），该订阅仍然有效，但不包含较新的功能（如 LLM Context 端点或更高的速率限制）。每个 Brave 计划都包含 每月 5 美元的免费额度（自动续期）。Search 计划的费用为每 1,000 次请求 5 美元，因此该免费额度可覆盖每月 1,000 次查询。建议在 Brave 控制台中设置用量上限，以避免产生意外费用。有关当前计划的详细信息，请参阅 Brave API 门户。Search 计划包含 LLM Context 端点和 AI 推理权限。若需存储搜索结果用于训练或微调模型，则需要购买包含明确存储权限的计划。详情请参阅 Brave 服务条款。搜索结果默认缓存 15 分钟（可通过 cacheTtlMinutes 参数进行配置）。有关完整的 web_search 配置选项，请参阅 Web 工具 文档。

补充提示：合理配置缓存时间（cacheTtlMinutes）不仅能有效减少 API 调用次数以节省成本，还能显著降低重复查询时的响应延迟，提升应用的整体性能体验。

原文地址：https://blog.csdn.net/hy592070616/article/details/161750821