Поставщики моделей

​

Краткие правила

​

Поведение провайдера, принадлежащее Plugin

​

Ротация API-ключей

​

Официальные Plugin провайдеров

​

OpenAI

• Провайдер: openai
• Аутентификация: OPENAI_API_KEY
• Необязательная ротация: OPENAI_API_KEYS, OPENAI_API_KEY_1, OPENAI_API_KEY_2, плюс OPENCLAW_LIVE_OPENAI_KEY (одиночное переопределение)
• Примеры моделей: openai/gpt-5.5, openai/gpt-5.4-mini
• Проверяйте доступность аккаунта/модели с помощью openclaw models list --provider openai, если конкретная установка или API-ключ ведет себя иначе.
• CLI: openclaw onboard --auth-choice openai-api-key
• Транспорт по умолчанию — auto; OpenClaw передает выбор транспорта в общий runtime модели.
• Переопределение для отдельной модели через agents.defaults.models["openai/<model>"].params.transport ("sse", "websocket" или "auto")
• Приоритетную обработку OpenAI можно включить через agents.defaults.models["openai/<model>"].params.serviceTier
• /fast и params.fastMode сопоставляют прямые запросы Responses openai/* с service_tier=priority на api.openai.com
• Используйте params.serviceTier, когда нужен явный уровень вместо общего переключателя /fast
• Скрытые заголовки атрибуции OpenClaw (originator, version, User-Agent) применяются только к нативному трафику OpenAI на api.openai.com, а не к универсальным OpenAI-совместимым прокси
• Нативные маршруты OpenAI также сохраняют Responses store, подсказки prompt-cache и формирование payload, совместимое с reasoning OpenAI; прокси-маршруты этого не делают
• openai/gpt-5.3-codex-spark доступен через аутентификацию подписки ChatGPT/Codex OAuth, когда ваш вошедший аккаунт его предоставляет; OpenClaw все еще подавляет прямые маршруты OpenAI API-key и Azure API-key для этой модели, потому что эти транспорты ее отклоняют

{
  agents: { defaults: { model: { primary: "openai/gpt-5.5" } } },
}

​

Anthropic

• Провайдер: anthropic
• Аутентификация: ANTHROPIC_API_KEY
• Необязательная ротация: ANTHROPIC_API_KEYS, ANTHROPIC_API_KEY_1, ANTHROPIC_API_KEY_2, плюс OPENCLAW_LIVE_ANTHROPIC_KEY (одиночное переопределение)
• Пример модели: anthropic/claude-opus-4-6
• CLI: openclaw onboard --auth-choice apiKey
• Прямые публичные запросы Anthropic поддерживают общий переключатель /fast и params.fastMode, включая трафик с API-ключом и OAuth-аутентификацией, отправленный на api.anthropic.com; OpenClaw сопоставляет это с Anthropic service_tier (auto против standard_only)
• Предпочтительная конфигурация Claude CLI сохраняет ссылку на модель канонической и выбирает CLI backend отдельно: anthropic/claude-opus-4-8 с agentRuntime.id: "claude-cli" в области модели. Устаревшие ссылки claude-cli/claude-opus-4-7 все еще работают для совместимости.

{
  agents: { defaults: { model: { primary: "anthropic/claude-opus-4-6" } } },
}

​

OpenAI ChatGPT/Codex OAuth

• Провайдер: openai
• Аутентификация: OAuth (ChatGPT)
• Устаревшая ссылка на модель OpenAI Codex: openai/gpt-5.5
• Ссылка нативного harness сервера приложений Codex: openai/gpt-5.5
• Документация нативного harness сервера приложений Codex: harness Codex
• Устаревшие ссылки на модели: codex/gpt-*
• Граница Plugin: openai/* загружает Plugin OpenAI; нативный Plugin сервера приложений Codex выбирается runtime harness Codex.
• CLI: openclaw onboard --auth-choice openai или openclaw models auth login --provider openai
• Транспорт по умолчанию — auto (сначала WebSocket, fallback на SSE)
• Переопределение для отдельной модели OpenAI Codex через agents.defaults.models["openai/<model>"].params.transport ("sse", "websocket" или "auto")
• params.serviceTier также передается в нативных запросах Codex Responses (chatgpt.com/backend-api)
• Скрытые заголовки атрибуции OpenClaw (originator, version, User-Agent) добавляются только к нативному трафику Codex на chatgpt.com/backend-api, а не к универсальным OpenAI-совместимым прокси
• Использует тот же переключатель /fast и конфигурацию params.fastMode, что и прямой openai/*; OpenClaw сопоставляет это с service_tier=priority
• openai/gpt-5.5 использует нативные значения каталога Codex contextWindow = 400000 и runtime по умолчанию contextTokens = 272000; переопределите ограничение runtime через models.providers.openai.models[].contextTokens
• Примечание о политике: OpenAI Codex OAuth явно поддерживается для внешних инструментов/рабочих процессов вроде OpenClaw.
• Для обычного маршрута подписка плюс нативный runtime Codex войдите через аутентификацию openai и настройте openai/gpt-5.5; ходы агента OpenAI по умолчанию выбирают Codex.
• Используйте agentRuntime.id: "openclaw" на уровне провайдера/модели только когда нужен встроенный маршрут OpenClaw; иначе оставьте openai/gpt-5.5 на harness Codex по умолчанию.
• устаревшие ссылки Codex GPT являются устаревшим состоянием, а не live-маршрутом провайдера. Используйте openai/gpt-5.5 на нативном runtime Codex для новой конфигурации агента и запустите openclaw doctor --fix, чтобы мигрировать старые устаревшие ссылки на модели Codex в канонические ссылки openai/*.

{
  plugins: { entries: { codex: { enabled: true } } },
  agents: {
    defaults: {
      model: { primary: "openai/gpt-5.5" },
    },
  },
}

{
  models: {
    providers: {
      openai: {
        models: [{ id: "gpt-5.5", contextTokens: 160000 }],
      },
    },
  },
}

​

Другие размещенные варианты в стиле подписки

​

OpenCode

• Аутентификация: OPENCODE_API_KEY (или OPENCODE_ZEN_API_KEY)
• Провайдер Zen runtime: opencode
• Провайдер Go runtime: opencode-go
• Примеры моделей: opencode/claude-opus-4-6, opencode-go/kimi-k2.6
• CLI: openclaw onboard --auth-choice opencode-zen или openclaw onboard --auth-choice opencode-go

{
  agents: { defaults: { model: { primary: "opencode/claude-opus-4-6" } } },
}

​

Google Gemini (API-ключ)

• Провайдер: google
• Аутентификация: GEMINI_API_KEY
• Необязательная ротация: GEMINI_API_KEYS, GEMINI_API_KEY_1, GEMINI_API_KEY_2, резервный GOOGLE_API_KEY и OPENCLAW_LIVE_GEMINI_KEY (одиночное переопределение)
• Примеры моделей: google/gemini-3.1-pro-preview, google/gemini-3-flash-preview
• Совместимость: устаревшая конфигурация OpenClaw, использующая google/gemini-3.1-flash-preview, нормализуется в google/gemini-3-flash-preview
• Псевдоним: google/gemini-3.1-pro принимается и нормализуется в актуальный идентификатор Google Gemini API, google/gemini-3.1-pro-preview
• CLI: openclaw onboard --auth-choice gemini-api-key
• Мышление: /think adaptive использует динамическое мышление Google. Gemini 3/3.1 не указывают фиксированный thinkingLevel; Gemini 2.5 отправляет thinkingBudget: -1.
• Прямые запуски Gemini также принимают agents.defaults.models["google/<model>"].params.cachedContent (или устаревшее cached_content) для передачи собственного для провайдера дескриптора cachedContents/...; попадания в кэш Gemini отображаются как OpenClaw cacheRead

​

Google Vertex и Gemini CLI

• Провайдеры: google-vertex, google-gemini-cli
• Аутентификация: Vertex использует gcloud ADC; Gemini CLI использует свой OAuth-поток

brew install gemini-cli

npm install -g @google/gemini-cli

openclaw plugins enable google

openclaw models auth login --provider google-gemini-cli --set-default

​

Z.AI (GLM)

• Провайдер: zai
• Аутентификация: ZAI_API_KEY
• Пример модели: zai/glm-5.2
• CLI: openclaw onboard --auth-choice zai-api-key
  • Ссылки на модели используют канонический идентификатор провайдера zai/*.
  • zai-api-key автоматически определяет соответствующий эндпоинт Z.AI; zai-coding-global, zai-coding-cn, zai-global и zai-cn принудительно выбирают конкретную поверхность

​

Vercel AI Gateway

• Провайдер: vercel-ai-gateway
• Аутентификация: AI_GATEWAY_API_KEY
• Примеры моделей: vercel-ai-gateway/anthropic/claude-opus-4.6, vercel-ai-gateway/moonshotai/kimi-k2.6
• CLI: openclaw onboard --auth-choice ai-gateway-api-key

​

Другие встроенные Plugin провайдеров

​

Особенности, о которых стоит знать

​

Провайдеры через models.providers (пользовательский/base URL)

​

Moonshot AI (Kimi)

• Провайдер: moonshot
• Аутентификация: MOONSHOT_API_KEY
• Пример модели: moonshot/kimi-k2.6
• CLI: openclaw onboard --auth-choice moonshot-api-key или openclaw onboard --auth-choice moonshot-api-key-cn

• moonshot/kimi-k2.6
• moonshot/kimi-k2.7-code
• moonshot/kimi-k2.5
• moonshot/kimi-k2-thinking
• moonshot/kimi-k2-thinking-turbo
• moonshot/kimi-k2-turbo

{
  agents: {
    defaults: { model: { primary: "moonshot/kimi-k2.6" } },
  },
  models: {
    mode: "merge",
    providers: {
      moonshot: {
        baseUrl: "https://api.moonshot.ai/v1",
        apiKey: "${MOONSHOT_API_KEY}",
        api: "openai-completions",
        models: [{ id: "kimi-k2.6", name: "Kimi K2.6" }],
      },
    },
  },
}

​

Kimi для кодинга

• Провайдер: kimi
• Аутентификация: KIMI_API_KEY
• Пример модели: kimi/kimi-for-coding

{
  env: { KIMI_API_KEY: "sk-..." },
  agents: {
    defaults: { model: { primary: "kimi/kimi-for-coding" } },
  },
}

​

Volcano Engine (Doubao)

• Провайдер: volcengine (кодинг: volcengine-plan)
• Аутентификация: VOLCANO_ENGINE_API_KEY
• Пример модели: volcengine-plan/ark-code-latest
• CLI: openclaw onboard --auth-choice volcengine-api-key

{
  agents: {
    defaults: { model: { primary: "volcengine-plan/ark-code-latest" } },
  },
}

​

BytePlus (международный)

• Поставщик: byteplus (кодинг: byteplus-plan)
• Аутентификация: BYTEPLUS_API_KEY
• Пример модели: byteplus-plan/ark-code-latest
• CLI: openclaw onboard --auth-choice byteplus-api-key

{
  agents: {
    defaults: { model: { primary: "byteplus-plan/ark-code-latest" } },
  },
}

​

Synthetic

• Поставщик: synthetic
• Аутентификация: SYNTHETIC_API_KEY
• Пример модели: synthetic/hf:MiniMaxAI/MiniMax-M2.5
• CLI: openclaw onboard --auth-choice synthetic-api-key

{
  agents: {
    defaults: { model: { primary: "synthetic/hf:MiniMaxAI/MiniMax-M2.5" } },
  },
  models: {
    mode: "merge",
    providers: {
      synthetic: {
        baseUrl: "https://api.synthetic.new/anthropic",
        apiKey: "${SYNTHETIC_API_KEY}",
        api: "anthropic-messages",
        models: [{ id: "hf:MiniMaxAI/MiniMax-M2.5", name: "MiniMax M2.5" }],
      },
    },
  },
}

​

MiniMax

• MiniMax OAuth (глобальный): --auth-choice minimax-global-oauth
• MiniMax OAuth (Китай): --auth-choice minimax-cn-oauth
• API-ключ MiniMax (глобальный): --auth-choice minimax-global-api
• API-ключ MiniMax (Китай): --auth-choice minimax-cn-api
• Аутентификация: MINIMAX_API_KEY для minimax; MINIMAX_OAUTH_TOKEN или MINIMAX_API_KEY для minimax-portal

• Значения по умолчанию для текста/чата остаются на minimax/MiniMax-M3
• Генерация изображений — minimax/image-01 или minimax-portal/image-01
• Понимание изображений — принадлежащая Plugin модель MiniMax-VL-01 на обоих путях аутентификации MiniMax
• Веб-поиск остается на идентификаторе поставщика minimax

​

LM Studio

• Поставщик: lmstudio
• Аутентификация: LM_API_TOKEN
• Базовый URL вывода по умолчанию: http://localhost:1234/v1

{
  agents: {
    defaults: { model: { primary: "lmstudio/openai/gpt-oss-20b" } },
  },
}

​

Ollama

• Поставщик: ollama
• Аутентификация: не требуется (локальный сервер)
• Пример модели: ollama/llama3.3
• Установка: https://ollama.com/download

# Install Ollama, then pull a model:
ollama pull llama3.3

{
  agents: {
    defaults: { model: { primary: "ollama/llama3.3" } },
  },
}

​

vLLM

• Поставщик: vllm
• Аутентификация: необязательно (зависит от вашего сервера)
• Базовый URL по умолчанию: http://127.0.0.1:8000/v1

export VLLM_API_KEY="vllm-local"

{
  agents: {
    defaults: { model: { primary: "vllm/your-model-id" } },
  },
}

​

SGLang

• Поставщик: sglang
• Аутентификация: необязательно (зависит от вашего сервера)
• Базовый URL по умолчанию: http://127.0.0.1:30000/v1

export SGLANG_API_KEY="sglang-local"

{
  agents: {
    defaults: { model: { primary: "sglang/your-model-id" } },
  },
}

​

Локальные прокси (LM Studio, vLLM, LiteLLM и т. д.)

{
  agents: {
    defaults: {
      model: { primary: "lmstudio/my-local-model" },
      models: { "lmstudio/my-local-model": { alias: "Local" } },
    },
  },
  models: {
    providers: {
      lmstudio: {
        baseUrl: "http://localhost:1234/v1",
        apiKey: "${LM_API_TOKEN}",
        api: "openai-completions",
        timeoutSeconds: 300,
        models: [
          {
            id: "my-local-model",
            name: "Local Model",
            reasoning: false,
            input: ["text"],
            cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 },
            contextWindow: 200000,
            maxTokens: 8192,
          },
        ],
      },
    },
  },
}

​

Примеры CLI

openclaw onboard --auth-choice opencode-zen
openclaw models set opencode/claude-opus-4-6
openclaw models list

​

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

• Справочник по конфигурации - ключи конфигурации моделей
• Отказоустойчивое переключение моделей - цепочки fallback и поведение повторных попыток
• Модели - конфигурация моделей и псевдонимы
• Поставщики - руководства по настройке для каждого поставщика