Мощный прослойка-сервер для интеграции GigaChat API (Sber) в инфраструктуру, заточенную под стандарт OpenAI. Идеально подходит для AI-агентов (например, OpenClaw), которым нужен стабильный стриминг и работа внутри РФ.
- ОС: Ubuntu Server (тестировалось на 24.04 / 26.04 LTS).
- Web-сервер: Apache2 (используется для проксирования сайтов и доступа к phpMyAdmin/IDE).
- Runtime: Node.js (v18 и выше).
- Модель: GigaChat-2-Max (поддерживается нативно).
- OpenAI Compatibility: Эмулирует эндпоинт
/v1/chat/completions. - Fake Stream: Генерирует идеальный SSE-поток для стабильной работы интерфейсов агентов.
- Role Mapper: Автоматически конвертирует современные роли (например,
developer) в формат, поддерживаемый GigaChat. - Security: Работает без необходимости установки сертификатов НУЦ Минцифры в систему.
- Auto-Auth: Самостоятельное обновление OAuth-токенов в фоновом режиме.
Склонируйте репозиторий и разместите файл gigachat-proxy.js в рабочей директории (например, /var/www/html/).
Важно: Откройте файл и замените значение переменной AUTH_KEY на ваш ключ в формате Base64 из личного кабинета разработчика Сбера.
const AUTH_KEY = '<ВАШ_BASE64_КЛЮЧ>';Убедитесь, что Apache запущен и настроен для работы с вашими проектами. Прокси будет работать локально на порту 8500, а сайты — на стандартных портах через Apache.
Для работы в режиме 24/7 создайте файл службы:
sudo nano /etc/systemd/system/gigaproxy.serviceВставьте конфигурацию из файла gigaproxy.service, заменив User= на имя вашего системного пользователя.
Запустите службу:
sudo systemctl daemon-reload
sudo systemctl enable gigaproxy --nowВ мастере настройки openclaw onboard укажите:
- Base URL:
http://127.0.0.1:8500/v1 - API Key: любая строка (прокси игнорирует её).
- Model ID:
GigaChat-2-Max
- Внешний доступ к порту 8500 закрыт по умолчанию (рекомендуется использовать SSH-туннели).
- Все API-ключи хранятся локально в коде прокси.