Brave Search

Brave Search API

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

获取 API 密钥

在 https://brave.com/search/api/ 创建一个 Brave Search API 账户
在仪表板中，选择 Search 计划并生成一个 API 密钥。
将密钥存储在配置中，或在 Gateway(网关) 环境中设置 BRAVE_API_KEY。

配置示例

{
  plugins: {
    entries: {
      brave: {
        config: {
          webSearch: {
            apiKey: "BRAVE_API_KEY_HERE",
          },
        },
      },
    },
  },
  tools: {
    web: {
      search: {
        provider: "brave",
        maxResults: 5,
        timeoutSeconds: 30,
      },
    },
  },
}

提供商特定的 Brave 搜索设置现在位于 plugins.entries.brave.config.webSearch.* 下。传统的 tools.web.search.apiKey 仍然通过兼容性垫片加载，但它不再是标准的配置路径。

工具参数

参数	描述
`query`	搜索查询（必需）
`count`	要返回的结果数量（1-10，默认：5）
`country`	2字母 ISO 国家代码（例如 “US”、“DE”）
`language`	搜索结果的 ISO 639-1 语言代码（例如 “en”、“de”、“fr”）
`ui_lang`	UI 元素的 ISO 语言代码
`freshness`	时间过滤器：`day` (24h)、`week`、`month` 或 `year`
`date_after`	仅限此日期之后发布的结果（YYYY-MM-DD）
`date_before`	仅限此日期之前发布的结果（YYYY-MM-DD）

示例：

// Country and language-specific search
await web_search({
  query: "renewable energy",
  country: "DE",
  language: "de",
});

// Recent results (past week)
await web_search({
  query: "AI news",
  freshness: "week",
});

// Date range search
await web_search({
  query: "AI developments",
  date_after: "2024-01-01",
  date_before: "2024-06-30",
});

注意事项

OpenClaw 使用 Brave 的 Search 计划。如果您拥有旧的订阅（例如每月 2,000 次查询的原始 Free 计划），它仍然有效，但不包括 LLM 上下文或更高速率限制等新功能。
每个 Brave 计划都包含 每月 5 美元的免费额度（可续订）。搜索计划的价格为每 1,000 次请求 5 美元，因此该额度可涵盖每月 1,000 次查询。请在 Brave 仪表板中设置您的使用限额，以避免意外产生费用。有关当前计划的详情，请参阅 Brave API portal。
搜索计划包括 LLM Context 端点和 AI 推理权限。若要存储结果以训练或微调模型，则需要具有明确存储权限的计划。请参阅 Brave 的 Terms of Service。
Results are cached for 15 minutes by default (configurable via cacheTtlMinutes).

Brave Search

Brave Search API

获取 API 密钥

配置示例

工具参数

注意事项

相关