Grok 搜索

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

同一个 xAI API 密钥也可以为内置的 APIx_search 工具（用于 X（前身为 Twitter）帖子搜索）和 code_execution 工具提供支持。如果您将密钥存储在 plugins.entries.xai.config.webSearch.apiKeyOpenClaw 下，OpenClaw 现在也会将其作为捆绑的 xAI 模型提供商的备用方案重用。

对于帖子级别的 X 指标（如转发、回复、书签或浏览量），请优先使用 x_search 并提供确切的帖子 URL 或状态 ID，而不是广泛的搜索查询。

新手引导和配置

如果您在此过程中选择 Grok：

• openclaw onboard
• openclaw configure --section web

OpenClaw 可以显示一个单独的后续步骤，以使用相同的 XAI_API_KEY 启用 x_search。该后续步骤：

• 仅在您为 web_search 选择 Grok 后出现
• 不是一个单独的顶级网络搜索提供商选项
• 可以在同一流程中可选地设置 x_search 模型

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

获取 API 密钥

1. 创建密钥

   从 xAI 获取 API 密钥。

2. 存储密钥

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

   openclaw configure --section web

配置

{
  plugins: {
    entries: {
      xai: {
        config: {
          webSearch: {
            apiKey: "xai-...", // optional if XAI_API_KEY is set
            baseUrl: "https://api.x.ai/v1", // optional Responses API proxy/base URL override
          },
        },
      },
    },
  },
  tools: {
    web: {
      search: {
        provider: "grok",
      },
    },
  },
}

环境替代方案： 在 Gateway(网关) 环境中设置 XAI_API_KEY。 对于网关安装，请将其放入 ~/.openclaw/.env 中。

工作原理

Grok 使用 xAI 网络基础响应来综合包含内联引用的答案，类似于 Gemini 的 Google Search 基础方法。

支持的参数

Grok 搜索支持 query。

为了保持 web_search 兼容性，接受 count，但 Grok 仍然返回一个带引用的综合答案，而不是 N 个结果的列表。

目前不支持特定于提供商的过滤器。

Grok 使用特定于提供商的 60 秒默认超时时间，因为 xAI Responses 的网络基础搜索运行时间可能比共享的 web_search 默认值更长。设置 tools.web.search.timeoutSeconds 以覆盖它。

基础 URL 覆盖

当 Grok 网络搜索需要通过运营商代理或兼容 xAI 的 Responses 端点进行路由时，请设置 plugins.entries.xai.config.webSearch.baseUrlOpenClaw。OpenClaw 会在去除尾部斜杠后向 <baseUrl>/responses 发送请求。除非设置了 plugins.entries.xai.config.xSearch.baseUrl，否则 x_search 使用相同的 webSearch.baseUrl 备用方案。

相关

• 网络搜索概述 — 所有提供商和自动检测
• 网络搜索中的 x_search — 通过 xAI 进行一流的 X 搜索
• Gemini 搜索 — 通过 Google Grounding 生成的 AI 综合答案