OpenClawDocs
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this page

快速开始

Brave 搜索

OpenClaw 支持将 Brave Search API 用作 web_search 提供商。

获取 API key

  1. 在 https://brave.com/search/api/ 创建 Brave Search API 账户
  2. 在控制面板中选择 Search 套餐并生成 API key。
  3. 将密钥存入配置，或在 Gateway 网关环境中设置 BRAVE_API_KEY。

配置示例

json5
{  plugins: {    entries: {      brave: {        config: {          webSearch: {            apiKey: "BRAVE_API_KEY_HERE",            mode: "web", // 或 "llm-context"            baseUrl: "https://api.search.brave.com", // 可选的代理/基础 URL 覆盖值          },        },      },    },  },  tools: {    web: {      search: {        provider: "brave",        maxResults: 5,        timeoutSeconds: 30,      },    },  },}

Brave 提供商专用的搜索设置位于 plugins.entries.brave.config.webSearch.* 下；这是规范配置路径。共享的顶层 tools.web.search.apiKey 和限定范围的 tools.web.search.brave.* 仍可通过兼容性合并加载，但新配置应使用上面的插件作用域路径。

webSearch.mode 控制 Brave 的传输方式：

  • web（默认）：普通 Brave Web 搜索，返回标题、URL 和摘要
  • llm-context：Brave LLM Context API，返回预先提取的文本块和来源，用于提供事实依据

webSearch.baseUrl 可将 Brave 请求指向可信且兼容 Brave 的代理或网关。OpenClaw 会在配置的基础 URL 后附加 /res/v1/web/search 或 /res/v1/llm/context，并将该基础 URL 纳入缓存键。公共端点必须使用 https://；仅可信的环回地址或私有网络代理主机可使用 http://。

工具参数

querystringrequired

搜索查询。

countnumberdefault: 5

返回的结果数量（1–10）。

countrystring

两位 ISO 国家/地区代码（例如 US、DE）。

languagestring

搜索结果使用的 ISO 639-1 语言代码（例如 en、de、fr）。

search_langstring

Brave 搜索语言代码（例如 en、en-gb、zh-hans）。

ui_langstring

UI 元素使用的 ISO 语言代码。

freshness'day' | 'week' | 'month' | 'year'

时间筛选条件——day 表示 24 小时。

date_afterstring

仅返回在此日期之后发布的结果（YYYY-MM-DD）。

date_beforestring

仅返回在此日期之前发布的结果（YYYY-MM-DD）。

示例：

javascript
// 按国家/地区和语言搜索await web_search({  query: "renewable energy",  country: "DE",  language: "de",}); // 最近的结果（过去一周）await web_search({  query: "AI news",  freshness: "week",}); // 按日期范围搜索await web_search({  query: "AI developments",  date_after: "2024-01-01",  date_before: "2024-06-30",});

注意事项

  • OpenClaw 使用 Brave Search 套餐。如果你使用旧版订阅（例如最初每月包含 2,000 次查询的 Free 套餐），该订阅仍然有效，但不包含 LLM Context 或更高速率限制等较新功能。
  • 每种 Brave 套餐都包含每月 $5 免费额度（按月续期）。Search 套餐每 1,000 次请求收费 $5，因此该额度可涵盖每月 1,000 次查询。请在 Brave 控制面板中设置用量限制，以免产生意外费用。有关当前套餐，请参阅 Brave API 门户。
  • Search 套餐包含 LLM Context 端点和 AI 推理权利。存储结果以训练或调优模型需要明确包含存储权利的套餐。请参阅 Brave 服务条款。
  • llm-context 模式返回带事实依据的来源条目，而不是普通 Web 搜索的摘要结构。
  • llm-context 模式支持 freshness 以及有界的 date_after + date_before 范围。它不支持 ui_lang；仅提供 date_before 而不提供 date_after 时，请求会被拒绝，因为 Brave 要求自定义时间范围同时包含开始日期和结束日期。
  • ui_lang 必须包含地区子标签，例如 en-US。
  • 默认情况下，结果会缓存 15 分钟（可通过 cacheTtlMinutes 配置）。
  • 自定义 webSearch.baseUrl 值会包含在 Brave 缓存标识中，因此特定于代理的响应不会发生冲突。
  • 在故障排查期间，启用 brave.http 诊断标志可记录 Brave 请求 URL/查询参数、响应状态/耗时，以及搜索缓存的命中/未命中/写入事件。该标志绝不会记录 API key 或响应正文，但搜索查询可能包含敏感信息。

相关内容

Was this useful?
On this page

On this page