OpenClaw 支持使用 Brave Search API 作为 web_search 工具的后端。配置需先申请 Brave Search 套餐 API Key，然后在 plugins.entries.brave.config.webSearch 下设置，并调整 tools.web.search 中的 provider 为 "brave"。默认每 1000 次请求 $5，每月有 $5 免费额度，建议设置用量上限。结果默认缓存 15 分钟。

OpenClaw Brave Search 在线搜索配置 #

Brave Search 是 OpenClaw 中 web_search 工具的可选搜索提供商之一。启用后，智能体可通过 Brave 的索引直接获取实时网络信息。

申请 API Key #

1. 打开 Brave Search API 门户，注册账号并登录。
2. 在控制台选择 Search 套餐（不是 Web Search 或 AI 套餐），生成 API Key。
3. 将 Key 写入 OpenClaw 配置，或在 Gateway 环境变量中设置 BRAVE_API_KEY。

配置示例 #

{
  plugins: {
    entries: {
      brave: {
        config: {
          webSearch: {
            apiKey: "BRAVE_API_KEY_HERE",   // 你的 API Key
          },
        },
      },
    },
  },
  tools: {
    web: {
      search: {
        provider: "brave",          // 指定 Brave 为搜索提供商
        maxResults: 5,              // 每次返回结果数
        timeoutSeconds: 30,         // 请求超时秒数
      },
    },
  },
}

OpenClaw 使用的是 Brave Search 套餐。旧版 tools.web.search.apiKey 路径通过兼容层仍可用，但不再推荐使用。所有 Brave 专属设置应放在 plugins.entries.brave.config.webSearch.* 中。

工具参数 #

示例：

// 指定国家和语言搜索
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 控制台设置用量上限，避免意外扣费。
• LLM Context 权限：Search 套餐包含 LLM Context 端点和 AI 推理权限。如果计划将结果用于训练或微调模型，则需要具有明确存储权限的套餐。详细条款见 Brave 服务条款。
• 缓存：结果默认缓存 15 分钟，可通过 cacheTtlMinutes 调整。

完整的 web_search 配置可参考 Web 工具。

常见问题 #

Brave Search 配置后不生效，怎么办？ #

确认 plugins.entries.brave.config.webSearch.apiKey 填写正确，且 tools.web.search.provider 设为 "brave"。检查 Gateway 日志是否有 BRAVE_API_KEY 未设置或 API 返回 401 错误。最后用 openclaw doctor 验证工具配置。

免费额度用完后会停止服务还是自动扣费？ #

Brave 默认会继续提供服务并自动扣费。建议在 Brave API 控制台 设置每月用量上限，超过上限后请求将被拒绝，避免意外支出。

能否同时使用多个搜索提供商？ #

可以。tools.web.search.provider 只设置默认提供商。你也可以通过工具调用时动态指定（需 provider 参数支持）。目前 web_search 工具本身不支持一次请求多个提供商。