Brave Search API

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

获取 API 密钥

在 https://brave.com/search/api/ 创建 Brave Search API 账号
在控制台中选择 Search 计划并生成 API 密钥
将密钥写入配置文件，或在 Gateway 环境中设置 BRAVE_API_KEY

配置示例

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

工具参数

参数	说明
`query`	搜索关键词（必填）
`count`	返回结果数量（1-10，默认 5）
`country`	两位 ISO 国家代码（如 “US”、“DE”）
`language`	ISO 639-1 语言代码，用于搜索结果语言（如 “en”、“de”、“fr”）
`ui_lang`	ISO 语言代码，用于 UI 元素
`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",
});

注意事项

OpenClaw 使用 Brave 的 Search 计划。如果你用的是老版订阅（比如原来每月 2,000 次查询的免费计划），依然有效，但不包含 LLM Context 等新功能或更高的速率限制。
每个 Brave 计划包含每月 $5 的免费额度（每月刷新）。Search 计划每 1,000 次请求收费 $5，所以这个额度刚好覆盖每月 1,000 次查询。建议在 Brave 控制台设置用量上限，避免意外扣费。详情见 Brave API portal。
Search 计划包含 LLM Context 端点和 AI 推理权限。如果要存储结果用于训练或微调模型，需要购买带有明确存储权限的计划。详见 Brave 服务条款。
结果默认缓存 15 分钟（可通过 cacheTtlMinutes 调整）。

完整的 web_search 配置详见 Web 工具。