From 9f54a9a6c6184de705e520e7b93f033f71d789ef Mon Sep 17 00:00:00 2001 From: "openclaw-docs-i18n[bot]" Date: Sat, 2 May 2026 05:11:53 +0000 Subject: [PATCH] chore(i18n): refresh zh-CN translations --- docs/zh-CN/tools/exa-search.md | 100 ++++++++++------- docs/zh-CN/tools/web.md | 189 ++++++++++++++++----------------- 2 files changed, 153 insertions(+), 136 deletions(-) diff --git a/docs/zh-CN/tools/exa-search.md b/docs/zh-CN/tools/exa-search.md index 588194337..543a4c24f 100644 --- a/docs/zh-CN/tools/exa-search.md +++ b/docs/zh-CN/tools/exa-search.md @@ -1,28 +1,31 @@ --- read_when: - - 你想将 Exa 用于 `web_search` - - 你需要一个 `EXA_API_KEY` - - 你想要神经搜索或内容提取 -summary: Exa AI 搜索——支持内容提取的神经搜索和关键词搜索 + - 你想使用 Exa 进行 web_search + - 你需要一个 EXA_API_KEY + - 你需要神经搜索或内容提取 +summary: Exa AI 搜索 -- 支持内容提取的神经搜索和关键词搜索 title: Exa 搜索 x-i18n: - generated_at: "2026-04-24T02:51:57Z" - model: gpt-5.4 + generated_at: "2026-05-02T05:10:57Z" + model: gpt-5.5 provider: openai - source_hash: 73cb69e672f432659c94c8d93ef52a88ecfcc9fa17d89af3e54493bd0cca4207 + source_hash: d2ddf83c5130208eadc78eccb10aebf67af11b05690d75a817d6999f79be5fc3 source_path: tools/exa-search.md - workflow: 15 + workflow: 16 --- -OpenClaw 支持将 [Exa AI](https://exa.ai/) 作为 `web_search` 提供商。Exa 提供神经搜索、关键词搜索和混合搜索模式，并内置内容提取功能（高亮、文本、摘要）。 +OpenClaw 支持将 [Exa AI](https://exa.ai/) 作为 `web_search` 提供商。Exa +提供神经、关键词和混合搜索模式，并内置内容提取 +（高亮、文本、摘要）。 ## 获取 API 密钥 - - 在 [exa.ai](https://exa.ai/) 注册，并在你的控制台中生成一个 API 密钥。 + + 在 [exa.ai](https://exa.ai/) 注册，并从你的 + 控制台生成 API 密钥。 - + 在 Gateway 网关环境中设置 `EXA_API_KEY`，或通过以下方式配置： ```bash @@ -42,6 +45,7 @@ OpenClaw 支持将 [Exa AI](https://exa.ai/) 作为 `web_search` 提供商。Exa config: { webSearch: { apiKey: "exa-...", // optional if EXA_API_KEY is set + baseUrl: "https://api.exa.ai", // optional; OpenClaw appends /search }, }, }, @@ -57,8 +61,16 @@ OpenClaw 支持将 [Exa AI](https://exa.ai/) 作为 `web_search` 提供商。Exa } ``` -**环境变量替代方式：** 在 Gateway 网关环境中设置 `EXA_API_KEY`。 -对于 gateway 安装，请将其放在 `~/.openclaw/.env` 中。 +**环境替代方案：**在 Gateway 网关环境中设置 `EXA_API_KEY`。 +对于 Gateway 网关安装，把它放在 `~/.openclaw/.env` 中。 + +## 基础 URL 覆盖 + +当 Exa 搜索请求需要通过兼容代理或备用 Exa 端点时，设置 +`plugins.entries.exa.config.webSearch.baseUrl`。OpenClaw +会通过前置 `https://` 规范化裸主机，并追加 `/search`，除非 +路径已经以它结尾。解析后的端点会包含在搜索缓存 +键中，因此来自不同 Exa 端点的结果不会共享。 ## 工具参数 @@ -67,7 +79,7 @@ OpenClaw 支持将 [Exa AI](https://exa.ai/) 作为 `web_search` 提供商。Exa -返回的结果数量（1–100）。 +要返回的结果数量（1–100）。 @@ -75,7 +87,7 @@ OpenClaw 支持将 [Exa AI](https://exa.ai/) 作为 `web_search` 提供商。Exa -时间筛选。 +时间过滤器。 @@ -92,8 +104,8 @@ OpenClaw 支持将 [Exa AI](https://exa.ai/) 作为 `web_search` 提供商。Exa ### 内容提取 -Exa 可以在搜索结果旁边返回提取出的内容。传入一个 `contents` -对象即可启用： +Exa 可以在搜索结果旁返回提取的内容。传入 `contents` +对象以启用： ```javascript await web_search({ @@ -107,35 +119,41 @@ await web_search({ }); ``` -| 内容选项 | 类型 | 描述 | -| ------------- | --------------------------------------------------------------------- | ------------ | -| `text` | `boolean \| { maxCharacters }` | 提取整页文本 | -| `highlights` | `boolean \| { maxCharacters, query, numSentences, highlightsPerUrl }` | 提取关键句子 | -| `summary` | `boolean \| { query }` | AI 生成摘要 | +| 内容选项 | 类型 | 描述 | +| --------------- | --------------------------------------------------------------------- | -------------------- | +| `text` | `boolean \| { maxCharacters }` | 提取完整页面文本 | +| `highlights` | `boolean \| { maxCharacters, query, numSentences, highlightsPerUrl }` | 提取关键句子 | +| `summary` | `boolean \| { query }` | AI 生成的摘要 | ### 搜索模式 -| 模式 | 描述 | -| ----------------- | ---------------------------- | -| `auto` | Exa 选择最佳模式（默认） | -| `neural` | 基于语义/含义的搜索 | -| `fast` | 快速关键词搜索 | -| `deep` | 更彻底的深度搜索 | -| `deep-reasoning` | 带推理能力的深度搜索 | -| `instant` | 最快返回结果 | +| 模式 | 描述 | +| ---------------- | ------------------------------- | +| `auto` | Exa 选择最佳模式（默认） | +| `neural` | 基于语义/含义的搜索 | +| `fast` | 快速关键词搜索 | +| `deep` | 彻底的深度搜索 | +| `deep-reasoning` | 带推理的深度搜索 | +| `instant` | 最快结果 | ## 注意事项 -- 如果未提供 `contents` 选项，Exa 默认使用 `{ highlights: true }`，因此结果会包含关键句摘录 -- 结果会在可用时保留来自 Exa API 响应中的 `highlightScores` 和 `summary` 字段 -- 结果描述会优先从高亮内容解析，其次是摘要，最后是全文文本——使用任何可用的内容 -- `freshness` 不能与 `date_after`/`date_before` 组合使用——请选择一种时间筛选模式 -- 每个查询最多可返回 100 条结果（受 Exa 搜索类型限制） -- 结果默认缓存 15 分钟（可通过 `cacheTtlMinutes` 配置） +- 如果没有提供 `contents` 选项，Exa 默认使用 `{ highlights: true }`， + 因此结果会包含关键句摘录 +- 可用时，结果会保留来自 Exa API + 响应的 `highlightScores` 和 `summary` 字段 +- 结果描述会优先从高亮中解析，其次是摘要，然后是 + 全文，以可用者为准 +- `freshness` 和 `date_after`/`date_before` 不能组合使用，请使用一种 + 时间过滤模式 +- 每次查询最多可返回 100 个结果（受 Exa 搜索类型 + 限制约束） +- 结果默认缓存 15 分钟（可通过 + `cacheTtlMinutes` 配置） - Exa 是一个官方 API 集成，提供结构化 JSON 响应 -## 相关内容 +## 相关 -- [Web Search 概览](/zh-CN/tools/web) —— 所有提供商和自动检测 -- [Brave Search](/zh-CN/tools/brave-search) —— 带国家/语言筛选的结构化结果 -- [Perplexity Search](/zh-CN/tools/perplexity-search) —— 带域名筛选的结构化结果 +- [Web 搜索概览](/zh-CN/tools/web) -- 所有提供商和自动检测 +- [Brave Search](/zh-CN/tools/brave-search) -- 带国家/语言过滤器的结构化结果 +- [Perplexity Search](/zh-CN/tools/perplexity-search) -- 带域名过滤的结构化结果 diff --git a/docs/zh-CN/tools/web.md b/docs/zh-CN/tools/web.md index f3c22f286..246ffb441 100644 --- a/docs/zh-CN/tools/web.md +++ b/docs/zh-CN/tools/web.md @@ -6,23 +6,23 @@ read_when: - 你想了解自动检测和提供商回退 sidebarTitle: Web Search summary: web_search、x_search 和 web_fetch -- 搜索网页、搜索 X 帖子，或获取页面内容 -title: 网络搜索 +title: Web 搜索 x-i18n: - generated_at: "2026-05-02T05:03:46Z" + generated_at: "2026-05-02T05:11:00Z" model: gpt-5.5 provider: openai - source_hash: 488f6206d02e4b511ac3350072562a4713fa5c1e0fc180bb76e880eed7048d38 + source_hash: 57af6990f2fa23dcb1062f813e7e6dbfc46f638865fee9107fd8bf957cdaf8ca source_path: tools/web.md workflow: 16 --- -`web_search` 工具使用你配置的提供商搜索 Web，并返回结果。结果按查询缓存 15 分钟（可配置）。 +`web_search` 工具使用你配置的提供商搜索 Web，并返回结果。结果会按查询缓存 15 分钟（可配置）。 -OpenClaw 还包含用于 X（原 Twitter）帖子的 `x_search`，以及用于轻量级 URL 获取的 `web_fetch`。在此阶段，`web_fetch` 保持本地执行，而 `web_search` 和 `x_search` 可以在底层使用 xAI Responses。 +OpenClaw 还包含用于 X（原 Twitter）帖子的 `x_search`，以及用于轻量级 URL 获取的 `web_fetch`。在此阶段，`web_fetch` 保持本地运行，而 `web_search` 和 `x_search` 可以在底层使用 xAI Responses。 `web_search` 是轻量级 HTTP 工具，不是浏览器自动化。对于 - JS 密集型站点或登录，请使用 [Web Browser](/zh-CN/tools/browser)。若要 + JS 密集型网站或登录场景，请使用 [Web Browser](/zh-CN/tools/browser)。如需 获取特定 URL，请使用 [Web Fetch](/zh-CN/tools/web-fetch)。 @@ -30,14 +30,14 @@ OpenClaw 还包含用于 X（原 Twitter）帖子的 `x_search`，以及用于 - 选择一个提供商并完成所有必需设置。有些提供商无需密钥， - 而有些使用 API key。详情请参阅下面的提供商页面。 + 选择一个提供商并完成所有必需设置。有些提供商 + 无需密钥，而其他提供商使用 API key。详情请参阅下面的提供商页面。 ```bash openclaw configure --section web ``` - 这会存储提供商和任何所需凭证。你也可以设置一个环境变量 + 这会存储提供商以及任何所需凭据。你也可以设置一个环境变量 （例如 `BRAVE_API_KEY`），并对 API 支持的提供商跳过此步骤。 @@ -60,22 +60,22 @@ OpenClaw 还包含用于 X（原 Twitter）帖子的 `x_search`，以及用于 - 带摘要片段的结构化结果。支持 `llm-context` 模式、国家/语言筛选器。提供免费套餐。 + 带摘要的结构化结果。支持 `llm-context` 模式、国家/语言过滤器。提供免费层。 - 无需密钥的后备选项。不需要 API key。基于非官方 HTML 的集成。 + 无需密钥的回退方案。不需要 API key。基于非官方 HTML 的集成。 - 神经搜索 + 关键词搜索，并支持内容提取（高亮、文本、摘要）。 + 神经 + 关键词搜索，并支持内容提取（高亮、文本、摘要）。 - 结构化结果。最适合与 `firecrawl_search` 和 `firecrawl_scrape` 搭配用于深度提取。 + 结构化结果。与 `firecrawl_search` 和 `firecrawl_scrape` 搭配使用时，最适合深度提取。 - 通过 Google 搜索支撑提供带引用的 AI 合成答案。 + 通过 Google Search grounding 提供带引用的 AI 合成答案。 - 通过 xAI Web 支撑提供带引用的 AI 合成答案。 + 通过 xAI web grounding 提供带引用的 AI 合成答案。 通过 Moonshot Web 搜索提供带引用的 AI 合成答案。 @@ -84,48 +84,48 @@ OpenClaw 还包含用于 X（原 Twitter）帖子的 `x_search`，以及用于 通过 MiniMax Token Plan 搜索 API 提供结构化结果。 - 通过已登录的本地 Ollama 主机或托管的 Ollama API 搜索。 + 通过已登录的本地 Ollama 主机或托管的 Ollama API 进行搜索。 - 带内容提取控制和域名筛选的结构化结果。 + 带内容提取控制和域名过滤的结构化结果。 自托管元搜索。不需要 API key。聚合 Google、Bing、DuckDuckGo 等。 - 带搜索深度、主题筛选，以及用于 URL 提取的 `tavily_extract` 的结构化结果。 + 带搜索深度、主题过滤以及用于 URL 提取的 `tavily_extract` 的结构化结果。 ### 提供商比较 -| 提供商 | 结果样式 | 筛选器 | API key | +| 提供商 | 结果样式 | 过滤器 | API key | | ----------------------------------------- | -------------------------- | ------------------------------------------------ | --------------------------------------------------------------------------------------- | -| [Brave](/zh-CN/tools/brave-search) | 结构化摘要片段 | 国家、语言、时间、`llm-context` 模式 | `BRAVE_API_KEY` | -| [DuckDuckGo](/zh-CN/tools/duckduckgo-search) | 结构化摘要片段 | -- | 无（无需密钥） | -| [Exa](/zh-CN/tools/exa-search) | 结构化 + 已提取内容 | 神经/关键词模式、日期、内容提取 | `EXA_API_KEY` | -| [Firecrawl](/zh-CN/tools/firecrawl) | 结构化摘要片段 | 通过 `firecrawl_search` 工具 | `FIRECRAWL_API_KEY` | -| [Gemini](/zh-CN/tools/gemini-search) | AI 合成 + 引用 | -- | `GEMINI_API_KEY` | -| [Grok](/zh-CN/tools/grok-search) | AI 合成 + 引用 | -- | `XAI_API_KEY` | -| [Kimi](/zh-CN/tools/kimi-search) | AI 合成 + 引用 | -- | `KIMI_API_KEY` / `MOONSHOT_API_KEY` | -| [MiniMax Search](/zh-CN/tools/minimax-search) | 结构化摘要片段 | 区域（`global` / `cn`） | `MINIMAX_CODE_PLAN_KEY` / `MINIMAX_CODING_API_KEY` / `MINIMAX_OAUTH_TOKEN` | -| [Ollama Web Search](/zh-CN/tools/ollama-search) | 结构化摘要片段 | -- | 已登录的本地主机无需；直接搜索 `https://ollama.com` 时使用 `OLLAMA_API_KEY` | -| [Perplexity](/zh-CN/tools/perplexity-search) | 结构化摘要片段 | 国家、语言、时间、域名、内容限制 | `PERPLEXITY_API_KEY` / `OPENROUTER_API_KEY` | -| [SearXNG](/zh-CN/tools/searxng-search) | 结构化摘要片段 | 类别、语言 | 无（自托管） | -| [Tavily](/zh-CN/tools/tavily) | 结构化摘要片段 | 通过 `tavily_search` 工具 | `TAVILY_API_KEY` | +| [Brave](/zh-CN/tools/brave-search) | 结构化摘要 | 国家、语言、时间、`llm-context` 模式 | `BRAVE_API_KEY` | +| [DuckDuckGo](/zh-CN/tools/duckduckgo-search) | 结构化摘要 | -- | 无（无需密钥） | +| [Exa](/zh-CN/tools/exa-search) | 结构化 + 已提取 | 神经/关键词模式、日期、内容提取 | `EXA_API_KEY` | +| [Firecrawl](/zh-CN/tools/firecrawl) | 结构化摘要 | 通过 `firecrawl_search` 工具 | `FIRECRAWL_API_KEY` | +| [Gemini](/zh-CN/tools/gemini-search) | AI 合成 + 引用 | -- | `GEMINI_API_KEY` | +| [Grok](/zh-CN/tools/grok-search) | AI 合成 + 引用 | -- | `XAI_API_KEY` | +| [Kimi](/zh-CN/tools/kimi-search) | AI 合成 + 引用 | -- | `KIMI_API_KEY` / `MOONSHOT_API_KEY` | +| [MiniMax Search](/zh-CN/tools/minimax-search) | 结构化摘要 | 区域（`global` / `cn`） | `MINIMAX_CODE_PLAN_KEY` / `MINIMAX_CODING_API_KEY` / `MINIMAX_OAUTH_TOKEN` | +| [Ollama Web Search](/zh-CN/tools/ollama-search) | 结构化摘要 | -- | 已登录的本地主机无需；直接 `https://ollama.com` 搜索使用 `OLLAMA_API_KEY` | +| [Perplexity](/zh-CN/tools/perplexity-search) | 结构化摘要 | 国家、语言、时间、域名、内容限制 | `PERPLEXITY_API_KEY` / `OPENROUTER_API_KEY` | +| [SearXNG](/zh-CN/tools/searxng-search) | 结构化摘要 | 类别、语言 | 无（自托管） | +| [Tavily](/zh-CN/tools/tavily) | 结构化摘要 | 通过 `tavily_search` 工具 | `TAVILY_API_KEY` | ## 自动检测 ## 原生 OpenAI Web 搜索 -当 OpenClaw Web 搜索已启用且未固定托管提供商时，直接 OpenAI Responses 模型会自动使用 OpenAI 托管的 `web_search` 工具。这是内置 OpenAI 插件中的提供商自有行为，并且只适用于原生 OpenAI API 流量，不适用于 OpenAI 兼容代理基础 URL 或 Azure 路由。将 `tools.web.search.provider` 设置为其他提供商（例如 `brave`），即可为 OpenAI 模型保留托管的 `web_search` 工具；或将 `tools.web.search.enabled: false` 设置为禁用托管搜索和原生 OpenAI 搜索。 +当 OpenClaw Web 搜索启用且未固定托管提供商时，直接 OpenAI Responses 模型会自动使用 OpenAI 托管的 `web_search` 工具。这是内置 OpenAI 插件中的提供商自有行为，并且只适用于原生 OpenAI API 流量，不适用于 OpenAI 兼容代理基准 URL 或 Azure 路由。将 `tools.web.search.provider` 设置为其他提供商（例如 `brave`），即可为 OpenAI 模型保留托管的 `web_search` 工具；或者设置 `tools.web.search.enabled: false` 来同时禁用托管搜索和原生 OpenAI 搜索。 ## 原生 Codex Web 搜索 支持 Codex 的模型可以选择使用提供商原生 Responses `web_search` 工具，而不是 OpenClaw 托管的 `web_search` 函数。 -- 在 `tools.web.search.openaiCodex` 下配置它 -- 它只会为支持 Codex 的模型（`openai-codex/*` 或使用 `api: "openai-codex-responses"` 的提供商）启用 +- 在 `tools.web.search.openaiCodex` 下配置 +- 它只会为支持 Codex 的模型激活（`openai-codex/*` 或使用 `api: "openai-codex-responses"` 的提供商） - 托管的 `web_search` 仍适用于非 Codex 模型 - `mode: "cached"` 是默认且推荐的设置 - `tools.web.search.enabled: false` 会同时禁用托管搜索和原生搜索 @@ -157,7 +157,7 @@ OpenClaw 还包含用于 X（原 Twitter）帖子的 `x_search`，以及用于 ## 设置 Web 搜索 -文档和设置流程中的提供商列表按字母顺序排列。自动检测保留 +文档和设置流程中的提供商列表按字母顺序排列。自动检测使用 单独的优先级顺序。 如果未设置 `provider`，OpenClaw 会按以下顺序检查提供商，并使用 @@ -172,27 +172,27 @@ OpenClaw 还包含用于 X（原 Twitter）帖子的 `x_search`，以及用于 5. **Kimi** -- `KIMI_API_KEY` / `MOONSHOT_API_KEY` 或 `plugins.entries.moonshot.config.webSearch.apiKey`（顺序 40） 6. **Perplexity** -- `PERPLEXITY_API_KEY` / `OPENROUTER_API_KEY` 或 `plugins.entries.perplexity.config.webSearch.apiKey`（顺序 50） 7. **Firecrawl** -- `FIRECRAWL_API_KEY` 或 `plugins.entries.firecrawl.config.webSearch.apiKey`（顺序 60） -8. **Exa** -- `EXA_API_KEY` 或 `plugins.entries.exa.config.webSearch.apiKey`（顺序 65） +8. **Exa** -- `EXA_API_KEY` 或 `plugins.entries.exa.config.webSearch.apiKey`；可选的 `plugins.entries.exa.config.webSearch.baseUrl` 会覆盖 Exa 端点（顺序 65） 9. **Tavily** -- `TAVILY_API_KEY` 或 `plugins.entries.tavily.config.webSearch.apiKey`（顺序 70） -之后是无需密钥的后备选项： +之后是无需密钥的回退方案： -10. **DuckDuckGo** -- 无需账号或 API key 的无密钥 HTML 后备选项（顺序 100） -11. **Ollama Web Search** -- 当你配置的本地 Ollama 主机可访问且已通过 `ollama signin` 登录时，通过该主机提供无密钥后备；主机需要时可复用 Ollama provider bearer auth，并且在配置 `OLLAMA_API_KEY` 后可调用直接 `https://ollama.com` 搜索（顺序 110） +10. **DuckDuckGo** -- 无需账户或 API key 的无密钥 HTML 回退方案（顺序 100） +11. **Ollama Web Search** -- 当你配置的本地 Ollama 主机可访问且已通过 `ollama signin` 登录时，通过该主机提供的无密钥回退方案；当主机需要时可复用 Ollama provider bearer auth，并且在配置 `OLLAMA_API_KEY` 后可调用直接 `https://ollama.com` 搜索（顺序 110） 12. **SearXNG** -- `SEARXNG_BASE_URL` 或 `plugins.entries.searxng.config.webSearch.baseUrl`（顺序 200） 如果未检测到提供商，它会回退到 Brave（你会收到缺少密钥的 -错误，提示你配置一个密钥）。 +错误，提示你配置一个）。 - 所有提供商密钥字段都支持 SecretRef 对象。位于 - `plugins.entries..config.webSearch.apiKey` 下的插件作用域 SecretRef - 会为内置 API 支持的 Web 搜索提供商解析，包括 Brave、Exa、Firecrawl、 + 所有提供商密钥字段都支持 SecretRef 对象。对于内置的 API 支持 Web 搜索提供商， + 位于 `plugins.entries..config.webSearch.apiKey` 下的插件作用域 SecretRef + 会被解析，包括 Brave、Exa、Firecrawl、 Gemini、Grok、Kimi、MiniMax、Perplexity 和 Tavily， - 无论提供商是通过 `tools.web.search.provider` 显式选择， + 无论该提供商是通过 `tools.web.search.provider` 显式选择， 还是通过自动检测选择。在自动检测模式下，OpenClaw 只解析 - 已选提供商密钥 -- 未选中的 SecretRef 保持不活跃，因此你可以 - 保持配置多个提供商，而无需为未使用的提供商支付解析成本。 + 已选提供商的密钥 -- 未选中的 SecretRef 会保持非活动状态，因此你可以 + 配置多个提供商，而无需为未使用的提供商支付解析成本。 ## 配置 @@ -213,20 +213,19 @@ OpenClaw 还包含用于 X（原 Twitter）帖子的 `x_search`，以及用于 } ``` -提供商特定配置（API key、基础 URL、模式）位于 -`plugins.entries..config.webSearch.*` 下。Gemini 还可以在其专用 -Web 搜索配置和 `GEMINI_API_KEY` 之后，将 -`models.providers.google.apiKey` 和 `models.providers.google.baseUrl` 复用为较低优先级的 -后备选项。示例请参阅提供商页面。 +提供商特定配置（API keys、基准 URL、模式）位于 +`plugins.entries..config.webSearch.*` 下。Gemini 还可以在专用 Web 搜索配置和 `GEMINI_API_KEY` 之后，以较低优先级回退方式复用 +`models.providers.google.apiKey` 和 `models.providers.google.baseUrl`。 +示例请参阅提供商页面。 -`web_fetch` 后备提供商选择是单独的： +`web_fetch` 回退提供商选择是独立的： - 使用 `tools.web.fetch.provider` 选择它 -- 或省略该字段，让 OpenClaw 从可用凭证中自动检测第一个就绪的 Web 获取 +- 或省略该字段，让 OpenClaw 从可用凭据中自动检测第一个已就绪的 Web 获取 提供商 -- 非沙箱隔离的 `web_fetch` 可以使用声明了 - `contracts.webFetchProviders` 的已安装插件提供商；沙箱隔离的获取保持仅限内置 -- 目前内置 Web 获取提供商是 Firecrawl，配置位于 +- 非沙箱隔离的 `web_fetch` 可以使用声明 + `contracts.webFetchProviders` 的已安装插件提供商；沙箱隔离获取保持仅内置 +- 目前内置的 Web 获取提供商是 Firecrawl，配置位于 `plugins.entries.firecrawl.config.webFetch.*` 下 当你在 `openclaw onboard` 或 @@ -235,16 +234,16 @@ Web 搜索配置和 `GEMINI_API_KEY` 之后，将 - Moonshot API 区域（`https://api.moonshot.ai/v1` 或 `https://api.moonshot.cn/v1`） - 默认 Kimi Web 搜索模型（默认为 `kimi-k2.6`） -对于 `x_search`，配置 `plugins.entries.xai.config.xSearch.*`。它使用与 Grok 网络搜索相同的 `XAI_API_KEY` 回退。 +对于 `x_search`，配置 `plugins.entries.xai.config.xSearch.*`。它使用与 Grok Web 搜索相同的 `XAI_API_KEY` 后备值。 旧版 `tools.web.x_search.*` 配置会由 `openclaw doctor --fix` 自动迁移。 -当你在 `openclaw onboard` 或 `openclaw configure --section web` 期间选择 Grok 时，OpenClaw 也可以提供可选的 `x_search` 设置，并使用相同的密钥。 -这是 Grok 路径中的一个单独后续步骤，不是单独的顶层网络搜索提供商选择。如果你选择其他提供商，OpenClaw 不会显示 `x_search` 提示。 +当你在 `openclaw onboard` 或 `openclaw configure --section web` 期间选择 Grok 时，OpenClaw 也可以提供使用同一密钥的可选 `x_search` 设置。 +这是 Grok 路径中的一个单独后续步骤，而不是单独的顶层 Web 搜索提供商选择。如果你选择其他提供商，OpenClaw 不会显示 `x_search` 提示。 ### 存储 API 密钥 - 运行 `openclaw configure --section web`，或直接设置密钥： + 运行 `openclaw configure --section web` 或直接设置密钥： ```json5 { @@ -270,43 +269,43 @@ Web 搜索配置和 `GEMINI_API_KEY` 之后，将 export BRAVE_API_KEY="YOUR_KEY" ``` - 对于 Gateway 网关安装，请将它放入 `~/.openclaw/.env`。 - 参见 [环境变量](/zh-CN/help/faq#env-vars-and-env-loading)。 + 对于 Gateway 网关安装，请将其放在 `~/.openclaw/.env` 中。 + 参见[环境变量](/zh-CN/help/faq#env-vars-and-env-loading)。 ## 工具参数 -| 参数 | 描述 | -| --------------------- | ------------------------------------------------------ | -| `query` | 搜索查询（必填） | -| `count` | 要返回的结果数（1-10，默认：5） | -| `country` | 2 字母 ISO 国家/地区代码（例如 "US"、"DE"） | -| `language` | ISO 639-1 语言代码（例如 "en"、"de"） | -| `search_lang` | 搜索语言代码（仅 Brave） | -| `freshness` | 时间过滤器：`day`、`week`、`month` 或 `year` | -| `date_after` | 此日期之后的结果（YYYY-MM-DD） | -| `date_before` | 此日期之前的结果（YYYY-MM-DD） | -| `ui_lang` | UI 语言代码（仅 Brave） | -| `domain_filter` | 域名允许列表/拒绝列表数组（仅 Perplexity） | -| `max_tokens` | 总内容预算，默认 25000（仅 Perplexity） | -| `max_tokens_per_page` | 每页 token 限制，默认 2048（仅 Perplexity） | +| 参数 | 描述 | +| --------------------- | ----------------------------------------------------- | +| `query` | 搜索查询（必需） | +| `count` | 要返回的结果数（1-10，默认值：5） | +| `country` | 2 字母 ISO 国家/地区代码（例如 "US"、"DE"） | +| `language` | ISO 639-1 语言代码（例如 "en"、"de"） | +| `search_lang` | 搜索语言代码（仅 Brave） | +| `freshness` | 时间过滤器：`day`、`week`、`month` 或 `year` | +| `date_after` | 此日期之后的结果（YYYY-MM-DD） | +| `date_before` | 此日期之前的结果（YYYY-MM-DD） | +| `ui_lang` | UI 语言代码（仅 Brave） | +| `domain_filter` | 域名允许列表/拒绝列表数组（仅 Perplexity） | +| `max_tokens` | 总内容预算，默认 25000（仅 Perplexity） | +| `max_tokens_per_page` | 每页 token 限制，默认 2048（仅 Perplexity） | 并非所有参数都适用于所有提供商。Brave `llm-context` 模式会拒绝 `ui_lang`；`date_before` 也需要 `date_after`，因为 Brave 自定义 freshness 范围要求同时提供开始日期和结束日期。 - Gemini、Grok 和 Kimi 会返回一个带引用的合成答案。它们接受 `count` 以兼容共享工具，但它不会改变基于依据的答案形态。Gemini 支持 `freshness`、`date_after` 和 `date_before`，方式是将它们转换为 Google 搜索 grounding 时间范围。 + Gemini、Grok 和 Kimi 会返回一个带引用的综合答案。它们接受 `count` 以兼容共享工具，但该参数不会改变有依据答案的形态。Gemini 支持 `freshness`、`date_after` 和 `date_before`，会将它们转换为 Google Search grounding 时间范围。 当你使用 Sonar/OpenRouter 兼容路径（`plugins.entries.perplexity.config.webSearch.baseUrl` / `model` 或 `OPENROUTER_API_KEY`）时，Perplexity 的行为也相同。 - SearXNG 仅对受信任的私有网络或 local loopback 主机接受 `http://`；公共 SearXNG 端点必须使用 `https://`。 + SearXNG 仅对受信任的私有网络或 local loopback 主机接受 `http://`；公开的 SearXNG 端点必须使用 `https://`。 Firecrawl 和 Tavily 通过 `web_search` 仅支持 `query` 和 `count`，高级选项请使用它们的专用工具。 ## x_search -`x_search` 使用 xAI 查询 X（原 Twitter）帖子，并返回带引用的 AI 合成答案。它接受自然语言查询和可选的结构化过滤器。OpenClaw 只会在服务此工具调用的请求中启用内置 xAI `x_search` 工具。 +`x_search` 使用 xAI 查询 X（原 Twitter）帖子，并返回带引用的 AI 综合答案。它接受自然语言查询和可选的结构化过滤器。OpenClaw 只会在服务于此工具调用的请求上启用内置 xAI `x_search` 工具。 - xAI 文档说明 `x_search` 支持关键词搜索、语义搜索、用户搜索和线程获取。对于单条帖子的互动统计数据，例如转发、回复、书签或浏览量，优先针对确切的帖子 URL 或状态 ID 进行定向查找。宽泛的关键词搜索可能会找到正确的帖子，但返回的单帖元数据可能不够完整。一个好的模式是：先定位帖子，然后再运行第二个聚焦于该确切帖子的 `x_search` 查询。 + xAI 文档说明 `x_search` 支持关键词搜索、语义搜索、用户搜索和主题串获取。对于每帖互动统计信息，例如转帖、回复、收藏或浏览量，优先针对确切帖子 URL 或状态 ID 进行定向查询。广泛的关键词搜索可能找到正确的帖子，但返回的每帖元数据可能不够完整。一个好的模式是：先定位帖子，然后运行第二次 `x_search` 查询，聚焦于该确切帖子。 ### x_search 配置 @@ -337,19 +336,19 @@ Web 搜索配置和 `GEMINI_API_KEY` 之后，将 } ``` -当设置了 `plugins.entries.xai.config.xSearch.baseUrl` 时，`x_search` 会发布到 `/responses`。如果省略该字段，它会回退到 `plugins.entries.xai.config.webSearch.baseUrl`，然后回退到旧版 `tools.web.search.grok.baseUrl`，最后回退到公共 xAI 端点。 +当设置了 `plugins.entries.xai.config.xSearch.baseUrl` 时，`x_search` 会发布到 `/responses`。如果省略该字段，它会回退到 `plugins.entries.xai.config.webSearch.baseUrl`，然后回退到旧版 `tools.web.search.grok.baseUrl`，最后回退到公开 xAI 端点。 ### x_search 参数 -| 参数 | 描述 | -| ---------------------------- | ------------------------------------------------------ | -| `query` | 搜索查询（必填） | -| `allowed_x_handles` | 将结果限制为特定 X 用户名 | -| `excluded_x_handles` | 排除特定 X 用户名 | -| `from_date` | 仅包含此日期当天或之后的帖子（YYYY-MM-DD） | -| `to_date` | 仅包含此日期当天或之前的帖子（YYYY-MM-DD） | -| `enable_image_understanding` | 让 xAI 检查匹配帖子附带的图片 | -| `enable_video_understanding` | 让 xAI 检查匹配帖子附带的视频 | +| 参数 | 描述 | +| ---------------------------- | ----------------------------------------------- | +| `query` | 搜索查询（必需） | +| `allowed_x_handles` | 将结果限制为特定 X 账号 | +| `excluded_x_handles` | 排除特定 X 账号 | +| `from_date` | 仅包含此日期当天或之后的帖子（YYYY-MM-DD） | +| `to_date` | 仅包含此日期当天或之前的帖子（YYYY-MM-DD） | +| `enable_image_understanding` | 让 xAI 检查匹配帖子附带的图片 | +| `enable_video_understanding` | 让 xAI 检查匹配帖子附带的视频 | ### x_search 示例 @@ -394,9 +393,9 @@ await web_search({ }); ``` -## 工具配置档案 +## 工具配置文件 -如果你使用工具配置档案或允许列表，请添加 `web_search`、`x_search` 或 `group:web`： +如果你使用工具配置文件或允许列表，请添加 `web_search`、`x_search` 或 `group:web`： ```json5 { @@ -409,7 +408,7 @@ await web_search({ ## 相关 -- [Web 获取](/zh-CN/tools/web-fetch) -- 获取 URL 并提取可读内容 -- [Web 浏览器](/zh-CN/tools/browser) -- 面向 JS 密集型站点的完整浏览器自动化 +- [Web Fetch](/zh-CN/tools/web-fetch) -- 获取 URL 并提取可读内容 +- [Web 浏览器](/zh-CN/tools/browser) -- 针对 JS 密集型网站的完整浏览器自动化 - [Grok 搜索](/zh-CN/tools/grok-search) -- 将 Grok 作为 `web_search` 提供商 -- [Ollama Web 搜索](/zh-CN/tools/ollama-search) -- 通过你的 Ollama 主机进行免密钥网络搜索 +- [Ollama Web 搜索](/zh-CN/tools/ollama-search) -- 通过你的 Ollama 主机进行无需密钥的 Web 搜索