openclaw/docs
openclaw/docs
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

chore(i18n): refresh zh-CN translations

Browse Source
This commit is contained in:
openclaw-docs-i18n[bot] 2026-05-02 07:31:50 +00:00
parent b71b429f69
commit bb2fc03e68
1 changed files with 24 additions and 15 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

39
docs/zh-CN/tools/brave-search.md
View File

@ -1,14 +1,14 @@
---
read_when:
- 你想使用 Brave Search 进行 web_search
- 你需要 BRAVE_API_KEY 或套餐详情
- 你需要 BRAVE_API_KEY 或计划详情
summary: 用于 web_search 的 Brave Search API 设置
title: Brave 搜索
x-i18n:
generated_at: "2026-05-02T06:53:20Z"
generated_at: "2026-05-02T07:31:25Z"
model: gpt-5.5
provider: openai
source_hash: 06cfef368f01d0af91ddb4e8adc13b7699019cbf662783b88c573049bfb77e18
source_hash: b1ecb9e3e5475bb26f4058311429b558f49cdd1df907a622f93f297ac6569d65
source_path: tools/brave-search.md
workflow: 16
---
@ -20,8 +20,8 @@ OpenClaw 支持将 Brave Search API 用作 `web_search` 提供商。
## 获取 API key
1. 在 [https://brave.com/search/api/](https://brave.com/search/api/) 创建 Brave Search API 账号
2. 在仪表板中，选择 **Search** 方案并生成 API key。
3. 将该键存储在配置中，或在 Gateway 网关环境中设置 `BRAVE_API_KEY`。
2. 在仪表盘中选择 **Search** 套餐并生成 API key。
3. 将 key 存入配置，或在 Gateway 网关环境中设置 `BRAVE_API_KEY`。
## 配置示例
@ -34,6 +34,7 @@ OpenClaw 支持将 Brave Search API 用作 `web_search` 提供商。
webSearch: {
apiKey: "BRAVE_API_KEY_HERE",
mode: "web", // or "llm-context"
baseUrl: "https://api.search.brave.com", // optional proxy/base URL override
},
},
},
@ -51,13 +52,19 @@ OpenClaw 支持将 Brave Search API 用作 `web_search` 提供商。
}
```
Brave 提供商专用搜索设置现在位于 `plugins.entries.brave.config.webSearch.*` 下。
Brave 专属搜索设置现在位于 `plugins.entries.brave.config.webSearch.*` 下。
旧版 `tools.web.search.apiKey` 仍会通过兼容性 shim 加载，但它不再是规范配置路径。
`webSearch.mode` 控制 Brave 传输方式：
- `web`（默认）：普通 Brave 网页搜索，包含标题、URL 和摘要片段
- `llm-context`：Brave LLM Context API，包含预提取的文本块和用于依据来源的来源信息
- `web`（默认）：普通 Brave Web 搜索，包含标题、URL 和摘要
- `llm-context`：Brave LLM Context API，提供预提取的文本块和用于溯源的来源
`webSearch.baseUrl` 可以将 Brave 请求指向受信任且兼容 Brave 的代理
或网关。OpenClaw 会把 `/res/v1/web/search` 或 `/res/v1/llm/context` 追加到
配置的 base URL，并将 base URL 保留在缓存键中。公共
端点必须使用 `https://`；`http://` 仅接受用于受信任的 loopback
或私有网络代理主机。
## 工具参数
@ -123,14 +130,16 @@ await web_search({
## 说明
- OpenClaw 使用 Brave **Search** 方案。如果你有旧版订阅（例如原始的每月 2,000 次查询 Free 方案），它仍然有效，但不包含 LLM Context 或更高频率限制等较新功能。
- 每个 Brave 方案都包含 **每月 \$5 免费额度**（会续期）。Search 方案价格为每 1,000 次请求 \$5，因此该额度可覆盖每月 1,000 次查询。请在 Brave 仪表板中设置你的用量限制，以避免意外收费。有关当前方案，请参阅 [Brave API 门户](https://brave.com/search/api/)。
- Search 方案包含 LLM Context 端点和 AI 推理权限。存储结果以训练或调优模型需要具有明确存储权限的方案。请参阅 Brave [服务条款](https://api-dashboard.search.brave.com/terms-of-service)。
- `llm-context` 模式返回有依据来源的来源条目，而不是普通网页搜索摘要形态。
- `llm-context` 模式支持 `freshness` 以及有界的 `date_after` + `date_before` 范围。它不支持 `ui_lang`；没有 `date_after` 的 `date_before` 会被拒绝，因为 Brave 要求自定义 freshness 范围同时包含开始日期和结束日期。
- `ui_lang` 必须包含区域子标签，例如 `en-US`。
- OpenClaw 使用 Brave **Search** 套餐。如果你有旧版订阅（例如原始 Free 套餐，每月 2,000 次查询），它仍然有效，但不包含 LLM Context 或更高速率限制等较新功能。
- 每个 Brave 套餐都包含 **每月 \$5 免费额度**（续期）。Search 套餐价格为每 1,000 次请求 \$5，因此该额度覆盖每月 1,000 次查询。请在 Brave 仪表盘中设置你的用量限制，以避免意外费用。当前套餐请参阅 [Brave API 门户](https://brave.com/search/api/)。
- Search 套餐包含 LLM Context 端点和 AI 推理权利。存储结果以训练或调优模型需要具有明确存储权利的套餐。请参阅 Brave [服务条款](https://api-dashboard.search.brave.com/terms-of-service)。
- `llm-context` 模式返回有来源支撑的来源条目，而不是普通 Web 搜索摘要形状。
- `llm-context` 模式支持 `freshness` 以及有边界的 `date_after` + `date_before` 范围。它不支持 `ui_lang`；没有 `date_after` 的 `date_before` 会被拒绝，因为 Brave 要求自定义 freshness 范围同时包含开始日期和结束日期。
- `ui_lang` 必须包含类似 `en-US` 的区域子标签。
- 结果默认缓存 15 分钟（可通过 `cacheTtlMinutes` 配置）。
- 启用 `brave.http` 诊断标志，可在故障排除时记录 Brave 请求 URL/查询参数、响应状态/耗时，以及搜索缓存命中/未命中/写入事件。该标志绝不会记录 API key 或响应正文，但搜索查询可能包含敏感信息。
- 自定义 `webSearch.baseUrl` 值会包含在 Brave 缓存身份中，因此
代理专属响应不会发生冲突。
- 启用 `brave.http` 诊断标志可在故障排除时记录 Brave 请求 URL/查询参数、响应状态/耗时，以及搜索缓存命中/未命中/写入事件。该标志绝不会记录 API key 或响应正文，但搜索查询可能包含敏感信息。
## 相关内容