Подключаем российские AI-сервисы к OpenClaw: GigaChat, YandexGPT и Yandex 360

Подключаем российские AI-сервисы к OpenClaw: GigaChat, YandexGPT и Yandex 360

TL;DR

Собрал пять агентов на базе OpenClaw: Jarvis (Claude Sonnet 4.5), Coder и Planner (Claude Opus 4.6), Ruslan (GigaChat-Pro) и Яша (YandexGPT). Все работает через Telegram. Полный код и навыки — на GitHub: openclaw-ru-skills.

Зачем это нужно

OpenClaw — это персональный AI-ассистент с открытым кодом, который умеет в мультиагентность, инструменты и интеграции. Из коробки работает с Claude, GPT, и другими западными моделями. Но что, если хочется добавить российские сервисы?

Эксперимент: создать навыки (skills) для трёх российских AI-сервисов с нуля и задокументировать каждый шаг. Для чистоты эксперимента — отдельный пустой репозиторий.

Архитектура

Telegram → OpenClaw Gateway → 🤖 Jarvis (Claude Sonnet 4.5, главный агент) → 💻 Coder (Claude Opus 4.6, кодинг) → 🧠 Planner (Claude Opus 4.6 + Extended Thinking) → 🐻 Ruslan (GigaChat-Pro) → 🦊 Яша (YandexGPT) OpenClaw → yax skill → Yandex 360 (Disk/Calendar/Mail/Telemost) OpenClaw → Yandex Cloud (TTS/Vision/Translate/ImageGen)

Шаг 1: Базовая настройка OpenClaw

Установка

OpenClaw ставится в три команды:

curl -fsSL https://openclaw.ai/install.sh | sh openclaw gateway start openclaw onboard

Процесс onboard проведёт через настройку агента и подключение к Telegram (или другому каналу).

Деплой на Railway

Я использовал Railway (hobby plan, $5/мес). Важные моменты:

1. Блокировка SMTP портов: Railway блокирует исходящие соединения на порты 25/465/587 — отправка почты через SMTP не работает.

2. Переменные окружения: Все секреты (API-ключи, токены) — в environment variables.

3. Персистентность процессов: Прокси-серверы (gpt2giga, yandexgpt) нужно стартовать вручную или через startup script.

Структура проекта

openclaw-ru-skills/ ├── gigachat/ # Навык для GigaChat │ ├── SKILL.md │ └── scripts/ ├── yandexgpt/ # Навык для YandexGPT │ ├── SKILL.md │ ├── src/proxy.js # Translation proxy │ └── scripts/ └── yax/ # Навык для Yandex 360 ├── SKILL.md └── src/

Шаг 2: GigaChat через gpt2giga

Получение доступа

1. Регистрация на https://developers.sber.ru/

2. Создание приложения GigaChat API

3. Получение Client ID и Client Secret

4. Scope: GIGACHAT_API_PERS (бесплатный персональный)

Установка прокси

GigaChat не совместим с OpenAI API из коробки. Используем gpt2giga — Python-прокси, который переводит запросы OpenAI → GigaChat:

pip3 install gpt2giga

Запуск

export GIGACHAT_CREDS=$(echo -n "CLIENT_ID:CLIENT_SECRET" | base64) gpt2giga \ --gigachat.credentials $GIGACHAT_CREDS \ --gigachat.scope GIGACHAT_API_PERS \ --gigachat.verify-ssl-certs false \ --proxy.port 8443 \ --proxy.pass-model true

Важно: --gigachat.verify-ssl-certs false нужен, потому что Сбер использует собственный корневой CA.

Конфигурация OpenClaw

Добавляем провайдера в openclaw.json:

{ "models": { "providers": { "gigachat": { "baseUrl": "http://127.0.0.1:8443", "apiKey": "dummy", "api": "openai-completions", "models": [ { "id": "GigaChat-Max", "name": "GigaChat MAX", "contextWindow": 32768, "maxTokens": 8192 }, { "id": "GigaChat-Pro", "name": "GigaChat Pro", "contextWindow": 32768, "maxTokens": 4096 }, { "id": "GigaChat", "name": "GigaChat Lite", "contextWindow": 8192, "maxTokens": 2048 } ] } } }, "agents": { "list": [ { "id": "ruslan", "name": "Ruslan", "emoji": "🐻", "model": "gigachat/GigaChat-Pro", "workspace": "/root/.openclaw/agents/ruslan/workspace" } ] } }

Создание агента Ruslan

Второй агент с русскоязычной душой. Создаём файлы в /root/.openclaw/agents/ruslan/workspace/:

IDENTITY.md:

