From bb2fc03e680b1a9c25b6a4d822475d1cf4b339b8 Mon Sep 17 00:00:00 2001 From: "openclaw-docs-i18n[bot]" Date: Sat, 2 May 2026 07:31:50 +0000 Subject: [PATCH] chore(i18n): refresh zh-CN translations --- docs/zh-CN/tools/brave-search.md | 39 ++++++++++++++++++++------------ 1 file changed, 24 insertions(+), 15 deletions(-) diff --git a/docs/zh-CN/tools/brave-search.md b/docs/zh-CN/tools/brave-search.md index 131264be8..9c347f787 100644 --- a/docs/zh-CN/tools/brave-search.md +++ b/docs/zh-CN/tools/brave-search.md @@ -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 或响应正文，但搜索查询可能包含敏感信息。 ## 相关内容