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

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

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

> [!TIP]
>
> OpenClaw автоматически обнаруживает каталог Gateway `/v1/models`, поэтому и
> команда чата `/models vercel-ai-gateway`, и
> `openclaw models list --provider vercel-ai-gateway` содержат актуальные
> ссылки на модели, такие как `vercel-ai-gateway/openai/gpt-5.5` и
> `vercel-ai-gateway/moonshotai/kimi-k2.6`.

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

**1. Установите плагин**

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw plugins install @openclaw/vercel-ai-gateway-provider
```

**2. Задайте ключ API**

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

**3. Задайте модель по умолчанию**

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

**4. Убедитесь, что модель доступна**

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw models list --provider vercel-ai-gateway
```

## Пример неинтерактивного запуска

```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"
```

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

OpenClaw нормализует сокращённые ссылки на модели 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 автоматически определяет
> каноническую ссылку `anthropic/...`.

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

> [accordion] Переменная окружения для процессов-демонов
>
> Если Gateway OpenClaw работает как демон (launchd/systemd), убедитесь, что
> `AI_GATEWAY_API_KEY` доступна этому процессу.
>
> > [!WARNING]
> >
> > Ключ, экспортированный только в интерактивной оболочке, не будет виден
> > демону launchd/systemd, если это окружение не импортировано явно. Задайте
> > ключ в `~/.openclaw/.env` или через `env.shellEnv`, чтобы процесс Gateway
> > мог его прочитать.

> [accordion] Маршрутизация провайдеров
>
> 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] Уровни рассуждения
>
> Параметры `/think` соответствуют префиксу вышестоящей модели, если OpenClaw его
> распознаёт. `vercel-ai-gateway/anthropic/...` использует профиль рассуждений Claude,
> включая адаптивное значение по умолчанию для моделей Claude 4.6. Доверенные
> ссылки `vercel-ai-gateway/openai/...` (`gpt-5.2` и новее, а также варианты Codex
> вплоть до `gpt-5.1-codex`) предоставляют `/think xhigh`. Другие ссылки
> с пространством имён сохраняют стандартные уровни рассуждений, если только
> метаданные их каталога не объявляют дополнительные.

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

> [card] [Выбор модели](https://docs2.openclaw.ai/ru/concepts/model-providers.md)
>
> Выбор провайдеров, ссылок на модели и поведения при переключении после сбоя.

> [card] [Устранение неполадок](https://docs2.openclaw.ai/ru/help/troubleshooting.md)
>
> Общие рекомендации по устранению неполадок и часто задаваемые вопросы.