> ## Documentation Index
> Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Поиск Grok

OpenClaw поддерживает Grok как провайдера `web_search`, используя ответы xAI с веб-поиском
для формирования синтезированных ИИ ответов на основе актуальных результатов поиска
с указанием источников.

Веб-поиск Grok предпочитает использовать существующий вход через xAI OAuth, если он доступен.
Если профиля OAuth нет, тот же ключ API xAI также обеспечивает работу встроенного
инструмента `x_search` для поиска публикаций в X (ранее Twitter) и инструмента `code_execution`.
Хранение ключа в `plugins.entries.xai.config.webSearch.apiKey` также
позволяет OpenClaw использовать его как резервный вариант для встроенного провайдера моделей xAI.

Для получения метрик отдельных публикаций X (репостов, ответов, закладок, просмотров) используйте
[`x_search`](https://docs2.openclaw.ai/ru/tools/web#x_search) с точным URL публикации или идентификатором статуса
вместо широкого поискового запроса.

## Первоначальная настройка и конфигурирование

Выбор **Grok** во время `openclaw onboard` или `openclaw configure --section
web` позволяет OpenClaw повторно использовать существующий профиль xAI OAuth без запроса
отдельного ключа для веб-поиска. При отсутствии OAuth используется настройка ключа API xAI.

Затем OpenClaw предлагает дополнительный шаг для включения `x_search` с теми же учётными
данными xAI. Этот дополнительный шаг:

* отображается только после выбора Grok для `web_search`
* не является отдельным вариантом провайдера веб-поиска верхнего уровня
* может при необходимости задать модель `x_search` в рамках того же процесса

Пропустите его, чтобы включить или изменить `x_search` позже в конфигурации.

## Вход или получение ключа API

**1. Использование xAI OAuth**

Если вы уже вошли в xAI во время первоначальной настройки или аутентификации модели, выберите
Grok в качестве провайдера `web_search`. Отдельный ключ API не требуется:

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw onboard --auth-choice xai-oauth
openclaw config set tools.web.search.provider grok
```

**2. Использование резервного ключа API**

Получите ключ API в [xAI](https://console.x.ai/), если OAuth недоступен
или вы намеренно хотите настроить веб-поиск с использованием ключа.

**3. Сохранение ключа**

Задайте `XAI_API_KEY` в окружении Gateway или выполните настройку с помощью:

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw configure --section web
```

## Конфигурация

```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
{
  plugins: {
    entries: {
      xai: {
        config: {
          webSearch: {
            apiKey: "xai-...", // необязательно, если доступен xAI OAuth или XAI_API_KEY
            baseUrl: "https://api.x.ai/v1", // необязательное переопределение прокси или базового URL Responses API
          },
        },
      },
    },
  },
  tools: {
    web: {
      search: {
        provider: "grok",
      },
    },
  },
}
```

**Альтернативные варианты учётных данных:** `openclaw models auth login --provider xai --method oauth`, `XAI_API_KEY` в окружении Gateway или
`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`.

## Переопределение базового URL

Задайте `plugins.entries.xai.config.webSearch.baseUrl`, чтобы направить веб-поиск Grok
через прокси оператора или совместимую с xAI конечную точку Responses. OpenClaw
отправляет POST-запросы в `<baseUrl>/responses` после удаления завершающих косых черт. `x_search`
использует в качестве резервного варианта тот же `webSearch.baseUrl`, если
не задан `plugins.entries.xai.config.xSearch.baseUrl`.

## Связанные материалы

* [Обзор веб-поиска](https://docs2.openclaw.ai/ru/tools/web.md) -- все провайдеры и автоматическое обнаружение
* [x\_search в веб-поиске](https://docs2.openclaw.ai/ru/tools/web.md#x_search) -- полноценный поиск в X через xAI
* [Поиск Gemini](https://docs2.openclaw.ai/ru/tools/gemini-search.md) -- синтезированные ИИ ответы с привязкой к Google