跳转至

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 密钥：

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

2. 使用 API 密钥回退

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

3. 存储密钥

在 Gateway 环境中设置 XAI_API_KEY，或通过以下方式配置：

openclaw configure --section web

配置

{
  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、Gateway 环境中的 XAI_API_KEY，或 plugins.entries.xai.config.webSearch.apiKey。对于 Gateway 安装，请将环境变量放在 ~/.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，以将 Grok 网页搜索路由到操作员代理或兼容 xAI 的 Responses 端点。OpenClaw 会在去除末尾斜杠后向 <baseUrl>/responses 发送 POST 请求。除非设置了 plugins.entries.xai.config.xSearch.baseUrl，否则 x_search 会回退到相同的 webSearch.baseUrl。

本页原文 Markdown：在 AtomGit 查看·内容源自开源项目 cl/openclaw