OpenClaw 2026 на macOS: GLM (Zhipu Z.AI)—провайдер zai, Coding Plan, openclaw.json и репетиция на облачном Mac mini

Команды, которым рядом с Anthropic или OpenAI нужна двуязычная и экономичная LLM, часто добавляют GLM — семейство моделей через Z.AI (глобальный API Zhipu). В OpenClaw на macOS в 2026 GLM не отдельный «чёрный ящик»: встроенный провайдер zai даёт ссылки вроде zai/glm-5.1, OpenAI-совместимый HTTP и онбординг, который фиксирует Coding Plan против общего API. Здесь — ключи, openclaw.json, пара с failover и проверка openclaw doctor на арендованном Mac mini с Apple Silicon (по прайсу MacHTML от ~16,9 $/сутки).

Раскрытие: MacHTML предоставляет облачный Mac mini, упомянутый в статье.

Свяжите гайд с отказом модели и маршрутизацией, профилями JSON и окружения, дисциплиной 429 и диагностикой doctor, чтобы GLM встал в документированную цепочку, а не разовый эксперимент.

Зачем GLM в OpenClaw

Модели GLM сильны в смешанных zh/en ходах агента, длинном контексте и пакетной работе с упором на цену. OpenClaw подключает их через zai с тем же tool-calling, что у других OpenAI-совместимых провайдеров. На облачном Mac mini GLM обычно:

1. Основной для каналов с китайским трафиком
2. Резерв после 429 у Anthropic (отдельная квота)
3. Vision через zai/glm-4.6v, если primary только текст

Официально: документация OpenClaw GLM и платформа Z.AI.

Факты о провайдере zai

Свойство	Значение
ID провайдера	zai
Переменные auth	ZAI_API_KEY или Z_AI_API_KEY
Базовый URL	https://api.z.ai/api/paas/v4
Модель по умолчанию	zai/glm-5.1
Модель изображений	zai/glm-4.6v
Форма API	OpenAI-совместимая

Для материкового Китая часто https://open.bigmodel.cn/api/paas/v4 (Zhipu BigModel); онбординг zai-cn и zai-coding-cn выбирает нужную поверхность, чтобы не сжечь неверный пул квоты.

Онбординг и секреты

Не коммитьте API-ключи. Храните в ~/.openclaw/.env с chmod 600.

openclaw onboard --auth-choice zai-api-key
openclaw onboard --auth-choice zai-coding-global
openclaw onboard --auth-choice zai-coding-cn
openclaw models list --provider zai

openclaw config set agents.defaults.model.primary "zai/glm-5.1"

После каждого изменения секретов или маршрутизации — openclaw doctor.

Каркас openclaw.json

{
  env: { ZAI_API_KEY: "sk-..." },
  agents: {
    defaults: {
      model: {
        primary: "zai/glm-5.1",
        fallbacks: ["anthropic/claude-sonnet-4", "openai/gpt-4.1-mini"]
      }
    }
  },
  providers: {
    zai: { timeoutMs: 45000 }
  }
}

Имена полей меняются между релизами — сверяйте с установленной версией. Профили: статья JSON и .env.

Coding Plan vs общий API

Выбор auth	Назначение
zai-api-key	Авто endpoint по ключу
zai-coding-global	Coding Plan (global)
zai-coding-cn	Coding Plan (Китай)
zai-global	Общий API (global)
zai-cn	Общий API (Китай)

Симптом: HTTP 429 «insufficient balance» при активном Coding Plan — трафик бьёт в общий путь, не /api/coding/paas/v4. Повторите онбординг с zai-coding-*; бюджеты retry — в статье 429.

Каталог моделей

openclaw models list --provider zai — живой каталог. Типичные ref (2026):

Ref	Сценарий
zai/glm-5.1	Reasoning, контекст 202k
zai/glm-5v-turbo	Reasoning + изображения
zai/glm-4.7-flash	Низкая задержка для ботов
zai/glm-4.6v	Vision по умолчанию

Лимит попытки ~45 с, ход ~120 с в цепочке failover — см. гайд по отказу модели.

Failover и совместимость инструментов

GLM в fallback должен принимать тот же JSON schema инструментов. Три фиксированных вызова — read, patch, list — на zai/glm-5.1 в staging. Убирайте image parts при переходе на text-only GLM.

Чеклист staging на macOS

1. Отпечаток openclaw.json без секретов в git-ignored хранилище.
2. Онбординг zai с верным региональным auth.
3. openclaw models list --provider zai — ≥1 строка GLM.
4. Синтетический чат + smoke инструментов на staging-порту.
5. Симуляция падения primary; ответ GLM за 10 с.
6. LaunchAgent после 24 ч чистых метрик.

Аренда Mac mini через MacHTML сохраняет поведение Node и Keychain как в проде — не Linux-заглушку. После репетиции остановите инстанс; таблицы маршрутизации остаются в runbook.

FAQ

GLM = название компании Zhipu?

Нет: GLM — модели; ключи на Z.AI / BigModel.

Какую переменную окружения?

ZAI_API_KEY; Z_AI_API_KEY — алиас.

Заменить Anthropic для destructive tools?

Только после smoke schema и HITL-политики.

Как часто doctor?

После каждого изменения zai и еженедельно в проде — статья doctor.