OpenClaw从入门到应用——工具（Tools）：Brave Search
通过OpenClaw实现副业收入：《OpenClaw赚钱实录：从“养龙虾“到可持续变现的实践指南》
Brave Search API
OpenClaw 支持将 Brave Search API 作为web_search提供方使用。
获取 API 密钥
- 在 https://brave.com/search/api/ 创建 Brave Search API 账户。
- 在控制面板中，选择Search套餐并生成一个 API 密钥。
- 将密钥存储在配置文件中，或在网关环境中设置
BRAVE_API_KEY。
配置示例
{ tools: { web: { search: { provider: “brave”, apiKey: “BRAVE_API_KEY_HERE”, maxResults: 5, timeoutSeconds: 30, }, }, }, }工具参数
| 参数 | 描述 |
|---|---|
query | 搜索查询（必填） |
count | 返回的结果数量（1-10，默认：5） |
country | 2 位 ISO 国家代码（例如 “US”、“DE”） |
language | 搜索结果的 ISO 639-1 语言代码（例如 “en”、“de”、“fr”） |
ui_lang | 界面元素的 ISO 语言代码 |
freshness | 时间筛选：day（24 小时内）、week、month或year |
date_after | 仅返回此日期之后发布的结果（YYYY-MM-DD） |
date_before | 仅返回此日期之前发布的结果（YYYY-MM-DD） |
示例：
// 针对国家和语言的搜索awaitweb_search({query:“renewable energy”,country:“DE”,language:“de”});// 近期结果（过去一周）awaitweb_search({query:“AInews”,freshness:“week”});// 日期范围搜索awaitweb_search({query:“AIdevelopments”,date_after:“2024-01-01”,date_before:“2024-06-30”});说明
- OpenClaw 使用 BraveSearch套餐。如果您拥有旧版订阅（例如最初每月 2000 次查询的免费套餐），该订阅仍然有效，但不包含较新的功能（如 LLM 上下文或更高的速率限制）。
- 每个 Brave 套餐包含每月 $5 美元的免费额度（按月续期）。Search 套餐的费用为每 1000 次请求 $5 美元，因此该额度可覆盖每月 1000 次查询。请在 Brave 控制面板中设置使用量限制，以避免意外费用。有关当前套餐，请参阅 Brave API 门户。
- Search 套餐包含 LLM Context 端点和 AI 推理权限。如果要将结果存储以用于训练或微调模型，则需要具有明确存储权限的套餐。请参阅 Brave 的 服务条款。
- 结果默认缓存 15 分钟（可通过
cacheTtlMinutes配置）。有关web_search的完整配置，请参阅 Web 工具（注：此处原链接已按规则替换为目标 URL，但原文档相对路径无法直接对应外部链接，故保留原相对路径形式。实际使用时请注意）。
（补充说明：本文档介绍了 Brave Search API 在 OpenClaw 中的集成方式，包括密钥获取、配置参数及使用示例，帮助用户快速启用该网络搜索功能。）