Skip to main content
OpenClaw Desktop — кросс-платформенное десктопное приложение для работы с AI-агентами. Поддерживает несколько провайдеров и подключается к Polza.ai через Custom Provider по OpenAI-совместимому протоколу — без правки конфигов вручную.
Это инструкция для десктопного приложения OpenClaw. Серверное решение — отдельная страница: OpenClaw.

Требования

  • Установленное приложение OpenClaw Desktop (Windows, macOS или Linux)
  • Аккаунт на polza.ai и API-ключ

Подключение к Polza.ai

Все шаги выполняются в самом приложении через мастер настройки — отдельный конфиг-файл править не нужно.
1

Пройдите начальную настройку приложения самостоятельно

Откройте OpenClaw Desktop. Приложение проведёт вас через собственную первоначальную настройку. Дойдите до экрана Choose an option — это первый шаг мастера, относящийся к подключению провайдера моделей.
Экран Choose an option в мастере настройки OpenClaw Desktop
2

Выберите Custom Provider

На экране Choose an option выберите пункт Custom Provider — он позволяет подключить любой OpenAI-совместимый endpoint, в том числе Polza.ai.
3

Укажите Base URL

На следующем экране введите базовый URL Polza.ai:
Поле ввода Base URL со значением https://polza.ai/api/v1
4

Выберите Paste API key now

На экране выбора способа авторизации выберите Paste API key now и вставьте ключ, полученный на polza.ai/dashboard/api-keys.
Экран с опцией Paste API key now и полем для ввода ключа
Ключ хранится локально в настройках приложения. Не публикуйте скриншоты и дампы конфигурации с ключом.
5

Выберите OpenAI-compatible

На экране выбора протокола выберите OpenAI-compatible — Polza.ai поддерживает этот стандарт для всех чатовых моделей.
Экран выбора протокола с пунктом OpenAI-compatible
6

Введите model id

На экране добавления модели введите идентификатор в формате <vendor>/<model-id> — например, anthropic/claude-sonnet-5. Шаг можно повторить, чтобы добавить несколько моделей как алиасы для быстрого переключения.
Экран ввода model id, пример anthropic/claude-sonnet-4.6
Список доступных slug-ов — на polza.ai/models. Каждая добавленная модель становится алиасом: переключаться можно прямо из чата.
7

Проверьте подключение

После добавления модели появится окно теста подключения.
Окно теста подключения с кнопкой Test connection
8

Готово

Если тест прошёл успешно — настройка завершена. Можно начинать чат.
Главный экран OpenClaw Desktop после успешной настройки Polza.ai

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

Polza.ai поддерживает сотни моделей; ниже подборка для типовых задач в десктоп-клиенте. Полный список — на polza.ai/models.

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

  • Скопируйте ключ заново из polza.ai/dashboard/api-keys — лишние пробелы и Unicode-символы ломают auth
  • Проверьте что на балансе есть положительный остаток
  • Убедитесь что Base URL — ровно https://polza.ai/api/v1 (без trailing slash, без /chat/completions на конце)
  • Проверьте model id — он должен быть в формате <vendor>/<model-id> и существовать в каталоге Polza.ai
  • Опечатки в slug-е (например, claude-sonnet-4-6 через дефис вместо claude-sonnet-4.6 через точку) — самая частая причина
Возможно, у вас устаревшая версия OpenClaw Desktop. Обновите приложение до последней — пункт Custom Provider доступен начиная с определённого релиза (см. release notes OpenClaw).
После выбора Custom Provider и ввода Base URL Polza.ai приложение должно автоматически определить протокол. Если опции нет — проверьте что Base URL указан корректно (предыдущий шаг).
  • Проверьте интернет-соединение до polza.ai
  • Попробуйте другую модель из списка — некоторые вендоры могут быть временно недоступны
  • Посмотрите логи приложения (раздел Settings → Logs) — там будет HTTP-код ответа

Следующие шаги

Cline Desktop

Десктоп-вариант Cline — то же подключение через конфиг

Claude Code Desktop

Десктоп-вариант Claude Code