# IDENTITY.md - Name: Ruslan - Creature: Российский AI-ассистент - Vibe: Дружелюбный, знает русский контекст - Emoji: 🐻

SOUL.md:

# SOUL.md — Кто ты Ты Руслан. Российский AI-ассистент на базе GigaChat-Pro. Говоришь на русском, знаешь русский контекст (кухня, культура, реалии). Отвечаешь кратко и по делу. Без лишней вежливости.

Проверка

curl -X POST http://localhost:8443/v1/chat/completions \ -H "Content-Type: application/json" \ -d '{ "model": "GigaChat-Pro", "messages": [{"role": "user", "content": "Столица России?"}] }'

Ответ: "Москва" (19 токенов).

Подводные камни

1. gpt2giga зомби: Процессы могут становиться defunct и держать порты. Убиваем через fuser -k 8443/tcp + kill -9.

2. Credentials в ps aux: CLI-аргументы видны в списке процессов — потенциальная дыра безопасности.

3. Редиректы 307: Эндпоинт /v1/models возвращает 307 редирект → используем curl -L.

Шаг 3: YandexGPT через translation proxy

Yandex Cloud setup

1. Создаём service account в Yandex Cloud Console

2. Генерируем API-ключ

3. Критично: назначаем роль ai.editor на folder через Access Bindings

Частая ошибка: Добавить разрешения на сервисный аккаунт ≠ назначить роль на folder. YandexGPT проверяет роли на уровне folder, а не разрешения на SA.

yc iam service-account create --name openclaw-sa SA_ID=$(yc iam service-account get openclaw-sa --format json | jq -r .id) yc iam api-key create --service-account-id $SA_ID yc resource-manager folder add-access-binding <FOLDER_ID> \ --role ai.editor \ --subject serviceAccount:$SA_ID

Translation proxy

YandexGPT API не совместим с OpenAI. Написал Node.js прокси (zero dependencies), который переводит OpenAI API → YandexGPT API:

• Принимает запросы на /v1/chat/completions

• Конвертирует формат OpenAI → YandexGPT

• Использует Api-Key авторизацию

• Маппит usage statistics (tokens)

Полный код прокси — в репозитории: yandexgpt/src/proxy.js

Запуск:

cd yandexgpt/src YANDEX_FOLDER_ID=<folder-id> YANDEX_API_KEY=<api-key> node proxy.js

Прокси слушает на порту 8444.

Конфигурация OpenClaw

{ "models": { "providers": { "yandexgpt": { "baseUrl": "http://127.0.0.1:8444", "apiKey": "dummy", "api": "openai-completions", "models": [ { "id": "yandexgpt", "name": "YandexGPT", "contextWindow": 8192, "maxTokens": 2048 }, { "id": "yandexgpt-lite", "name": "YandexGPT Lite", "contextWindow": 8192, "maxTokens": 2048 }, { "id": "yandexgpt-32k", "name": "YandexGPT 32K", "contextWindow": 32768, "maxTokens": 4096 } ] } } }, "agents": { "list": [ { "id": "yandex", "name": "Яша", "emoji": "🦊", "model": "yandexgpt/yandexgpt", "workspace": "/root/.openclaw/agents/yandex/workspace" } ] } }

Создание агента Яша

IDENTITY.md:

# IDENTITY.md - Name: Яша - Creature: Билингвальный AI-ассистент (русский + английский) - Vibe: Дружелюбный, нейтральный - Emoji: 🦊

Проверка

curl -X POST http://localhost:8444/v1/chat/completions \ -H "Content-Type: application/json" \ -d '{ "model": "yandexgpt", "messages": [{"role": "user", "content": "Столица России?"}] }'

Ответ: "Москва." (16 токенов).

Шаг 4: Yandex 360 через yax

OAuth setup

Yandex 360 API требует OAuth. Создаём приложение:

1. https://oauth.yandex.ru/client/new

2. Redirect URI: https://oauth.yandex.ru/verification_code (для CLI/ботов)

3. Выбираем scopes для нужных сервисов:

💡 Выбирайте только нужные scopes. Большинству пользователей нужны только Disk + Calendar.

📚 Полный список scopes: https://yandex.ru/dev/id/doc/ru/codes/scopes

Установка yax

cd /openclaw/skills git clone https://github.com/smvlx/openclaw-ru-skills cd openclaw-ru-skills/yax npm install --include=dev npx tsc

Аутентификация

node dist/index.js auth \ --client-id 79ccb7ad7edc4fa5b0b6602e93ff9958 \ --redirect-uri https://oauth.yandex.ru/verification_code

Открывается браузер, вводим код, токен сохраняется в ~/.openclaw/yax/token.json.

Примеры использования

