Brave 搜索

​

获取 API 密钥

1. 在 https://brave.com/search/api/ 创建 Brave Search API 账户
2. 在控制面板中，选择 Search 套餐并生成 API 密钥。
3. 将密钥存储在配置中，或在 Gateway 网关环境中设置 BRAVE_API_KEY。

​

配置示例

{
  plugins: {
    entries: {
      brave: {
        config: {
          webSearch: {
            apiKey: "BRAVE_API_KEY_HERE",
            mode: "web", // 或 "llm-context"
            baseUrl: "https://api.search.brave.com", // 可选的代理/基础 URL 覆盖值
          },
        },
      },
    },
  },
  tools: {
    web: {
      search: {
        provider: "brave",
        maxResults: 5,
        timeoutSeconds: 30,
      },
    },
  },
}

• web（默认）：常规 Brave Web 搜索，包含标题、URL 和摘要
• llm-context：Brave LLM Context API，提供预先提取的文本块和来源以进行依据支撑

​

工具参数

// 针对特定国家/地区和语言进行搜索
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 套餐。如果你拥有旧版订阅（例如最初的 Free 套餐，每月包含 2,000 次查询），该订阅仍然有效，但不包含 LLM Context 或更高速率限制等较新的功能。
• 每个 Brave 套餐都包含每月 $5 的免费额度（每月续期）。Search 套餐每 1,000 次请求收费 $5，因此该额度可覆盖每月 1,000 次查询。请在 Brave 控制面板中设置用量上限，以避免意外收费。有关当前套餐，请参阅 Brave API 门户。
• Search 套餐包含 LLM Context 端点和 AI 推理权利。存储结果以训练或调优模型需要具有明确存储权利的套餐。请参阅 Brave 服务条款。
• llm-context 模式返回有来源依据的条目，而不是常规 Web 搜索摘要格式。
• llm-context 模式支持 freshness 以及有界的 date_after + date_before 范围。它不支持 ui_lang；如果设置 date_before 而未设置 date_after，请求将被拒绝，因为 Brave 要求自定义新鲜度范围必须同时包含开始日期和结束日期。
• ui_lang 必须包含类似 en-US 的区域子标签。
• 默认情况下，结果会缓存 15 分钟（可通过 cacheTtlMinutes 配置）。
• 自定义 webSearch.baseUrl 值会纳入 Brave 缓存标识，因此 特定于代理的响应不会发生冲突。
• 启用 brave.http 诊断标志，可在故障排查期间记录 Brave 请求 URL/查询参数、响应状态/耗时，以及搜索缓存命中/未命中/写入事件。该标志绝不会记录 API 密钥或响应正文，但搜索查询可能包含敏感信息。

​

相关内容

• Web 搜索概览 — 所有提供商和自动检测
• Perplexity Search — 支持域名筛选的结构化结果
• Exa Search — 支持内容提取的神经网络搜索