Перейти к основному содержанию
OpenClaw — open-source платформа для создания персонального AI-ассистента, работающего через Telegram, WhatsApp, Discord, Slack и другие мессенджеры. OpenClaw запускает локальный Gateway-сервер, который маршрутизирует сообщения из разных каналов к AI-модели.

Требования

Настройка подключения к Polza.ai

Polza.ai подключается к OpenClaw как custom provider через OpenAI-совместимый API.
1

Откройте конфигурацию OpenClaw

Откройте файл конфигурации в текстовом редакторе:
nano ~/.openclaw/openclaw.json
Или используйте встроенные инструменты:
openclaw configure
2

Добавьте провайдер Polza.ai

В секции models.providers добавьте провайдер polza с вашим API-ключом:
{
  models: {
    mode: "merge",
    providers: {
      polza: {
        baseUrl: "https://polza.ai/api/v1",
        apiKey: "<ваш API-ключ Polza.ai>",
        api: "openai-completions",
        models: [
          {
            id: "anthropic/claude-sonnet-4.6",
            name: "Claude Sonnet 4.6"
          },
          {
            id: "google/gemini-3.1-flash-lite-preview",
            name: "Gemini 3.1 Flash Lite"
          },
          {
            id: "moonshotai/kimi-k2.5",
            name: "Kimi K2.5"
          }
        ]
      }
    }
  }
}
Поле api: "openai-completions" обязательно — без него OpenClaw не сможет определить тип API.
3

Назначьте модель по умолчанию

Укажите модель Polza.ai как основную в секции agents.defaults:
{
  agents: {
    defaults: {
      model: {
        primary: "polza/anthropic/claude-sonnet-4.6"
      },
      models: {
        "polza/anthropic/claude-sonnet-4.6": {
          alias: "Claude"
        },
        "polza/google/gemini-3.1-flash-lite-preview": {
          alias: "Gemini"
        },
        "polza/moonshotai/kimi-k2.5": {
          alias: "Kimi"
        }
      }
    }
  }
}
Формат ссылки на модель: polza/<model-id>, где polza — имя провайдера из конфига, а <model-id> — ID модели из списка models.
4

Перезапустите Gateway

Если у вас включён hot reload (по умолчанию), изменения применятся автоматически. Если нет:
openclaw gateway restart

Полный пример конфигурации

Готовый ~/.openclaw/openclaw.json с Polza.ai и Telegram-каналом:
{
  gateway: {
    port: 18789,
    mode: "local",
    bind: "loopback"
  },
  models: {
    mode: "merge",
    providers: {
      polza: {
        baseUrl: "https://polza.ai/api/v1",
        apiKey: "<ваш API-ключ Polza.ai>",
        api: "openai-completions",
        models: [
          {
            id: "anthropic/claude-sonnet-4.6",
            name: "Claude Sonnet 4.6"
          },
          {
            id: "google/gemini-3.1-flash-lite-preview",
            name: "Gemini 3.1 Flash Lite"
          },
          {
            id: "moonshotai/kimi-k2.5",
            name: "Kimi K2.5"
          },
          {
            id: "z-ai/glm-5-turbo",
            name: "GLM-5 Turbo"
          },
          {
            id: "qwen/qwen3-coder-480b-a35b",
            name: "Qwen3 Coder 480B"
          }
        ]
      }
    }
  },
  agents: {
    defaults: {
      model: {
        primary: "polza/anthropic/claude-sonnet-4.6",
        fallbacks: ["polza/moonshotai/kimi-k2.5"]
      },
      models: {
        "polza/anthropic/claude-sonnet-4.6": {
          alias: "Claude"
        },
        "polza/google/gemini-3.1-flash-lite-preview": {
          alias: "Gemini"
        },
        "polza/moonshotai/kimi-k2.5": {
          alias: "Kimi"
        },
        "polza/z-ai/glm-5-turbo": {
          alias: "GLM"
        },
        "polza/qwen/qwen3-coder-480b-a35b": {
          alias: "QwenCoder"
        }
      }
    }
  },
  channels: {
    telegram: {
      dmPolicy: "allowlist",
      botToken: "<токен бота Telegram>",
      allowFrom: ["<ID аккаунта Telegram>"],
      groupPolicy: "allowlist"
    }
  },
  plugins: {
    entries: {
      telegram: {
        enabled: true
      }
    }
  }
}

