本页内容
本页内容
工具
Brave 搜索
OpenClaw 支持 Brave Search API 作为 web_search 提供方。
获取 API 密钥
- 在 https://brave.com/search/api/ 创建一个 Brave Search API 账户
- 在控制台中,选择 Search 套餐并生成一个 API 密钥。
- 将密钥存储到配置中,或在 Gateway 环境中设置
BRAVE_API_KEY。
配置示例
特定于提供商的 Brave 搜索设置位于 plugins.entries.brave.config.webSearch.* 下;这是要使用的配置路径。
webSearch.mode 控制 Brave 的传输方式:
web(默认):正常 Brave Web 搜索,包含标题、URL 和片段llm-context:Brave LLM Context API,返回预先提取的文本片段和来源,用于提供依据
webSearch.baseUrl 可以将 Brave 请求指向受信任的 Brave- 兼容代理或网关。 OpenClaw 将 /res/v1/web/search 或 /res/v1/llm/context 附加到配置的基础 URL 并将基础 URL 保留在缓存密钥中。公共端点必须使用https://; http:// 仅适用于受信任的环回或专用网络代理主机。
工具参数
querystring必填搜索查询。
countnumberdefault: 5返回结果数量(1–10)。
countrystring2 个字母 ISO 国家/地区代码(e.g. US、DE)。
languagestringISO 639-1 搜索结果的语言代码(e.g. en、de、fr)。
search_langstringBrave 搜索语言代码(e.g. en、en-gb、zh-hans)。
ui_langstringUI 元素的 ISO 语言代码。
freshness'day' | 'week' | 'month' | 'year'时间筛选器 — day 表示 24 小时。
date_afterstring仅返回在此日期之后发布的结果(YYYY-MM-DD)。
date_beforestring仅返回在此日期之前发布的结果(YYYY-MM-DD)。
示例:
说明
-
Results 公开来自 Brave 的 ISO 发布元数据的
published:Web 模式下的page_age以及llm-context模式下匹配源的 ISO 时间戳或日期。相对年龄和获取时间戳不是发布日期。无偏移时间戳保持无偏移; OpenClaw 没有发明时区。当新鲜度很重要时,请验证来源日期。 -
OpenClaw 使用 Brave Search 计划。如果您有旧版订阅(e.g. 原始免费套餐,包含 2,000 个 queries/month),它仍然有效,但不包括 LLM Context 等新功能或更高的速率限制。
-
Each Brave 计划包括 \5 美元/月的免费信用额度(续订)。搜索计划的费用为每 1,000 个请求 5 美元,因此信用额度涵盖 1,000 queries/month. 在 Brave 仪表板中设置您的使用限制,以避免意外费用。有关当前计划,请参阅 Brave API 门户 。
-
搜索计划包括 LLM 上下文端点和 AI 推理权限。存储结果以训练或调整模型需要具有明确存储权限的计划。请参阅 Brave Service 的条款。
-
llm-context模式返回有依据的来源条目,而不是普通 web-search 摘要的结构。 -
llm-context模式支持freshness和有界date_after+date_before范围。不支持ui_lang;没有date_after的date_before会被拒绝,因为 Brave 需要自定义新鲜度范围以包括开始日期和结束日期。 -
ui_lang必须包含区域子标签,例如en-US。 -
结果默认缓存 15 分钟(可通过
cacheTtlMinutes配置)。 -
tools.web.search.timeoutSeconds涵盖端点验证,包括 DNS、HTTP 请求以及两种 Brave 模式下的响应读取。 -
自定义的
webSearch.baseUrl值会包含在 Brave 缓存标识中,因此不同代理的响应不会发生冲突。 -
启用
brave.http诊断标志以在故障排除时记录 Brave 请求 URLs/query 参数、响应 status/timing 和搜索缓存 hit/miss/write 事件。该标志从不记录 API 密钥或响应正文,但搜索查询可能很敏感。
相关内容
- 网页搜索概述 -- 所有提供商和自动检测
- Perplexity Search -- 带域过滤的结构化结果
- Exa Search -- 带有内容提取的神经搜索