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 04:05:53 +00:00
parent 71aab44750
commit d2499be2db
2 changed files with 152 additions and 117 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

66
docs/zh-CN/tools/gemini-search.md
View File

@ -2,30 +2,30 @@
read_when:
- 你想使用 Gemini 进行 web_search
- 你需要一个 GEMINI_API_KEY
- 你想要 Google Search grounding
summary: 使用 Google Search 作为依据的 Gemini 网页搜索
- 你想要 Google Search 作为事实依据
summary: 基于 Google Search 依据增强的 Gemini 网页搜索
title: Gemini 搜索
x-i18n:
generated_at: "2026-05-02T02:49:13Z"
generated_at: "2026-05-02T04:04:58Z"
model: gpt-5.5
provider: openai
source_hash: 5e36382dc6a4f9a30f12025cc81bb7ed4999e56a236fc85ee7a37444674bf798
source_hash: e48b73a59f1af08cb1e30f149a18534dc76ba8dff26935d83fe8ccdaa8ab74e6
source_path: tools/gemini-search.md
workflow: 16
---
OpenClaw 支持带有内置
[Google Search 依据增强](https://ai.google.dev/gemini-api/docs/grounding)
的 Gemini 模型，它会返回由实时 Google Search 结果支持并附带引用的 AI 综合生成答案。
OpenClaw 支持带内置
[Google Search grounding](https://ai.google.dev/gemini-api/docs/grounding)
的 Gemini 模型，它会返回由实时 Google Search 结果支持并带有引用的 AI 合成答案。
## 获取 API 密钥
## 获取 API key
<Steps>
<Step title="创建密钥">
<Step title="Create a key">
前往 [Google AI Studio](https://aistudio.google.com/apikey) 并创建一个
API 密钥。
API key。
</Step>
<Step title="存储密钥">
<Step title="Store the key">
在 Gateway 网关环境中设置 `GEMINI_API_KEY`，或通过以下方式配置：
```bash
@ -63,46 +63,46 @@ OpenClaw 支持带有内置
```
**环境替代方案：**在 Gateway 网关环境中设置 `GEMINI_API_KEY`。
对于 gateway 安装，请将其放入 `~/.openclaw/.env`。
对于 Gateway 网关安装，请将它放在 `~/.openclaw/.env` 中。
## 工作原理
与返回链接和摘要列表的传统搜索提供商不同，
Gemini 使用 Google Search 依据增强来生成带有
内联引用的 AI 综合答案。结果同时包含综合生成的答案和来源
不同于返回链接和摘要列表的传统搜索提供商，Gemini 使用 Google Search grounding 来生成带有内联引用的 AI 合成答案。结果同时包含合成答案和源
URL。
- 来自 Gemini 依据增强的引用 URL 会自动从 Google
- 来自 Gemini grounding 的引用 URL 会自动从 Google
重定向 URL 解析为直接 URL。
- 重定向解析使用 SSRF 防护路径（HEAD + 重定向检查 +
http/https 验证），然后再返回最终引用 URL。
- 重定向解析使用严格的 SSRF 默认设置，因此会阻止重定向到
私有/内部目标。
- 重定向解析会使用 SSRF 防护路径（HEAD + 重定向检查 +
http/https 校验），然后返回最终引用 URL。
- 重定向解析使用严格的 SSRF 默认设置，因此指向
私有/内部目标的重定向会被阻止。
## 支持的参数
Gemini 搜索支持 `query`。
Gemini 搜索支持 `query`、`freshness`、`date_after` 和 `date_before`。
为兼容共享的 `web_search`，会接受 `count`，但 Gemini 依据增强
仍然返回一个带引用的综合生成答案，而不是 N 个结果的
列表。
`count` 可用于兼容共享的 `web_search`，但 Gemini grounding
仍会返回一个带引用的合成答案，而不是 N 条结果列表。
不支持特定于提供商的过滤器，例如 `country`、`language`、`freshness` 和
`domain_filter`。
`freshness` 接受 `day`、`week`、`month`、`year`，以及共享快捷值
`pd`、`pw`、`pm` 和 `py`。OpenClaw 会将这些值，或显式的
`date_after`/`date_before` 范围，转换为 Gemini Google Search grounding 的
`timeRangeFilter`。不支持 `country`、`language` 和 `domain_filter`。
## 模型选择
默认模型是 `gemini-2.5-flash`（快速且成本效益高）。任何支持依据增强的 Gemini
模型都可以通过
`plugins.entries.google.config.webSearch.model` 使用。
默认模型是 `gemini-2.5-flash`（快速且成本效益高）。任何支持 grounding 的 Gemini
模型都可以通过 `plugins.entries.google.config.webSearch.model` 使用。
## Base URL 覆盖
当 Gemini Web 搜索必须通过操作方代理或自定义的 Gemini 兼容端点路由时，设置 `plugins.entries.google.config.webSearch.baseUrl`。普通的 `https://generativelanguage.googleapis.com` 值会规范化为
`https://generativelanguage.googleapis.com/v1beta`；自定义代理路径会在去除末尾斜杠后按提供的形式保留。
当 Gemini Web 搜索必须通过运营方代理或自定义 Gemini 兼容端点路由时，请设置
`plugins.entries.google.config.webSearch.baseUrl`。普通的
`https://generativelanguage.googleapis.com` 值会被规范化为
`https://generativelanguage.googleapis.com/v1beta`；自定义代理路径会在去除末尾斜杠后按提供值保留。
## 相关内容
## 相关
- [Web Search 概览](/zh-CN/tools/web) -- 所有提供商和自动检测
- [Web 搜索概览](/zh-CN/tools/web) -- 所有提供商和自动检测
- [Brave Search](/zh-CN/tools/brave-search) -- 带摘要的结构化结果
- [Perplexity Search](/zh-CN/tools/perplexity-search) -- 结构化结果 + 内容提取

203
docs/zh-CN/tools/web.md
View File

@ -1,44 +1,46 @@
---
read_when:
- 你想启用或配置 web_search
- 你想要启用或配置 web_search
- 你想启用或配置 x_search
- 你需要选择一个搜索提供商
- 你想了解自动检测和提供商回退
sidebarTitle: Web Search
summary: web_search、x_search 和 web_fetch -- 搜索网页、搜索 X 帖子，或获取页面内容
summary: web_search、x_search 和 web_fetch -- 搜索 Web、搜索 X 帖子，或获取页面内容
title: Web 搜索
x-i18n:
generated_at: "2026-05-02T03:43:47Z"
generated_at: "2026-05-02T04:04:58Z"
model: gpt-5.5
provider: openai
source_hash: 873d953c068096a926940eb7065961814900417afdfbcf04946a6cefcd58f578
source_hash: 6112a067d6261dcad47a3a83c5185e6e492693b6df6a9d0bb2ca83d7ce2294cb
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。
<Info>
`web_search` 是一个轻量级 HTTP 工具，不是浏览器自动化。对于
JS 密集型网站或登录场景，请使用 [Web 浏览器](/zh-CN/tools/browser)。对于
抓取特定 URL，请使用 [Web Fetch](/zh-CN/tools/web-fetch)。
`web_search` 是轻量级 HTTP 工具，不是浏览器自动化。对于
JS 密集型站点或登录，请使用 [Web Browser](/zh-CN/tools/browser)。对于
获取特定 URL，请使用 [Web Fetch](/zh-CN/tools/web-fetch)。
</Info>
## 快速开始
<Steps>
<Step title="选择提供商">
选择一个提供商并完成任何必需的设置。有些提供商不需要密钥，而其他提供商使用 API key。详情请参阅下面的提供商页面。
选择一个提供商并完成所有必需设置。某些提供商无需密钥，
另一些则使用 API key。详情请参阅下面的提供商页面。
</Step>
<Step title="配置">
```bash
openclaw configure --section web
```
这会存储提供商和任何所需凭证。你也可以设置一个环境变量（例如 `BRAVE_API_KEY`），并对 API 支持的提供商跳过此步骤。
这会存储提供商和任何所需凭证。你也可以设置环境变量
（例如 `BRAVE_API_KEY`），并对 API 支持的提供商跳过此步骤。
</Step>
<Step title="使用">
<Step title="使用它">
智能体现在可以调用 `web_search`：
```javascript
@ -58,28 +60,28 @@ OpenClaw 还包含用于 X（前 Twitter）帖子的 `x_search`，以及用于
<CardGroup cols={2}>
<Card title="Brave Search" icon="shield" href="/zh-CN/tools/brave-search">
带摘要片段的结构化结果。支持 `llm-context` 模式，以及国家/语言筛选。提供免费套餐。
带摘要片段的结构化结果。支持 `llm-context` 模式、国家/语言筛选器。提供免费层级。
</Card>
<Card title="DuckDuckGo" icon="bird" href="/zh-CN/tools/duckduckgo-search">
免密钥回退。不需要 API key。基于非官方 HTML 的集成。
无需密钥的备用方案。不需要 API key。基于非官方 HTML 的集成。
</Card>
<Card title="Exa" icon="brain" href="/zh-CN/tools/exa-search">
神经网络 + 关键词搜索，并支持内容提取（高亮、文本、摘要）。
神经搜索 + 关键词搜索，并提供内容提取（高亮、文本、摘要）。
</Card>
<Card title="Firecrawl" icon="flame" href="/zh-CN/tools/firecrawl">
结构化结果。最适合与 `firecrawl_search` 和 `firecrawl_scrape` 搭配，用于深度提取。
结构化结果。最适合与 `firecrawl_search` 和 `firecrawl_scrape` 配合用于深度提取。
</Card>
<Card title="Gemini" icon="sparkles" href="/zh-CN/tools/gemini-search">
通过 Google Search grounding 提供带引用的 AI 合成答案。
通过 Google Search grounding 提供带引用的 AI 综合答案。
</Card>
<Card title="Grok" icon="zap" href="/zh-CN/tools/grok-search">
通过 xAI Web grounding 提供带引用的 AI 合成答案。
通过 xAI web grounding 提供带引用的 AI 综合答案。
</Card>
<Card title="Kimi" icon="moon" href="/zh-CN/tools/kimi-search">
通过 Moonshot Web 搜索提供带引用的 AI 合成答案。
通过 Moonshot Web 搜索提供带引用的 AI 综合答案。
</Card>
<Card title="MiniMax Search" icon="globe" href="/zh-CN/tools/minimax-search">
通过 MiniMax Coding Plan search API 提供结构化结果。
通过 MiniMax Coding Plan 搜索 API 提供结构化结果。
</Card>
<Card title="Ollama Web Search" icon="globe" href="/zh-CN/tools/ollama-search">
通过已登录的本地 Ollama 主机或托管的 Ollama API 搜索。
@ -95,19 +97,19 @@ OpenClaw 还包含用于 X（前 Twitter）帖子的 `x_search`，以及用于
</Card>
</CardGroup>
### 提供商比较
### 提供商对比
| 提供商 | 结果样式 | 筛选 | 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` |
| [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` |
| [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` |
| [Ollama Web Search](/zh-CN/tools/ollama-search) | 结构化摘要片段 | -- | 已登录本地主机无需密钥；直接 `https://ollama.com` 搜索使用 `OLLAMA_API_KEY` |
| [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` |
@ -116,7 +118,7 @@ OpenClaw 还包含用于 X（前 Twitter）帖子的 `x_search`，以及用于
## 原生 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 的代理 base URL 或 Azure 路由。将 `tools.web.search.provider` 设置为其他提供商（例如 `brave`）即可为 OpenAI 模型保留托管的 `web_search` 工具，或设置 `tools.web.search.enabled: false` 以同时禁用托管搜索和原生 OpenAI 搜索。
## 原生 Codex Web 搜索
@ -155,11 +157,13 @@ OpenClaw 还包含用于 X（前 Twitter）帖子的 `x_search`，以及用于
## 设置 Web 搜索
文档和设置流程中的提供商列表按字母顺序排列。自动检测会保留单独的优先级顺序。
文档和设置流程中的提供商列表按字母顺序排列。自动检测使用
单独的优先级顺序。
如果未设置 `provider`，OpenClaw 会按此顺序检查提供商，并使用第一个已就绪的提供商：
如果未设置 `provider`，OpenClaw 会按以下顺序检查提供商，并使用
第一个已就绪的提供商：
首先是 API 支持的提供商：
先检查 API 支持的提供商：
1. **Brave** -- `BRAVE_API_KEY` 或 `plugins.entries.brave.config.webSearch.apiKey`（顺序 10）
2. **MiniMax Search** -- `MINIMAX_CODE_PLAN_KEY` / `MINIMAX_CODING_API_KEY` 或 `plugins.entries.minimax.config.webSearch.apiKey`（顺序 15）
@ -171,16 +175,24 @@ OpenClaw 还包含用于 X（前 Twitter）帖子的 `x_search`，以及用于
8. **Exa** -- `EXA_API_KEY` 或 `plugins.entries.exa.config.webSearch.apiKey`（顺序 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 认证，并且在配置了 `OLLAMA_API_KEY` 时可直接调用 `https://ollama.com` 搜索（顺序 110）
12. **SearXNG** -- `SEARXNG_BASE_URL` 或 `plugins.entries.searxng.config.webSearch.baseUrl`（顺序 200）
如果未检测到提供商，它会回退到 Brave（你会看到提示你配置密钥的缺失密钥错误）。
如果未检测到提供商，它会回退到 Brave（你会收到缺少密钥的
错误，提示你配置一个）。
<Note>
所有提供商密钥字段都支持 SecretRef 对象。对于内置的 API 支持 Web 搜索提供商，包括 Brave、Exa、Firecrawl、Gemini、Grok、Kimi、MiniMax、Perplexity 和 Tavily，位于 `plugins.entries.<plugin>.config.webSearch.apiKey` 下的插件作用域 SecretRef 都会被解析；无论提供商是通过 `tools.web.search.provider` 显式选择，还是通过自动检测选择。在自动检测模式下，OpenClaw 只解析所选提供商的密钥 -- 未选中的 SecretRef 保持非活动状态，因此你可以配置多个提供商，而不会为未使用的提供商支付解析成本。
所有提供商密钥字段都支持 SecretRef 对象。位于
`plugins.entries.<plugin>.config.webSearch.apiKey` 下的插件作用域 SecretRef
会为内置 API 支持的 Web 搜索提供商解析，包括 Brave、Exa、Firecrawl、
Gemini、Grok、Kimi、MiniMax、Perplexity 和 Tavily，
无论该提供商是通过 `tools.web.search.provider` 显式选择，
还是通过自动检测选择。在自动检测模式下，OpenClaw 只解析
所选提供商的密钥 -- 未选中的 SecretRef 保持未激活，因此你可以
保留多个已配置的提供商，而无需为未使用的提供商支付解析成本。
</Note>
## 配置
@ -201,30 +213,38 @@ OpenClaw 还包含用于 X（前 Twitter）帖子的 `x_search`，以及用于
}
```
提供商专用配置（API key、基础 URL、模式）位于 `plugins.entries.<plugin>.config.webSearch.*` 下。示例请参阅提供商页面。
提供商专用配置（API key、base URL、模式）位于
`plugins.entries.<plugin>.config.webSearch.*` 下。示例请参阅提供商页面。
`web_fetch` 回退提供商选择是单独的：
`web_fetch` 备用提供商选择是独立的：
- 使用 `tools.web.fetch.provider` 选择它
- 或省略该字段，让 OpenClaw 从可用凭证中自动检测第一个已就绪的 Web 抓取提供商
- 非沙箱隔离的 `web_fetch` 可以使用声明了 `contracts.webFetchProviders` 的已安装插件提供商；沙箱隔离的抓取保持仅使用内置提供商
- 目前内置的 Web 抓取提供商是 Firecrawl，配置位于 `plugins.entries.firecrawl.config.webFetch.*` 下
- 或省略该字段，让 OpenClaw 从可用凭证中自动检测第一个已就绪的 web-fetch
提供商
- 非沙箱隔离的 `web_fetch` 可以使用声明了
`contracts.webFetchProviders` 的已安装插件提供商；沙箱隔离的获取保持仅使用内置提供商
- 目前内置的 web-fetch 提供商是 Firecrawl，配置位于
`plugins.entries.firecrawl.config.webFetch.*` 下
当你在 `openclaw onboard` 或 `openclaw configure --section web` 期间选择 **Kimi** 时，OpenClaw 还可以询问：
当你在 `openclaw onboard` 或
`openclaw configure --section web` 期间选择 **Kimi** 时，OpenClaw 还可以询问：
- 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 密钥
<Tabs>
<Tab title="Config file">
运行 `openclaw configure --section web`，或直接设置密钥：
<Tab title="配置文件">
运行 `openclaw configure --section web` 或直接设置密钥：
```json5
{
@ -243,53 +263,66 @@ OpenClaw 还包含用于 X（前 Twitter）帖子的 `x_search`，以及用于
```
</Tab>
<Tab title="Environment variable">
<Tab title="环境变量">
在 Gateway 网关进程环境中设置提供商环境变量：
```bash
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)。
</Tab>
</Tabs>
## 工具参数
| 参数 | 说明 |
| --------------------- | ------------------------------------------------------ |
| `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） |
<Warning>
并非所有参数都适用于所有提供商。Brave `llm-context` 模式会拒绝 `ui_lang`；`date_before` 也需要 `date_after`，因为 Brave 自定义新鲜度范围要求同时提供开始日期和结束日期。
Gemini、Grok 和 Kimi 会返回一个带引用的综合答案。它们接受 `count` 以兼容共享工具，但它不会改变基于依据的答案形态。
并非所有参数都适用于所有提供商。Brave `llm-context` 模式
会拒绝 `ui_lang`；`date_before` 也需要 `date_after`，因为 Brave 自定义
新鲜度范围要求同时提供开始日期和结束日期。
Gemini、Grok 和 Kimi 会返回一个带引用的综合答案。它们
为共享工具兼容性接受 `count`，但它不会改变
有依据答案的形态。Gemini 支持 `freshness`、`date_after` 和
`date_before`，会将它们转换为 Google Search 依据时间范围。
当你使用 Sonar/OpenRouter 兼容路径（`plugins.entries.perplexity.config.webSearch.baseUrl` /
`model` 或 `OPENROUTER_API_KEY`）时，Perplexity 的行为相同。
SearXNG 仅对受信任的私有网络或 local loopback 主机接受 `http://`；
SearXNG 仅对受信任的私有网络或 loopback 主机接受 `http://`；
公共 SearXNG 端点必须使用 `https://`。
Firecrawl 和 Tavily 通过 `web_search` 仅支持 `query` 和 `count`
-- 如需高级选项，请使用它们的专用工具。
Firecrawl 和 Tavily 通过 `web_search`
仅支持 `query` 和 `count` -- 高级选项请使用它们的专用工具。
</Warning>
## x_search
`x_search` 使用 xAI 查询 X（原 Twitter）帖子，并返回带引用的 AI 综合答案。它接受自然语言查询和可选的结构化过滤器。OpenClaw 仅在服务此工具调用的请求中启用内置 xAI `x_search` 工具。
`x_search` 使用 xAI 查询 X（原 Twitter）帖子，并返回
带引用的 AI 综合答案。它接受自然语言查询和
可选的结构化过滤器。OpenClaw 只会在服务此工具调用的请求上启用内置 xAI `x_search`
工具。
<Note>
xAI 文档说明 `x_search` 支持关键词搜索、语义搜索、用户搜索和主题串获取。对于转帖、回复、书签或浏览量等单帖互动统计，优先使用针对准确帖子 URL 或状态 ID 的定向查找。宽泛的关键词搜索可能找到正确帖子，但返回的单帖元数据不够完整。一个好的模式是：先定位帖子，然后运行第二个聚焦该准确帖子的 `x_search` 查询。
xAI 文档说明 `x_search` 支持关键词搜索、语义搜索、用户
搜索和 thread 获取。对于每条帖子的互动统计，例如转发、
回复、书签或浏览量，优先针对精确帖子 URL
或 status ID 进行定向查找。宽泛的关键词搜索可能找到正确的帖子，但返回的每条帖子元数据不够
完整。一个好的模式是：先定位帖子，然后
再运行第二次聚焦该精确帖子的 `x_search` 查询。
</Note>
### x_search 配置
@ -320,19 +353,21 @@ OpenClaw 还包含用于 X（前 Twitter）帖子的 `x_search`，以及用于
}
```
当设置了 `plugins.entries.xai.config.xSearch.baseUrl` 时，`x_search` 会发布到 `<baseUrl>/responses`。如果省略该字段，它会回退到 `plugins.entries.xai.config.webSearch.baseUrl`，再回退到旧版 `tools.web.search.grok.baseUrl`，最后回退到公共 xAI 端点。
设置 `plugins.entries.xai.config.xSearch.baseUrl` 时，`x_search` 会 POST 到 `<baseUrl>/responses`。
如果省略该字段，它会回退到 `plugins.entries.xai.config.webSearch.baseUrl`，然后是
旧版 `tools.web.search.grok.baseUrl`，最后是公共 xAI 端点。
### x_search 参数
| 参数 | 说明 |
| ---------------------------- | ------------------------------------------------------ |
| `query` | 搜索查询（必填） |
| `allowed_x_handles` | 将结果限制为特定 X handle |
| `excluded_x_handles` | 排除特定 X handle |
| `from_date` | 仅包含此日期当天或之后的帖子（YYYY-MM-DD） |
| `to_date` | 仅包含此日期当天或之前的帖子（YYYY-MM-DD） |
| `enable_image_understanding` | 允许 xAI 检查匹配帖子附带的图片 |
| `enable_video_understanding` | 允许 xAI 检查匹配帖子附带的视频 |
| 参数 | 描述 |
| ---------------------------- | ----------------------------------------------------- |
| `query` | 搜索查询（必需） |
| `allowed_x_handles` | 将结果限制为特定 X handles |
| `excluded_x_handles` | 排除特定 X handles |
| `from_date` | 只包含此日期当天或之后的帖子（YYYY-MM-DD） |
| `to_date` | 只包含此日期当天或之前的帖子（YYYY-MM-DD） |
| `enable_image_understanding` | 让 xAI 检查匹配帖子附带的图片 |
| `enable_video_understanding` | 让 xAI 检查匹配帖子附带的视频 |
### x_search 示例
@ -393,6 +428,6 @@ await web_search({
## 相关内容
- [Web Fetch](/zh-CN/tools/web-fetch) -- 获取 URL 并提取可读内容
- [Web Browser](/zh-CN/tools/browser) -- 面向 JS 密集型站点的完整浏览器自动化
- [Web Browser](/zh-CN/tools/browser) -- 面向 JS 较重网站的完整浏览器自动化
- [Grok Search](/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 搜索