Как подключить polza.ai к OpenClaw: пошаговый гайд для не-разработчиков
Привет. Если вы читаете это — скорее всего, вы уже установили OpenClaw, потёрли руки в предвкушении, а потом… упёрлись в стену.
Проблема, о которой не пишут в гайдах
Всё начиналось отлично: скачал OpenClaw, запустил, увидел список моделей — и тут бац. Чтобы пользоваться чем-то серьёзным, нужен API-ключ. А ключи — у зарубежных провайдеров: OpenRouter, Google, Anthropic. И тут всплывает «весёлая» деталь: оплатить их услуги с российской карты нельзя. Даже если очень хочется.
Я перепробовал всё: криптокошельки, посредников, виртуальные карты. Всё либо сложно, либо дорого, либо ненадёжно. И уже почти махнул рукой, пока случайно не наткнулся на polza.ai.
Почему polza.ai?
Просто и по-человечески:
- ✅ Принимает рубли — с карты РФ, без танцев с бубном
- ✅ Доступ к 400+ моделям — через один ключ: Step, Gemini, Qwen, Llama и другие
- ✅ Совместим с OpenClaw — работает по стандарту OpenAI API
- ✅ Нет скрытых комиссий — платишь только за токены
Но есть нюанс: чтобы подключить polza.ai к OpenClaw, нужно чуть-чуть поработать с конфигом. И если вы не разработчик — это может напугать.
Не переживайте. Я тоже не разработчик. Просто копировал команды из терминала в терминал, пока не заработало. И теперь делюсь с вами готовым рецептом.
🛠️ Пошаговая инструкция: подключаем polza.ai к OpenClaw
⚠️ Важно: все команды выполняются на сервере, где установлен OpenClaw. Предполагается, что вы уже авторизованы и находитесь в домашней директории пользователя
openclaw.
Шаг 1. Получаем API-ключ
- Заходим на polza.ai/dashboard/api-keys
- Регистрируемся / авторизуемся
- Создаём новый ключ — он будет начинаться с
pza_... - Копируем и сохраняем — он нам понадобится
Шаг 2. Создаём минимальный конфиг
Вместо того чтобы править огромный JSON вручную (и случайно сломать его), мы просто перезапишем конфиг начисто. Одна команда — и готово:
echo '{"gateway":{"port":18789,"mode":"local","bind":"loopback","auth":{"mode":"token","token":"ВАШ ТОКЕН"}},"models":{"mode":"merge","providers":{"polza":{"baseUrl":"https://polza.ai/api/v1","apiKey":"pza_ВАШ_КЛЮЧ","api":"openai-completions","models":[{"id":"stepfun/step-3.5-flash","name":"Step 3.5 Flash","contextWindow":128000,"maxTokens":32000}]}}},"agents":{"defaults":{"model":{"primary":"polza/stepfun/step-3.5-flash"}}}}' > ~/.openclaw/openclaw.json
🔹 Замените
pza_ВАШ_КЛЮЧна ваш реальный ключ (тот, что начинается сpza_).
💡 Совет: если боитесь ошибиться — вставьте команду в текстовый редактор, замените ключ, а потом скопируйте уже готовую строку в терминал.
Шаг 3. Проверяем, что всё записалось правильно
grep baseUrl ~/.openclaw/openclaw.json
✅ Правильный вывод:
"baseUrl":"https://polza.ai/api/v1"
❌ Если видите пробелы в конце (например, /v1 "), значит, при копировании что-то пошло не так. Просто выполните команду ещё раз — внимательно.
Шаг 4. Перезапускаем Gateway
killall openclaw 2>/dev/null; sleep 1; openclaw gateway > ~/gw.log 2>&1 &
Ждём 3–5 секунд и проверяем, что шлюз жив:
curl -s http://127.0.0.1:18789/health
✅ Успех: {"ok":true,"status":"live"}
Шаг 5. Тестируем агента
openclaw agent --agent main --message "Привет, это тест"
Если в ответ вы увидите что-то вроде:
Привет! Тест работает — соединение установлено.
— поздравляю, всё получилось 🎉
🌐 А если не открывается веб-интерфейс?
Иногда после настройки конфигурация блокирует доступ из браузера с ошибкой origin not allowed. Это защита CORS — и её можно отключить для локального использования.
Добавьте в конфиг разрешение на все источники:
python3 -c "import json;f='/home/openclaw/.openclaw/openclaw.json';c=json.load(open(f));c.setdefault('gateway',{})['controlUi']={'allowedOrigins':['*'],'allowInsecureAuth':True};json.dump(c,open(f,'w'),separators=(',',':'))"
Затем снова перезапустите Gateway (Шаг 4) и откройте в браузере:
http://ВАШ_IP_СЕРВЕРА:18789/
🔐 Важно:
allowedOrigins: ["*"]— удобно для тестов, но на публичном сервере лучше указать конкретные домены.
🧰 Чеклист на случай, если «что-то пошло не так»
| Симптом | Что проверить | Решение |
|---|---|---|
404 Cannot POST /api/v1%20/... | grep baseUrl ~/.openclaw/openclaw.json | Убрать пробелы в конце URL |
401 Unauthorized | API-ключ в конфиге | Взять новый ключ в личном кабинете polza.ai |
| Gateway не запускается | tail -20 ~/gw.log | Исправить JSON-ошибку в конфиге |
| Веб-интерфейс не грузится | Ошибка CORS в консоли браузера | Добавить allowedOrigins: ["*"] |
💬 Вместо заключения
Я не пишу код каждый день. Я просто хотел, чтобы умный помощник работал — без сложностей с оплатой и без необходимости становиться программистом.
Polza.ai + OpenClaw — это как раз тот случай, когда технология становится доступной. Не идеальной, не «из коробки», но рабочей. И главное — честной: платишь в рублях, получаешь доступ к тем же моделям, что и все.
Если у вас что-то не получилось — не бросайте. Скопируйте ошибку, погуглите, спросите. Чаще всего проблема — в одном лишнем пробеле. А решение — в одной правильной команде.
Удачи. И пусть ваш ИИ говорит по-русски 🦞
P.S. для подключения openclaw, можно воспользоваться официальной документацией: https://polza.ai/docs/integracii/openclaw

