Чтобы запустить Telegram-бота с современной языковой моделью, необязательно писать обработчики, хранить сессии и самостоятельно поддерживать long polling. OpenClaw уже умеет подключать Telegram, управлять диалогами и направлять запросы в OpenAI-compatible API OdiRouter.
Результат: у вас будет личный Telegram-бот, который работает через OpenClaw Gateway и отвечает моделью gpt-5.6-sol из OdiRouter. Python-проект, webhook и публичный HTTPS-домен для первого запуска не нужны. На момент проверки авторизованный /v1/models возвращал 224 модели.
Что мы собираем
Архитектура состоит всего из пяти звеньев:
Telegram user
→ Telegram Bot API
→ OpenClaw Gateway
→ https://api.odirouter.ai/v1
→ gpt-5.6-solBotFather создаёт Telegram-бота и выдаёт Bot Token.
OpenClaw получает сообщения, ведёт сессии и возвращает ответы в Telegram.
OdiRouter предоставляет единый OpenAI-compatible доступ к моделям.
Модель меняется настройкой provider/model, Telegram-бот остаётся тем же.
Почему это проще Python-версии: не нужно писать bot.py, вручную разбивать длинные ответы, поддерживать poller или придумывать хранение сессий. OpenClaw берёт этот слой на себя.
Что понадобится
Компонент | Требование |
|---|---|
Node.js | Рекомендуется Node.js 24.15 или новее в ветке 24.x. |
Telegram | Аккаунт и Bot Token от официального @BotFather. |
OdiRouter | Аккаунт, API Key и точный model ID из /v1/models. |
Компьютер или сервер | macOS, Linux или Windows с постоянным доступом в интернет. |
Время | Около 20 минут на установку, настройку и первую проверку. |
Шаг 1. Создаём бота через BotFather
Откройте @BotFather в Telegram и убедитесь, что username указан точно.
Отправьте команду /newbot.
Задайте отображаемое имя бота.
Выберите username, который заканчивается на bot.
Скопируйте выданный Bot Token и сохраните его как секрет.
Безопасность: Bot Token позволяет полностью управлять ботом. Если он попал в Git, скриншот или публичный чат, немедленно перевыпустите токен через BotFather.
Шаг 2. Получаем API Key и проверяем модель
Создайте API Key в кабинете OdiRouter. Затем проверьте каталог моделей:
export ODIROUTER_API_KEY="ваш_ключ"
curl https://api.odirouter.ai/v1/models \
-H "Authorization: Bearer $ODIROUTER_API_KEY"Для настройки используйте точное значение поля id. В руководстве используется gpt-5.6-sol.
Важно: не копируйте маркетинговое название модели из новости. Если model ID изменился или недоступен вашему ключу, выберите точный ID из текущего авторизованного ответа /v1/models.
Шаг 3. Устанавливаем OpenClaw
node --version
npm install -g openclaw@latest
openclaw --version
openclaw onboard --install-daemonВ мастере начальной настройки можно временно пропустить model provider и chat channel: мы добавим OdiRouter и Telegram следующими командами. Установка daemon позволяет Gateway работать в фоне после закрытия терминала.
Если npm показывает EBADENGINE: установите поддерживаемую версию Node.js. Для актуального OpenClaw на момент подготовки материала самый понятный выбор для новичка — Node.js 24.15+.
Шаг 4. Подключаем OdiRouter к OpenClaw
Сначала узнайте путь к активному конфигурационному файлу:
openclaw config fileОткройте указанный openclaw.json и добавьте provider OdiRouter в существующую конфигурацию:
{
models: {
mode: "merge",
providers: {
"odirouter-openai": {
api: "openai-completions",
baseUrl: "https://api.odirouter.ai/v1",
apiKey: "YOUR_ODIROUTER_API_KEY",
models: [
{ id: "gpt-5.6-sol", name: "GPT-5.6 Sol" }
]
}
}
}
}Не перезаписывайте весь файл: если в openclaw.json уже есть workspace, gateway, agents или channels, сохраните их и аккуратно добавьте только models.providers. Конфигурация OpenClaw использует JSON5 и допускает комментарии.
openclaw config validate
openclaw models set odirouter-openai/gpt-5.6-sol
openclaw models status --plainПеред подключением Telegram можно проверить модель напрямую:
openclaw agent --agent main -m "Ответь одним словом: работает" --jsonШаг 5. Подключаем Telegram
openclaw channels add --channel telegram --token "BOT_TOKEN_ОТ_BOTFATHER"
openclaw gateway restart
openclaw channels status --probeНе используйте channels login: Telegram в OpenClaw подключается через Bot Token. Команда login предназначена для каналов, где нужно интерактивно связать аккаунт, например WhatsApp Web.
Шаг 6. Разрешаем первый личный чат
Откройте созданного бота в Telegram и отправьте ему сообщение, например «Привет».
OpenClaw по умолчанию использует безопасный режим DM pairing.
Посмотрите ожидающие запросы и скопируйте код.
openclaw pairing list telegramПодтвердите только свой запрос.
openclaw pairing approve telegram <CODE>Снова отправьте сообщение боту и дождитесь ответа модели.
Готово: если бот ответил, цепочка Telegram → OpenClaw → OdiRouter → модель работает. Pairing code действует ограниченное время; неизвестные запросы подтверждать нельзя.
Что происходит внутри
Telegram Bot API передаёт новое сообщение OpenClaw Gateway.
OpenClaw проверяет, разрешён ли отправитель через pairing или allowlist.
Gateway находит сессию пользователя и формирует запрос модели.
Provider odirouter-openai отправляет Chat Completions запрос в OdiRouter.
OdiRouter направляет запрос выбранной модели и возвращает ответ.
OpenClaw форматирует результат и отправляет его обратно в тот же Telegram-чат.
Как сменить модель
Добавьте новый точный ID в массив models provider OdiRouter, затем выполните:
openclaw models set odirouter-openai/ДРУГОЙ_MODEL_ID
openclaw gateway restartTelegram Bot Token и username менять не нужно.
Проверьте новый ID через авторизованный /v1/models.
До публичного запуска сравните качество, latency, цену и размер контекста.
Частые ошибки
Симптом | Что проверить |
|---|---|
EBADENGINE | Версия Node.js не соответствует требованиям OpenClaw. Обновите Node.js. |
401 Unauthorized | Проверьте OdiRouter API Key и baseUrl https://api.odirouter.ai/v1. |
Model not found | Сверьте models[].id и provider/model с текущим ответом /v1/models. |
Бот молчит в DM | Проверьте pending pairing и выполните pairing approve telegram <CODE>. |
409 Conflict | Тот же Bot Token уже использует другой OpenClaw Gateway или poller. |
Gateway offline | Выполните gateway status, logs --follow и openclaw doctor. |
Бот молчит в группе | Группы закрыты по умолчанию: сначала добейтесь работы в личном чате. |
openclaw gateway status
openclaw channels status --probe
openclaw logs --follow
openclaw doctorПеред публичным запуском
Главное правило: OpenClaw — это Agent Gateway, а не только чат-прокси. Если агенту доступны файлы, браузер или команды, публичный Telegram-доступ без ограничений создаёт реальный риск.
Для личного бота оставьте dmPolicy в режиме pairing или используйте allowlist.
Не включайте открытый доступ для всех, пока не ограничили инструменты и файловую систему.
Не публикуйте openclaw.json, Bot Token, API Key, логи и скриншоты с секретами.
Для групп сначала добавьте конкретный group chat ID и оставьте requireMention: true.
Настройте лимиты, бюджет, журналирование без секретов и резервную модель.
Итог
Ключевая идея проста: Telegram отвечает за знакомый интерфейс, OpenClaw — за Gateway, сессии и маршрутизацию, а OdiRouter — за единый доступ к моделям. Для первой рабочей версии достаточно Bot Token, API Key и одного model ID.
Начните с личного чата и безопасного pairing. Когда бот стабильно отвечает, можно добавлять группы, инструменты, память, расписания и другие возможности OpenClaw — по одной, с отдельной проверкой доступа.
Попробуйте: запустите бота, сравните две модели через OdiRouter и поделитесь в сообществе результатами по качеству, latency и стоимости.
Короткий анонс для Telegram
Telegram-бот с GPT-5.6 без Python-кода
Подготовили пошаговое руководство для новичков: создаём бота через BotFather, подключаем Telegram к OpenClaw, а модели — через OpenAI-compatible API OdiRouter.
установка OpenClaw и запуск Gateway;
готовая конфигурация provider OdiRouter;
подключение Telegram одной командой;
безопасное подтверждение первого личного чата;
смена модели без изменения Telegram-бота;
разбор ошибок 401, Model not found, 409 Conflict и EBADENGINE.
Python-код писать не нужно. Попробуйте собрать своего бота и расскажите в комментариях, какую модель OdiRouter выбрали.
Источники и полезные ссылки
OdiRouter: OpenClaw — официальная инструкция интеграции.
OpenClaw Telegram — настройка канала и pairing.
OpenClaw model providers — custom OpenAI-compatible providers.
OpenClaw config — проверка и изменение конфигурации.
Telegram Bot API — официальная документация Telegram.
BotFather — создание и управление ботами.
OdiRouter Community — сообщество и поддержка.
Редакционная заметка
Версии OpenClaw, требования Node.js, список моделей, цены и лимиты могут изменяться. Перед публикацией проверьте npm openclaw@latest, официальную документацию и авторизованный /v1/models OdiRouter.