Grok 在 OpenClaw 中通过 xAI 网络搜索 grounding 提供带引用来源的 AI 合成答案，支持 OAuth 登录或 API Key 两种认证方式。配置时可直接选择 OAuth 登录，或设置 XAI_API_KEY 环境变量并在 tools.web.search.provider 设为 grok。注意：每次搜索始终返回单条合成答案而非结果列表，count 参数仅保留语法兼容性，超时默认为 60 秒。如需自定义 API 地址，可配置 plugins.entries.xai.config.webSearch.baseUrl。

OpenClaw 配置 Grok 搜索：xAI 联网搜索与 OAuth 集成

OpenClaw 支持将 Grok 用作 web_search 提供商，利用 xAI 的 web-grounded responses 技术生成带内联引用来源的 AI 合成答案，并基于实时搜索结果。Grok 搜索优先使用已有的 xAI OAuth 登录信息；若没有 OAuth 配置，相同的 xAI API key 也可用于内置的 x_search 工具（搜索 X 平台帖子）以及 code_execution 工具。如果将 key 存储在 plugins.entries.xai.config.webSearch.apiKey 中，OpenClaw 还会将其作为 xAI 模型提供商的回退密钥。

若要获取单条 X 帖子的转发、回复、收藏、阅读量等指标，建议使用 x_search 并指定精确的帖子 URL 或状态 ID，而不是用 Grok 搜索。

注册与配置

在 openclaw onboard 或 openclaw configure --section web 过程中，如果选择 Grok，OpenClaw 会优先使用已有的 xAI OAuth 配置，无需额外输入 web-search key。若 OAuth 不可用，则回退到 xAI API key 设置流程。同时，OpenClaw 会提供一个后续步骤，让你选择是否使用相同的 xAI 凭证启用 x_search。该后续步骤：

只在你选择 Grok 作为 web_search 提供商后出现；
不是独立的 web-search 提供商选择；
可以在同一流程中可选设置 x_search 模型。

如果跳过了该步骤，后续可以在配置中随时启用或修改 x_search。

登录或获取 API Key

使用 xAI OAuth

如果你在注册或模型认证时已经用 xAI 登录，直接选择 Grok 作为 `web_search` 提供商即可，无需单独申请 API key：

```bash
openclaw onboard --auth-choice xai-oauth
openclaw config set tools.web.search.provider grok
```

使用 API Key 回退

当 OAuth 不可用，或者你希望使用 key 方式配置 web-search 时，从 [xAI 控制台](https://console.x.ai/) 获取 API key。

存储密钥

在 Gateway 环境中设置 `XAI_API_KEY`，或通过以下命令配置：

```bash
openclaw configure --section web
```

配置

{
  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 的 web-grounded responses 技术合成答案，并在答案中包含内联引用来源，与 Gemini 的 Google Search grounding 方式类似。

支持的参数

Grok 搜索支持 query 参数。

count 参数被接受，仅用于保持与通用 web_search 接口的兼容性。但 Grok 始终返回一条合成答案（带引用），而不是 N 条结果列表。

目前不支持特定于提供商的筛选器。

Grok 使用提供商专属的 60 秒默认超时，因为 xAI Responses 的 web-grounded 搜索可能比通用 web_search 默认超时更长。可通过 tools.web.search.timeoutSeconds 覆盖此值。

Base URL 覆盖

当 Grok 搜索需要经过运营商代理或 xAI 兼容的 Responses 端点时，设置 plugins.entries.xai.config.webSearch.baseUrl。OpenClaw 会去除末尾的斜杠，然后向 <baseUrl>/responses 发送请求。x_search 在没有单独设置 plugins.entries.xai.config.xSearch.baseUrl 时，也会使用同样的 webSearch.baseUrl 作为回退。

常见问题

怎么在 OpenClaw 中用 Grok 做联网搜索？

在 openclaw onboard 时选择 Grok 作为 web_search 提供商，或者手动运行 openclaw config set tools.web.search.provider grok。认证方式可以是已有的 xAI OAuth 登录，或设置 XAI_API_KEY 环境变量，或写入 plugins.entries.xai.config.webSearch.apiKey。之后智能体就可以通过 web_search 工具使用 Grok 搜索。

Grok 搜索支持返回多个结果吗？

不支持。Grok 始终返回一条 AI 合成的答案（带引用来源），而不是结果列表。虽然 count 参数可以被接收，但它不会改变返回格式。

如何更改 Grok 搜索的超时时间？

通过 tools.web.search.timeoutSeconds 配置项覆盖默认的 60 秒超时。例如，openclaw config set tools.web.search.timeoutSeconds 120。

OpenClaw 配置 Grok 搜索：xAI 联网搜索与 OAuth 集成 #

注册与配置 #

登录或获取 API Key #

配置 #

工作原理 #

支持的参数 #

Base URL 覆盖 #

相关文档 #

常见问题 #

怎么在 OpenClaw 中用 Grok 做联网搜索？ #

Grok 搜索支持返回多个结果吗？ #

如何更改 Grok 搜索的超时时间？ #