OpenClaw

OpenClaw — платформа ИИ-агентов с открытым кодом: она подключает ассистента к Telegram, Discord, Slack и другим мессенджерам. К Infergate OpenClaw подключается как OpenAI-совместимый провайдер через Chat Completions.

Что понадобится

Установка

Нужен Node.js 24 (не ниже 24.16) или 26. Подробнее — в документации OpenClaw.

npm install -g openclaw@latest
openclaw --version

Настройка в мастере

Запустите мастер настройки командой openclaw onboard --classic. Infergate нет среди встроенных провайдеров, поэтому на шаге выбора провайдера выберите Custom Provider, затем OpenAI-compatible, и укажите:

Base URL:  https://infergate.ru/api/v1
API key:   sk-...
Модель:    z-ai/glm-5.2

Остальные шаги мастера — рабочее пространство, шлюз, каналы — к Infergate не относятся. Если мастер предложит проверить подключение, соглашайтесь: это один короткий запрос.

Настройка в файле

Того же результата можно добиться, отредактировав ~/.openclaw/openclaw.json. Ключ OpenClaw возьмёт из переменной окружения — задайте её в терминале, из которого будете запускать OpenClaw (чтобы не задавать каждый раз, добавьте строку в ~/.zshrc или ~/.bashrc):

export INFERGATE_API_KEY="sk-..."

Затем опишите провайдера:

{
  "agents": {
    "defaults": {
      "model": { "primary": "infergate/z-ai/glm-5.2" }
    }
  },
  "models": {
    "mode": "merge",
    "providers": {
      "infergate": {
        "baseUrl": "https://infergate.ru/api/v1",
        "apiKey": "${INFERGATE_API_KEY}",
        "api": "openai-completions",
        "models": [
          { "id": "z-ai/glm-5.2", "name": "GLM 5.2" },
          { "id": "anthropic/claude-opus-4.8", "name": "Claude Opus 4.8" }
        ]
      }
    }
  }
}
  • providers.infergate — описание провайдера: baseUrl — адрес Infergate, api: "openai-completions" — формат Chat Completions.
  • models — модели каталога, которые увидит агент, по их идентификаторам.
  • agents.defaults.model.primary — модель по умолчанию. Её имя состоит из имени провайдера и идентификатора модели: infergate/z-ai/glm-5.2.

OpenClaw может сохранить значение ключа открытым текстом в ~/.openclaw/agents/<агент>/agent/models.json. Не добавляйте этот файл в git и следите за правами доступа к нему.

Проверка

Первая команда показывает модели провайдера, вторая отправляет короткий проверочный запрос, третья задаёт вопрос агенту:

openclaw models list --provider infergate
openclaw models status --probe --probe-provider infergate
openclaw agent --agent main -m "Привет! Ответь одним предложением." --local

Каждый запрос агента появится в разделе «Запросы» личного кабинета — с моделью, токенами и стоимостью.

Модели

Модель по умолчанию меняется командой openclaw models set, например openclaw models set infergate/anthropic/claude-opus-4.8. Если модель принимает изображения, добавьте в её описание "input": ["text", "image"] — тогда OpenClaw будет передавать ей картинки из чатов. В agents.defaults.model.fallbacks можно перечислить запасные модели на случай, если основная недоступна.

Если не работает

  • Missing env var "INFERGATE_API_KEY" — переменная не задана в терминале, из которого запущен OpenClaw.
  • Pass --to <E.164>, --session-key, --session-id, or --agent to choose a session — команде openclaw agent нужен агент или сессия: добавьте --agent main.
  • Модель не выбирается — её нет в models провайдера или в идентификаторе опечатка.
  • 401 — ключ неверный, отключён или удалён.
  • 402 — на балансе не хватает денег или исчерпан лимит ключа.