快速开始

Grok 搜索

OpenClaw 支持将 Grok 用作 web_search 提供商，通过 xAI 基于网络检索的响应生成由实时搜索结果和引用支持的 AI 综合答案。

Grok Web 搜索会优先使用现有的 xAI OAuth 登录（如果可用）。如果不存在 OAuth 配置文件，同一个 xAI API 密钥还可用于内置的 x_search 工具，以搜索 X（原 Twitter）帖子，以及用于 code_execution 工具。将密钥存储在 plugins.entries.xai.config.webSearch.apiKey 中，还可让 OpenClaw 将其作为内置 xAI 模型提供商的后备密钥重复使用。

如需获取帖子级别的 X 指标（转帖、回复、书签、浏览量），请使用包含确切帖子 URL 或状态 ID 的 x_search，而不是宽泛的搜索查询。

新手引导和配置

在 openclaw onboard 或 openclaw configure --section web 期间选择 Grok，OpenClaw 就能重复使用现有的 xAI OAuth 配置文件，而不会提示输入单独的 Web 搜索密钥。如果没有 OAuth，则会回退到 xAI API 密钥设置。

然后，OpenClaw 会提供一个后续步骤，使用同一份 xAI 凭据启用 x_search。该后续步骤：

仅在你选择 Grok 作为 web_search 提供商后出现
不是单独的顶层 Web 搜索提供商选项
可以选择在同一流程中设置 x_search 模型

你可以跳过此步骤，稍后再在配置中启用或更改 x_search。

登录或获取 API 密钥

使用 xAI OAuth

如果你已在新手引导或模型身份验证期间登录 xAI，请选择 Grok 作为 web_search 提供商。不需要单独的 API 密钥：

bash

openclaw onboard --auth-choice xai-oauthopenclaw config set tools.web.search.provider grok

使用 API 密钥作为后备方式

当 OAuth 不可用，或你有意希望使用基于密钥的 Web 搜索配置时，请从 xAI 获取 API 密钥。

存储密钥

在 Gateway 网关环境中设置 XAI_API_KEY，或通过以下命令进行配置：

bash

openclaw configure --section web

配置

json5

{  plugins: {    entries: {      xai: {        config: {          webSearch: {            apiKey: "xai-...", // 如果 xAI OAuth 或 XAI_API_KEY 可用，则为可选项            baseUrl: "https://api.x.ai/v1", // 可选的 Responses API 代理/基础 URL 覆盖值          },        },      },    },  },  tools: {    web: {      search: {        provider: "grok",      },    },  },}

凭据替代方式：openclaw models auth login --provider xai --method oauth、Gateway 网关环境中的 XAI_API_KEY，或 plugins.entries.xai.config.webSearch.apiKey。对于 Gateway 网关安装，请将环境变量放入 ~/.openclaw/.env。

工作原理

Grok 使用 xAI 基于网络检索的响应来综合生成带有行内引用的答案，类似于 Gemini 的 Google 搜索检索增强方式。

支持的参数

Grok 搜索支持 query。为兼容共享的 web_search，也接受 count，但 Grok 始终返回一个带引用的综合答案，而不是包含 N 条结果的列表。不支持提供商专用筛选条件。

Grok 默认超时时间为 60 秒，因为 xAI Responses 基于网络检索的搜索可能比共享的 web_search 默认超时时间运行得更久。可使用 tools.web.search.timeoutSeconds 覆盖此设置。

基础 URL 覆盖

设置 plugins.entries.xai.config.webSearch.baseUrl，可通过操作员代理或与 xAI 兼容的 Responses 端点路由 Grok Web 搜索。OpenClaw 会先移除末尾的斜杠，再向 <baseUrl>/responses 发送 POST 请求。除非设置了 plugins.entries.xai.config.xSearch.baseUrl，否则 x_search 会回退使用同一个 webSearch.baseUrl。