Brave 搜索（旧路径）

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`	两个字母的 ISO 国家代码（例如，“US”、“DE”）
`language`	搜索结果的 ISO 639-1 语言代码（例如，“en”、“de”、“fr”）
`ui_lang`	UI 元素的 ISO 语言代码
`freshness`	时间过滤器：`day`（24 小时）、`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 美元的免费额度（自动续期）。Search 计划每 1,000 次请求收费 5 美元，因此该免费额度涵盖每月 1,000 次查询。请在 Brave 仪表板中设置您的使用限制，以避免意外收费。有关当前计划，请参阅 Brave API portal。
Search 计划包括 LLM 上下文端点和 AI 推理权限。存储结果以训练或调整模型需要具有明确存储权限的计划。请参阅 Brave 服务条款。
结果默认缓存 15 分钟（可通过 cacheTtlMinutes 配置）。

有关完整的 web_search 配置，请参阅 Web tools。