English简体中文繁體中文日本語EspañolPortuguês (BR)한국어DeutschFrançaisالعربيةItalianoTiếng ViệtNederlandsTürkçeУкраїнськаBahasa IndonesiaPolskiفارسیไทย

快速开始

Brave 搜索

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

获取 API key

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

配置示例

{
  plugins: {
    entries: {
      brave: {
        config: {
          webSearch: {
            apiKey: "BRAVE_API_KEY_HERE",
            mode: "web", // or "llm-context"
            baseUrl: "https://api.search.brave.com", // optional proxy/base URL override
          },
        },
      },
    },
  },
  tools: {
    web: {
      search: {
        provider: "brave",
        maxResults: 5,
        timeoutSeconds: 30,
      },
    },
  },
}

Brave 专属搜索设置现在位于 plugins.entries.brave.config.webSearch.* 下。 旧版 tools.web.search.apiKey 仍会通过兼容性 shim 加载，但它不再是规范配置路径。

webSearch.mode 控制 Brave 传输方式：

  • web（默认）：普通 Brave 网页搜索，包含标题、URL 和摘要片段
  • llm-context：Brave LLM Context API，提供预提取的文本块和用于依据支撑的来源

webSearch.baseUrl 可以将 Brave 请求指向可信的 Brave 兼容代理 或网关。OpenClaw 会将 /res/v1/web/search 或 /res/v1/llm/context 追加到 配置的基础 URL，并将基础 URL 保留在缓存键中。公共 端点必须使用 https://；http:// 仅接受用于可信的回环 或专用网络代理主机。

工具参数

querystringrequired

搜索查询。

countnumber

要返回的结果数量（1–10）。

countrystring

2 字母 ISO 国家/地区代码（例如 US、DE）。

languagestring

搜索结果的 ISO 639-1 语言代码（例如 en、de、fr）。

search_langstring

Brave 搜索语言代码（例如 en、en-gb、zh-hans）。

ui_langstring

UI 元素的 ISO 语言代码。

freshness'day' | 'week' | 'month' | 'year'

时间过滤器 — day 表示 24 小时。

date_afterstring

仅返回在此日期之后发布的结果（YYYY-MM-DD）。

date_beforestring

仅返回在此日期之前发布的结果（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 计划。如果你有旧版订阅（例如原始 Free 计划，每月 2,000 次查询），它仍然有效，但不包含 LLM Context 或更高速率限制等较新功能。
  • 每个 Brave 计划都包含每月 $5 免费额度（续期）。Search 计划每 1,000 次请求费用为 $5，因此该额度覆盖每月 1,000 次查询。请在 Brave 仪表板中设置你的使用限制，以避免产生意外费用。当前计划请参阅 Brave API 门户。
  • Search 计划包含 LLM Context 端点和 AI 推理权利。存储结果以训练或调优模型需要具有明确存储权利的计划。请参阅 Brave 服务条款。
  • llm-context 模式返回有依据支撑的来源条目，而不是普通网页搜索摘要片段格式。
  • llm-context 模式支持 freshness 以及有边界的 date_after + date_before 范围。它不支持 ui_lang；没有 date_after 的 date_before 会被拒绝，因为 Brave 要求自定义新鲜度范围同时包含开始日期和结束日期。
  • ui_lang 必须包含区域子标签，例如 en-US。
  • 结果默认缓存 15 分钟（可通过 cacheTtlMinutes 配置）。
  • 自定义 webSearch.baseUrl 值会包含在 Brave 缓存标识中，因此 代理专属响应不会发生冲突。
  • 启用 brave.http 诊断标志，可在故障排除时记录 Brave 请求 URL/查询参数、响应状态/耗时，以及搜索缓存命中/未命中/写入事件。该标志绝不会记录 API key 或响应正文，但搜索查询可能是敏感信息。

相关