Yandex Disk:

yax disk info # 49 GB свободно yax disk list / # Список файлов yax disk upload local.txt /remote.txt yax disk mkdir /test

Yandex Calendar (CalDAV):

yax calendar list # Список календарей yax calendar create "Встреча" "2026-02-14" "11:00:00" "12:00:00" "Описание" "Europe/Moscow"

Используется прямое CalDAV API Yandex.Calendar с OAuth авторизацией. Реализация включает:

• Auto-discovery логина через https://login.yandex.ru/info

• PROPFIND для определения путей календарей

• Правильные CalDAV пути: /calendars/{login}@yandex.ru/events-{id}/{uid}.ics

• Поддержка timezone (VTIMEZONE block в ICS)

Yandex Mail (IMAP/SMTP):

yax mail # Показывает информацию об ограничениях

Yandex не предоставляет HTTP API для почты, только IMAP/SMTP (порты 993/465). Работает локально, но порты заблокированы на облачных платформах типа Railway.

Yandex Telemost (видеоконференции):

OAuth scope telemost-api:conferences.create уже включен в настройки. Требует платную подписку Yandex 360 (403 на бесплатных аккаунтах).

Шаг 5: Мультиагентность

OpenClaw поддерживает несколько агентов из коробки. Каждый агент:

• Имеет собственную модель

• Имеет собственный workspace (файлы, память)

• Имеет собственную душу (SOUL.md, IDENTITY.md)

Конфигурация

{ "tools": { "agentToAgent": { "enabled": true, "allow": ["ruslan", "yandex", "coder", "planner"] } }, "agents": { "defaults": { "model": { "primary": "anthropic/claude-sonnet-4-5" } }, "list": [ { "id": "main", "subagents": { "allowAgents": ["ruslan", "yandex", "coder", "planner"] } }, { "id": "ruslan", "model": "gigachat/GigaChat-Pro" }, { "id": "yandex", "model": "yandexgpt/yandexgpt" }, { "id": "coder", "model": "anthropic/claude-opus-4-6" }, { "id": "planner", "model": "anthropic/claude-opus-4-6", "thinking": "max" } ] } }

Использование

В Telegram:

Пользователь: @OpenClawBot попроси Руслана написать стих про Байкал Jarvis: [запускает subagent ruslan] Ruslan: [пишет стих на GigaChat-Pro] Jarvis: [возвращает результат]

Результаты тестирования

GigaChat-Pro (Ruslan 🐻)

Тест: "Столица России?"
Ответ: "Москва" (19 токенов, 1.2 сек)

Тест: "Напиши стих про Москву" (4 строки)
Ответ: Осмысленный стих, хорошая рифма, русский контекст. 150 токенов.

YandexGPT (Яша 🦊)

Тест: "Столица России?"
Ответ: "Москва." (16 токенов, 0.8 сек)

Тест: "Explain machine learning" (English)
Ответ: Корректный ответ на английском, но слегка "русифицированный" стиль (особенность модели).

Yandex Disk (yax)

• ✅ Информация о диске

• ✅ Список файлов

• ✅ Загрузка/скачивание

• ✅ Создание папок

• ❌ Публичные ссылки (не тестировалось)

Yandex Calendar (yax)

• ✅ Список календарей (CalDAV API с auto-discovery)

• ✅ Список событий (протестировано с реальным событием)

• ✅ Создание событий (протестировано, работает с правильными CalDAV путями)

Подводные камни и решения

Итоги

Что работает

✅ GigaChat (все модели: Lite, Pro, Max) через gpt2giga
✅ YandexGPT (все модели: lite, default, 32k) через custom proxy
✅ Yandex Disk (info, list, upload, download, mkdir)
✅ Yandex Calendar (list, read, create events с timezone support)
✅ Yandex Mail (через IMAP/SMTP, но порты заблокированы на PaaS платформах)
✅ Yandex Telemost (create, info, modify)
✅ Мультиагентность (Jarvis + Ruslan + Яша)
✅ Agent-to-agent communication (subagents, sessions_send)

Ограничения

⚠️ Yandex Mail: Работает через IMAP/SMTP, но порты 993/465 заблокированы на Railway и аналогичных PaaS
⚠️ Yandex Telemost: Требует платную подписку Yandex 360 (403 на бесплатных аккаунтах)

Ссылки

• OpenClaw: https://openclaw.ai

• Репозиторий openclaw-ru-skills: https://github.com/smvlx/openclaw-ru-skills

• GigaChat API: https://developers.sber.ru/

• Yandex Cloud AI: https://cloud.yandex.ru/services/ai

• Yandex OAuth: https://oauth.yandex.ru/