Skip to main content

​
Brave 搜索 API

OpenClaw 支持 Brave 搜索作为 web_search 的网络搜索提供者。

​
获取 API 密钥

  1. 在 https://brave.com/search/api/ 创建一个 Brave 搜索 API 账号
  2. 在控制面板中，选择 Data for Search 计划并生成 API 密钥。
  3. 将密钥存储在配置文件中（推荐）或设置到 Gateway 环境变量 BRAVE_API_KEY。

​
配置示例

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

​
工具参数

参数说明
query搜索查询（必填）
count返回结果数量（1-10，默认：5）
country2 位 ISO 国家代码（例如 “US”、“DE”）
language搜索结果的 ISO 639-1 语言代码（例如 “en”、“de”、“fr”）
ui_langUI 元素的 ISO 语言代码
freshness时间过滤：day（24小时）、week、month 或 year
date_after仅返回该日期之后发布的结果（YYYY-MM-DD）
date_before仅返回该日期之前发布的结果（YYYY-MM-DD）
示例： 
// 指定国家和语言的搜索
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",
});

​
注意事项

  • Data for AI 计划 不兼容 web_search。
  • Brave 提供付费计划；请查看 Brave API 门户了解当前限制。
  • Brave 条款中包含对部分 AI 相关搜索结果使用的限制。请查阅 Brave 服务条款并确认你的使用符合规定。法律相关问题请咨询法律顾问。
  • 结果默认缓存 15 分钟（可通过 cacheTtlMinutes 配置）。
完整的 web_search 配置请参见 Web tools。