Переключение моделей

После настройки нескольких моделей вы можете переключаться между ними прямо в чате:
/model polza/moonshotai/kimi-k2.5
Или через CLI:
openclaw models set polza/qwen/qwen3-coder-480b-a35b
Список доступных моделей:
openclaw models list

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

OpenClaw поддерживает автоматическое переключение на запасную модель при недоступности основной:
{
  agents: {
    defaults: {
      model: {
        primary: "polza/anthropic/claude-sonnet-4.6",
        fallbacks: [
          "polza/moonshotai/kimi-k2.5",
          "polza/google/gemini-3.1-flash-lite-preview"
        ]
      }
    }
  }
}

Рекомендуемые модели

МодельID в Polza.aiДля чего подходит
Claude Sonnet 4.6anthropic/claude-sonnet-4.6Основная рабочая модель: длинные рассуждения, генерация кода, анализ документов, мультиязычные диалоги
Gemini 3.1 Flash Litegoogle/gemini-3.1-flash-lite-previewЭкономичная модель для коротких ответов, суммаризации и простых вопросов
Kimi K2.5moonshotai/kimi-k2.5Кодинг и reasoning-задачи. MoE-архитектура, высокая скорость при низкой стоимости
GLM-5 Turboz-ai/glm-5-turboМультиязычные задачи (CN/EN), обработка длинного контекста, аналитика
Qwen3 Coder 480Bqwen/qwen3-coder-480b-a35bСпециализированная модель для кодинга: 480B параметров, агентские сценарии, контекст до 256K токенов
Актуальный список моделей: polza.ai/models

Использование переменных окружения

Вместо хранения API-ключа в конфиге можно использовать переменную окружения:
{
  env: {
    vars: {
      POLZA_API_KEY: "<ваш API-ключ>"
    }
  },
  models: {
    mode: "merge",
    providers: {
      polza: {
        baseUrl: "https://polza.ai/api/v1",
        apiKey: "${POLZA_API_KEY}",
        api: "openai-completions",
        models: [
          { id: "anthropic/claude-sonnet-4.6", name: "Claude Sonnet 4.6" },
          { id: "moonshotai/kimi-k2.5", name: "Kimi K2.5" }
        ]
      }
    }
  }
}
Или задайте ключ через .env файл в ~/.openclaw/.env:
POLZA_API_KEY=sk-...

Решение проблем

  • Проверьте правильность API-ключа Polza.ai
  • Убедитесь в наличии средств на балансе
  • Проверьте Base URL: https://polza.ai/api/v1
Убедитесь, что в конфиге провайдера указано поле api:
polza: {
  baseUrl: "https://polza.ai/api/v1",
  apiKey: "...",
  api: "openai-completions",  // ← обязательно
  models: [...]
}
  • Проверьте что модель добавлена в models.providers.polza.models
  • Проверьте что модель есть в agents.defaults.models (это allowlist)
  • Формат ссылки: polza/<model-id> — например, polza/anthropic/claude-sonnet-4.6
  • Актуальный список моделей: polza.ai/models
OpenClaw строго валидирует конфигурацию. Запустите диагностику:
openclaw doctor
openclaw doctor --fix
  • Переключитесь на более быстрые модели: Gemini 3.1 Flash Lite или GLM-5 Turbo
  • Проверьте интернет-соединение
  • Установите streamMode: "partial" в настройках канала для стриминга ответов

Поддержка