Перейти до основного вмісту
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)
APIZ.AI Chat Completions (Bearer auth)

​
Моделі 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 без завантаження runtime провайдера: 
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 із високим reasoning effort Z.AI, а max — з максимальним effort.
Налаштування 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 увімкнено за замовчуванням для потокової передачі tool-call 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 auth із вашим 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, включно з налаштуваннями провайдера та моделі.