Brave Search API

OpenClaw 支持将 Brave Search API 作为 web_search 工具的搜索提供商。

申请 API Key

1. 在 https://brave.com/search/api/ 注册 Brave Search API 账号
2. 在控制台选择 Search 套餐并生成 API Key
3. 将 Key 写入配置，或在 Gateway 环境中设置 BRAVE_API_KEY 环境变量

配置示例

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

Brave Search 专属配置现在位于 plugins.entries.brave.config.webSearch.*。旧版 tools.web.search.apiKey 通过兼容层仍可读取，但已不再是推荐的配置路径。

工具参数

参数	说明
query	搜索关键词（必填）
count	返回结果数量（1-10，默认 5）
country	两位 ISO 国家代码（如 "US"、"CN"）
language	搜索结果的 ISO 639-1 语言代码（如 "en"、"zh"）
ui_lang	界面元素的语言代码
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 套餐。如果你持有旧版订阅（例如每月 2000 次的免费旧套餐），该订阅依然有效，但不含 LLM Context 等新特性或更高速率限制。
• 每个 Brave 套餐包含每月 $5 免费额度（自动续期）。Search 套餐费率为每 1000 次请求 $5，因此免费额度覆盖约 1000 次查询/月。建议在 Brave 控制台设置用量上限，避免意外扣费。详见 Brave API 门户 了解当前套餐。
• Search 套餐含 LLM Context 端点和 AI 推理权限。若需存储结果用于训练或微调模型，需要具有明确存储权限的套餐。详见 Brave 服务条款。
• 结果默认缓存 15 分钟（可通过 cacheTtlMinutes 配置调整）。

相关文档

• Web Search 概述 — 所有提供商及自动检测
• Perplexity Search — 结构化结果含域名过滤
• Exa Search — 神经搜索含内容提取