OpenClawDocs
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this page

Providers

Z.AI

Z.AI — это API-платформа для моделей GLM. Она предоставляет REST API для GLM и использует API-ключи для аутентификации. Создайте API-ключ в консоли Z.AI. OpenClaw использует провайдер zai с API-ключом Z.AI.

Свойство Значение
Провайдер zai
Пакет @openclaw/zai-provider
Аутентификация ZAI_API_KEY (устаревший псевдоним: Z_AI_API_KEY)
API Z.AI Chat Completions (аутентификация Bearer)

Модели GLM

GLM — это семейство моделей, а не отдельный провайдер. В OpenClaw модели GLM используют ссылки вида zai/glm-5.2: провайдер zai, идентификатор модели glm-5.2.

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

Сначала установите плагин провайдера:

bash
openclaw plugins install @openclaw/zai-provider

Автоматическое определение конечной точки

Лучше всего подходит: большинству пользователей. OpenClaw проверяет поддерживаемые конечные точки Z.AI с вашим API-ключом и автоматически применяет правильный базовый URL.

  • Запустите первоначальную настройку

    bash
    openclaw onboard --auth-choice zai-api-key

  • Убедитесь, что модель присутствует в списке

    bash
    openclaw models list --all --provider zai

    • Явно заданная региональная конечная точка

    Лучше всего подходит: пользователям, которым требуется принудительно выбрать определённый Coding Plan или общий API.

  • Выберите подходящий вариант первоначальной настройки

    bash
    # Глобальный Coding Plan (рекомендуется пользователям Coding Plan)openclaw onboard --auth-choice zai-coding-global # Coding Plan CN (регион Китай)openclaw onboard --auth-choice zai-coding-cn # Общий APIopenclaw onboard --auth-choice zai-global # Общий API CN (регион Китай)openclaw onboard --auth-choice zai-cn

  • Убедитесь, что модель присутствует в списке

    bash
    openclaw models list --all --provider zai

    • Конечные точки

    Вариант первоначальной настройки Базовый URL Модель по умолчанию
    zai-global https://api.z.ai/api/paas/v4 glm-5.1
    zai-cn https://open.bigmodel.cn/api/paas/v4 glm-5.1
    zai-coding-global https://api.z.ai/api/coding/paas/v4 glm-5.2
    zai-coding-cn https://open.bigmodel.cn/api/coding/paas/v4 glm-5.2

    zai-api-key автоматически определяет одну из этих четырёх конечных точек, проверяя ваш ключ через API завершения чата каждой конечной точки: сначала проверяются общие конечные точки (zai-global, затем zai-cn), а после них — конечные точки Coding Plan (zai-coding-global, затем zai-coding-cn). Проверка останавливается на первой конечной точке, которая принимает запрос. Используйте явно заданный --auth-choice, чтобы принудительно выбрать конечную точку Coding Plan, если ваш ключ работает с обоими типами.

    Пример конфигурации

    json5
    {  env: { ZAI_API_KEY: "sk-..." },  models: {    providers: {      zai: {        // GLM-5.2 использует конечную точку Coding Plan.        baseUrl: "https://api.z.ai/api/coding/paas/v4",      },    },  },  agents: { defaults: { model: { primary: "zai/glm-5.2" } } },}

    Встроенный каталог

    Плагин провайдера zai поставляет свой каталог в манифесте плагина, поэтому при выводе списка в режиме только для чтения можно показывать известные строки GLM без загрузки среды выполнения провайдера:

    bash
    openclaw models list --all --provider zai

    В каталог на основе манифеста сейчас входят:

    Ссылка на модель Примечания
    zai/glm-5.2 Модель Coding Plan по умолчанию; контекст 1M
    zai/glm-5.1 Модель общего API по умолчанию
    zai/glm-5
    zai/glm-5-turbo
    zai/glm-5v-turbo
    zai/glm-4.7
    zai/glm-4.7-flash
    zai/glm-4.7-flashx
    zai/glm-4.6
    zai/glm-4.6v
    zai/glm-4.5
    zai/glm-4.5-air
    zai/glm-4.5-flash
    zai/glm-4.5v

    Уровни рассуждений

    GLM-5.2

    Полный диапазон: off, low, high, max (по умолчанию off). OpenClaw сопоставляет low и high с уровнем интенсивности рассуждений Z.AI high, а max — с уровнем max Z.AI через reasoning_effort в полезной нагрузке запроса.

    Другие модели GLM

    Только двоичный переключатель: off и low (в средствах выбора отображаются как on), по умолчанию off. Если для рассуждений задано значение off, отправляется thinking: { type: "disabled" }; при любом другом уровне полезная нагрузка запроса остаётся без изменений (применяется собственное поведение рассуждений Z.AI по умолчанию).

    Установка уровня рассуждений в off предотвращает ответы, которые расходуют бюджет вывода на reasoning_content до появления видимого текста.

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

    Предварительное разрешение неизвестных моделей GLM-5

    Неизвестные идентификаторы glm-5* по-прежнему предварительно разрешаются на пути провайдера путём создания принадлежащих провайдеру метаданных из шаблона glm-4.7, если идентификатор соответствует текущему формату семейства GLM-5.

    Потоковая передача вызовов инструментов

    tool_stream по умолчанию включён для потоковой передачи вызовов инструментов Z.AI. Чтобы отключить его:

    json5
    {  agents: {    defaults: {      models: {        "zai/<model>": {          params: { tool_stream: false },        },      },    },  },}
    Сохранённые рассуждения

    Сохранение рассуждений включается явно, поскольку Z.AI требует повторной передачи полной исторической последовательности reasoning_content, что увеличивает число токенов запроса. Включите эту функцию отдельно для каждой модели:

    json5
    {  agents: {    defaults: {      models: {        "zai/glm-5.2": {          params: { preserveThinking: true },        },      },    },  },}

    Когда функция включена и рассуждения активны, OpenClaw отправляет thinking: { type: "enabled", clear_thinking: false } и повторно передаёт предыдущие reasoning_content для того же OpenAI-совместимого транскрипта. Ключ параметра в формате snake_case preserve_thinking работает как псевдоним.

    Опытные пользователи по-прежнему могут переопределить точную полезную нагрузку провайдера с помощью params.extra_body.thinking.

    Распознавание изображений

    Плагин Z.AI регистрирует функцию распознавания изображений.

    Свойство Значение
    Модель glm-4.6v

    Распознавание изображений автоматически определяется на основе настроенной аутентификации Z.AI — дополнительная конфигурация не требуется.

    Сведения об аутентификации
    • Z.AI использует аутентификацию Bearer с вашим API-ключом.
    • Вариант первоначальной настройки zai-api-key автоматически определяет подходящую конечную точку Z.AI, проверяя поддерживаемые конечные точки с вашим ключом.
    • Используйте явно заданные региональные варианты (zai-coding-global, zai-coding-cn, zai-global, zai-cn), если требуется принудительно выбрать определённый API.
    • Устаревшая переменная среды Z_AI_API_KEY по-прежнему поддерживается; OpenClaw копирует её в ZAI_API_KEY при запуске, если ZAI_API_KEY не задана.

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

    Выбор модели

    Выбор провайдеров, ссылок на модели и поведения при переключении после сбоя.
    Справочник по конфигурации

    Полная схема конфигурации OpenClaw, включая настройки провайдеров и моделей.
    Was this useful?
    On this page

    On this page