Перейти к основному содержанию
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)
APIChat Completions Z.AI (аутентификация Bearer)

​
Модели GLM

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

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

Сначала установите Plugin провайдера: 
openclaw plugins install @openclaw/zai-provider
Лучше всего подходит для: большинства пользователей. OpenClaw проверяет поддерживаемые конечные точки Z.AI с вашим ключом API и автоматически применяет правильный базовый URL.
1

Запустите онбординг

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

Проверьте, что модель есть в списке

openclaw models list --all --provider zai

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

zai-api-key позволяет OpenClaw определить соответствующую конечную точку Z.AI по ключу и автоматически применить правильный базовый URL. Используйте явные региональные варианты, когда хотите принудительно выбрать конкретный Coding Plan или общий интерфейс API.
{
  env: { ZAI_API_KEY: "sk-..." },
  models: {
    providers: {
      zai: {
        // GLM-5.2 uses the Coding Plan endpoint.
        baseUrl: "https://api.z.ai/api/coding/paas/v4",
      },
    },
  },
  agents: { defaults: { model: { primary: "zai/glm-5.2" } } },
}

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

Plugin провайдера zai поставляет свой каталог в манифесте Plugin, поэтому список для чтения может показывать известные строки GLM без загрузки среды выполнения провайдера: 
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 доступны как zai/<model> (пример: zai/glm-5).
GLM-5.2 поддерживает уровни мышления off, low, high и max. OpenClaw сопоставляет low и high с высоким уровнем усилия рассуждения Z.AI, а max — с максимальным усилием.
Настройка Coding Plan по умолчанию использует zai/glm-5.2; настройка общего API сохраняет zai/glm-5.1. Автоопределение конечной точки откатывается к glm-5.1 или glm-4.7, когда выбранный план не предоставляет GLM-5.2. Версии и доступность GLM могут меняться; выполните openclaw models list --all --provider zai, чтобы увидеть каталог, известный вашей установленной версии.

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

Неизвестные идентификаторы glm-5* все равно прямо разрешаются на пути провайдера путем синтеза метаданных, принадлежащих провайдеру, из шаблона glm-4.7, когда идентификатор соответствует текущей форме семейства GLM-5.
tool_stream включен по умолчанию для потоковой передачи вызовов инструментов Z.AI. Чтобы отключить его:
{
  agents: {
    defaults: {
      models: {
        "zai/<model>": {
          params: { tool_stream: false },
        },
      },
    },
  },
}
Мышление Z.AI следует элементам управления /think в OpenClaw. При отключенном мышлении OpenClaw отправляет thinking: { type: "disabled" }, чтобы избежать ответов, которые тратят бюджет вывода на reasoning_content до видимого текста.Сохраненное мышление включается явно, потому что Z.AI требует повторной передачи полного исторического reasoning_content, что увеличивает количество токенов промпта. Включите его для каждой модели:
{
  agents: {
    defaults: {
      models: {
        "zai/glm-5.2": {
          params: { preserveThinking: true },
        },
      },
    },
  },
}
Когда оно включено и мышление активно, OpenClaw отправляет thinking: { type: "enabled", clear_thinking: false } и повторно передает предыдущий reasoning_content для той же совместимой с OpenAI стенограммы.Опытные пользователи по-прежнему могут переопределить точную полезную нагрузку провайдера с помощью params.extra_body.thinking.
Plugin 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, включая настройки провайдера и модели.