Grok 搜索
OpenClaw 支持将 Grok 用作 web_search 提供程序,使用 xAI 基于网络的响应来生成由实时搜索结果和引用支持的 AI 合成答案。
Grok 网络搜索在可用时优先使用现有的 xAI OAuth 登录。如果不存在 OAuth 配置文件,同一个 xAI API 密钥也将为内置的 x_search 工具(用于 X(原 Twitter)帖子搜索)和 code_execution 工具提供支持。将密钥存储在 plugins.entries.xai.config.webSearch.apiKey 中,还可让 OpenClaw 将其作为内置 xAI 模型提供程序的回退。
对于帖子级别的 X 指标(转发、回复、书签、浏览),请使用 x_search 并提供精确的帖子 URL 或状态 ID,而不是宽泛的搜索查询。
引导与配置¶
在 openclaw onboard 或 openclaw configure --section
web 期间选择 Grok,可让 OpenClaw 复用现有的 xAI OAuth 配置文件,而无需提示输入单独的网络搜索密钥。如果没有 OAuth,则会回退到 xAI API 密钥设置。
随后,OpenClaw 会提供一个后续步骤,使用相同的 xAI 凭据启用 x_search。该后续步骤:
- 仅在你为
web_search选择 Grok 后出现 - 不是单独的顶级网络搜索提供程序选项
- 可选择在同一流程中设置
x_search模型
跳过它,以便稍后在配置中启用或更改 x_search。
登录或获取 API 密钥¶
提供 Grok 网络搜索的 xai 插件随 OpenClaw 一起提供,因此没有 openclaw plugins install 步骤。从你已有的凭据开始。
1. 使用 xAI OAuth
如果你已在引导或模型身份验证期间使用 xAI 登录,请选择 Grok 作为 web_search 提供程序。无需单独的 API 密钥:
2. 使用 API 密钥回退
当 OAuth 不可用,或你有意想要基于密钥的网络搜索配置时,请从 xAI 获取 API 密钥。
3. 存储密钥
在网关环境中设置 XAI_API_KEY,或通过以下方式配置:
配置¶
{
plugins: {
entries: {
xai: {
config: {
webSearch: {
apiKey: "xai-...", // optional if xAI OAuth or XAI_API_KEY is available
baseUrl: "https://api.x.ai/v1", // optional Responses API proxy/base URL override
},
},
},
},
},
tools: {
web: {
search: {
provider: "grok",
},
},
},
}
凭据替代方案: openclaw models auth login --provider xai
--method oauth、网关环境中的 XAI_API_KEY,或
plugins.entries.xai.config.webSearch.apiKey。对于网关安装,请将环境变量放在 ~/.openclaw/.env 中。
工作原理¶
Grok 使用 xAI 基于网络的响应来合成带有内联引用的答案,类似于 Gemini 的 Google Search 接地方法。
支持的参数¶
Grok 搜索支持 query。count 为共享 web_search 兼容性而被接受,但 Grok 始终返回一个带引用的合成答案,而不是 N 个结果列表。不支持提供程序特定的筛选器。
Grok 默认使用 60 秒超时,因为 xAI Responses 基于网络的搜索可能比共享 web_search 默认值运行更长时间。此预算包括凭据准备、搜索请求和身份验证恢复。使用 tools.web.search.timeoutSeconds 覆盖它。
OAuth 刷新失败仍保持为身份验证错误,而不是报告为缺少 API 密钥。如果刷新无法恢复,请使用 openclaw models auth login --provider xai --method oauth 重新登录;增加搜索超时无法修复不可用的凭据。
Base URL 覆盖¶
设置 plugins.entries.xai.config.webSearch.baseUrl,以通过操作员代理或兼容 xAI 的 Responses 端点路由 Grok 网络搜索。OpenClaw 在去除尾部斜杠后向 <baseUrl>/responses 发送请求。除非设置了 plugins.entries.xai.config.xSearch.baseUrl,否则 x_search 会回退到相同的 webSearch.baseUrl。
相关¶
- 网络搜索概览 -- 所有提供程序和自动检测
- 网络搜索中的 x_search -- 通过 xAI 提供的一等 X 搜索
- Gemini Search -- 通过 Google 接地提供 AI 合成答案
- Kimi search — 由 Moonshot 支持的搜索工具
本页原文 Markdown:在 AtomGit 查看·内容源自开源项目 cl/openclaw