> ## 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.

# Vercel AI Gateway

[Vercel AI Gateway](https://vercel.com/ai-gateway) предоставляет единый API для
доступа к сотням моделей через одну конечную точку.

| Свойство        | Значение                                        |
| --------------- | ----------------------------------------------- |
| Поставщик       | `vercel-ai-gateway`                             |
| Пакет           | `@openclaw/vercel-ai-gateway-provider`          |
| Аутентификация  | `AI_GATEWAY_API_KEY`                            |
| API             | Совместим с Anthropic Messages                  |
| Каталог моделей | Автоматически обнаруживается через `/v1/models` |

<Tip>
  OpenClaw автоматически обнаруживает каталог Gateway `/v1/models`, поэтому
  `/models vercel-ai-gateway` включает текущие ссылки на модели, такие как
  `vercel-ai-gateway/openai/gpt-5.5` и
  `vercel-ai-gateway/moonshotai/kimi-k2.6`.
</Tip>

## Начало работы

<Steps>
  <Step title="Установите Plugin">
    ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
    openclaw plugins install @openclaw/vercel-ai-gateway-provider
    ```
  </Step>

  <Step title="Задайте ключ API">
    Запустите первичную настройку и выберите вариант аутентификации AI Gateway:

    ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
    openclaw onboard --auth-choice ai-gateway-api-key
    ```
  </Step>

  <Step title="Задайте модель по умолчанию">
    Добавьте модель в конфигурацию OpenClaw:

    ```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
    {
      agents: {
        defaults: {
          model: { primary: "vercel-ai-gateway/anthropic/claude-opus-4.6" },
        },
      },
    }
    ```
  </Step>

  <Step title="Проверьте, что модель доступна">
    ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
    openclaw models list --provider vercel-ai-gateway
    ```
  </Step>
</Steps>

## Неинтерактивный пример

Для сценариев или настроек CI передайте все значения в командной строке:

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw onboard --non-interactive \
  --mode local \
  --auth-choice ai-gateway-api-key \
  --ai-gateway-api-key "$AI_GATEWAY_API_KEY"
```

## Сокращенная запись ID модели

OpenClaw принимает сокращенные ссылки на модели Vercel Claude и нормализует их
во время выполнения:

| Сокращенный ввод                    | Нормализованная ссылка на модель              |
| ----------------------------------- | --------------------------------------------- |
| `vercel-ai-gateway/claude-opus-4.6` | `vercel-ai-gateway/anthropic/claude-opus-4.6` |
| `vercel-ai-gateway/opus-4.6`        | `vercel-ai-gateway/anthropic/claude-opus-4-6` |

<Tip>
  В конфигурации можно использовать как сокращенную, так и полную ссылку на
  модель. OpenClaw автоматически разрешает каноническую форму.
</Tip>

## Расширенная конфигурация

<AccordionGroup>
  <Accordion title="Переменная окружения для фоновых процессов">
    Если OpenClaw Gateway работает как фоновый процесс (launchd/systemd),
    убедитесь, что `AI_GATEWAY_API_KEY` доступен этому процессу.

    <Warning>
      Ключ, экспортированный только в интерактивной оболочке, не будет виден
      фоновому процессу launchd/systemd, если это окружение не импортировано явно.
      Задайте ключ в `~/.openclaw/.env` или через `env.shellEnv`, чтобы процесс
      Gateway мог его прочитать.
    </Warning>
  </Accordion>

  <Accordion title="Маршрутизация поставщика">
    Vercel AI Gateway направляет запросы вышестоящему поставщику на основе
    префикса ссылки на модель. Например,
    `vercel-ai-gateway/anthropic/claude-opus-4.6` направляется через Anthropic,
    а `vercel-ai-gateway/openai/gpt-5.5` направляется через OpenAI и
    `vercel-ai-gateway/moonshotai/kimi-k2.6` направляется через MoonshotAI.
    Единый `AI_GATEWAY_API_KEY` обрабатывает аутентификацию для всех
    вышестоящих поставщиков.
  </Accordion>

  <Accordion title="Уровни Thinking">
    Параметры `/think` следуют доверенным префиксам вышестоящих моделей, когда
    OpenClaw знает контракт вышестоящего поставщика. `vercel-ai-gateway/anthropic/...`
    использует профиль thinking Claude, включая адаптивные значения по умолчанию
    для моделей Claude 4.6. `vercel-ai-gateway/openai/gpt-5.4`, `gpt-5.5` и ссылки
    в стиле Codex предоставляют `/think xhigh` так же, как прямые поставщики
    OpenAI/OpenAI Codex. Другие ссылки с пространствами имен сохраняют обычные
    уровни рассуждения, если их метаданные каталога не объявляют больше.
  </Accordion>
</AccordionGroup>

## См. также

<CardGroup cols={2}>
  <Card title="Выбор модели" href="/ru/concepts/model-providers" icon="layers">
    Выбор поставщиков, ссылок на модели и поведения при отказе.
  </Card>

  <Card title="Устранение неполадок" href="/ru/help/troubleshooting" icon="wrench">
    Общее устранение неполадок и часто задаваемые вопросы.
  </Card>
</CardGroup>