Подключение Telegram к OpenClaw: полное руководство

Telegram - один из наиболее удобных каналов для взаимодействия с AI-агентом. В отличие от веб-интерфейсов, Telegram всегда под рукой на телефоне. В отличие от голосовых ассистентов, он позволяет отправлять файлы, ссылки и структурированный текст. OpenClaw поддерживает Telegram как канал первого класса: интеграция настраивается за несколько минут и открывает полный доступ ко всем возможностям агента.

Архитектурно Telegram-интеграция работает через компонент Gateway. Когда пользователь отправляет сообщение боту в Telegram, серверы Telegram передают его на Gateway через webhook или long polling. Gateway преобразует сообщение в формат, понятный Brain, отправляет его на обработку, получает ответ и возвращает его обратно в Telegram. Вся цепочка занимает от одной до нескольких секунд в зависимости от сложности запроса.

Начните с создания Telegram-бота. Откройте Telegram, найдите бота @BotFather и начните с ним диалог. @BotFather - это официальный инструмент Telegram для управления ботами.

Отправьте команду /newbot. @BotFather попросит ввести имя бота (отображаемое имя, может быть любым) и username (уникальный идентификатор, должен заканчиваться на «bot»). Например, имя «Мой AI Ассистент», username «my_ai_assistant_bot».

После создания @BotFather выдаст вам токен - строку вида 7123456789:AAF1xY2z.... Это ключ доступа к вашему боту. Сохраните его - он понадобится для настройки OpenClaw. Никому не показывайте этот токен: любой, кто его знает, может управлять вашим ботом.

Дополнительно настройте бота через @BotFather: задайте описание (команда /setdescription), аватар (/setuserpic) и список команд (/setcommands). Это необязательно для работы, но улучшает пользовательский опыт.

Откройте файл конфигурации OpenClaw:

nano ~/.openclaw/config.yaml

Добавьте или отредактируйте секцию Telegram-канала:

channels:
  telegram:
    enabled: true
    token: "7123456789:AAF1xY2z3W4v5U6t..."
    allowed_users:
      - 123456789  # ваш Telegram ID
    webhook:
      enabled: false
    polling:
      enabled: true
      interval: 1

Параметр allowed_users критически важен для безопасности. Укажите в нём ваш числовой Telegram ID (не username). Узнать свой ID можно, отправив сообщение боту @userinfobot в Telegram. Без этого ограничения любой пользователь Telegram сможет общаться с вашим агентом и потенциально получить доступ к вашим данным и инструментам.

Перезапустите OpenClaw, чтобы применить конфигурацию:

openclaw restart

Или, если OpenClaw запущен через Docker:

docker restart openclaw

Откройте Telegram и найдите вашего бота по username. Отправьте тестовое сообщение, например «Привет, ты работаешь?». Если всё настроено правильно, вы получите ответ от агента в течение нескольких секунд. Если ответа нет, проверьте логи:

openclaw logs --channel telegram

Типичные причины проблем: неверный токен (опечатка при копировании), ваш Telegram ID не указан в allowed_users, или файрвол блокирует исходящие соединения к серверам Telegram.

OpenClaw поддерживает два режима получения сообщений из Telegram. Polling (опрос) - Gateway периодически спрашивает серверы Telegram «есть ли новые сообщения?». Это простой в настройке режим, не требующий белого IP-адреса или домена. Подходит для домашних серверов и разработки.

Webhook - Telegram сам отправляет сообщения на указанный URL при их поступлении. Это более эффективный режим: нет лишних запросов, сообщения доставляются мгновенно. Но webhook требует публичного HTTPS-адреса. Если ваш сервер за NAT, потребуется обратный прокси (например, через Cloudflare Tunnel или ngrok).

Для настройки webhook укажите URL в конфигурации:

channels:
  telegram:
    enabled: true
    token: "7123456789:AAF1xY2z3W4v5U6t..."
    webhook:
      enabled: true
      url: "https://your-domain.com/webhook/telegram"
      secret: "random-secret-string-here"
    polling:
      enabled: false

Параметр secret добавляет дополнительный уровень безопасности: Telegram будет включать этот секрет в заголовок каждого webhook-запроса, и Gateway проверит его подлинность.

OpenClaw-бот может работать в групповых чатах Telegram. Для этого добавьте бота в группу и включите поддержку в конфигурации:

channels:
  telegram:
    groups:
      enabled: true
      respond_to_mentions: true
      respond_to_replies: true
      respond_to_all: false

В групповом режиме бот по умолчанию реагирует только на сообщения, в которых он упомянут (@my_ai_assistant_bot) или на ответы (reply) на его сообщения. Параметр respond_to_all: true заставит бота отвечать на каждое сообщение в группе - используйте это с осторожностью, чтобы не засорять чат.

Для работы в группах боту потребуется отключить Privacy Mode через @BotFather (команда /setprivacy, выбрать Disable). По умолчанию боты в группах видят только сообщения, начинающиеся с «/», и упоминания. С отключённым Privacy Mode бот видит все сообщения, что необходимо для полноценной интеграции.

Telegram-боты поддерживают inline-режим: вы набираете @username_bot в любом чате, затем запрос, и бот предлагает варианты ответа прямо в строке ввода. Для активации включите inline-режим через @BotFather (/setinline) и в конфигурации OpenClaw:

channels:
  telegram:
    inline:
      enabled: true
      cache_time: 60
      placeholder: "Спросите AI..."

Inline-режим полезен для быстрых запросов: перевод слова, расчёт, краткий ответ на вопрос - без необходимости переходить в чат с ботом. Ограничение: inline-ответы должны быть короткими, Telegram обрезает длинные тексты.

Агент OpenClaw через Telegram может принимать не только текстовые сообщения, но и файлы: документы, фотографии, голосовые сообщения. Gateway автоматически скачивает файл, определяет его тип и передаёт Brain вместе с контекстом. Для голосовых сообщений производится транскрибация через встроенный или внешний модуль распознавания речи.

Настройка обработки медиа в config.yaml:

channels:
  telegram:
    media:
      accept_photos: true
      accept_documents: true
      accept_voice: true
      max_file_size_mb: 20
      voice_transcription: whisper

Безопасность Telegram-токена - ваша ответственность. Несколько ключевых правил. Во-первых, никогда не коммитьте токен в Git-репозиторий. Используйте переменные окружения или .env-файл:

# В .env файле:
TELEGRAM_TOKEN=7123456789:AAF1xY2z3W4v5U6t...

# В config.yaml:
channels:
  telegram:
    token: ${TELEGRAM_TOKEN}

Во-вторых, всегда ограничивайте список allowed_users. Если вам нужно дать доступ нескольким людям, добавьте их ID поимённо, а не отключайте проверку. В-третьих, регулярно проверяйте логи на предмет несанкционированных попыток доступа. Gateway записывает все входящие сообщения, включая Telegram ID отправителя.

Если токен скомпрометирован, немедленно отзовите его через @BotFather (команда /revoke) и сгенерируйте новый. Обновите конфигурацию OpenClaw с новым токеном и перезапустите сервис.

OpenClaw поддерживает одновременную работу нескольких Telegram-ботов. Это полезно, если вы хотите разделить агентов по функциям: один бот для рабочих задач, другой - для личных, третий - для отслеживания новостей. Каждый бот подключается отдельной записью в конфигурации с уникальным именем и собственным SOUL.md:

channels:
  telegram_work:
    type: telegram
    token: ${TELEGRAM_TOKEN_WORK}
    soul: ~/.openclaw/souls/work.md
    allowed_users: [123456789]
  telegram_personal:
    type: telegram
    token: ${TELEGRAM_TOKEN_PERSONAL}
    soul: ~/.openclaw/souls/personal.md
    allowed_users: [123456789]

Каждый бот будет использовать свой файл SOUL.md, что позволяет создать совершенно разные «личности» для разных контекстов. При этом все боты работают на одном экземпляре OpenClaw и могут использовать общие инструменты и память.

Telegram-интеграция превращает OpenClaw из серверного приложения в карманного AI-ассистента. Создайте бота через @BotFather, добавьте токен в конфигурацию, ограничьте доступ по Telegram ID - и через минуту вы сможете общаться с агентом из любой точки мира. Для продвинутых сценариев используйте webhook, групповые чаты и inline-режим. И никогда не забывайте о безопасности токенов.

КРИТИЧЕСКОЕ ИЗМЕНЕНИЕ в v2026.2.25: безопасность групп Telegram изменена. Авторизация группы больше не основана на username - теперь используются числовые ID групп. Если вы настраивали разрешённые группы через username (например, @my_group), эта конфигурация не работает в новых версиях.

Новый параметр groupAllowFrom принимает только числовые ID Telegram-групп. Получить ID группы можно, добавив бота @userinfobot в группу или использовав Bot API метод getUpdates. Пример конфигурации: 'groupAllowFrom: [-1001234567890, -1009876543210]'.

Для миграции существующих конфигураций: найдите все записи с username-форматом в openclaw.config.yaml и замените их числовыми ID. OpenClaw v2026.2.25 и выше выдаст предупреждение при старте если обнаружит устаревший формат конфигурации групп.

OpenClaw v2026.5 улучшил Telegram-интеграцию: изолированные polling lanes -- каждый чат обрабатывается независимо; /stop (остановить задачу) и /btw (добавить контекст); SuperGroup/forum-topic поддержка; черновики прогресса -- streaming обновления видны в Telegram по мере выполнения задачи.

OpenClaw v2026.5.12 принёс два ключевых улучшения для Telegram-канала:

OpenClaw v2026.6.6 добавил для Telegram-интеграции:

Выбор между webhook и polling -- одно из ключевых решений при развёртывании Telegram-интеграции. Оба режима функционально эквивалентны с точки зрения результата, но кардинально отличаются по архитектуре, требованиям к инфраструктуре и поведению под нагрузкой.

Long polling -- как это работает: Gateway OpenClaw периодически отправляет запрос к Telegram Bot API методом getUpdates с параметром timeout (обычно 30-60 секунд). Если за это время появились новые сообщения, Telegram возвращает их немедленно. Если нет -- соединение держится до истечения timeout, затем Gateway открывает новое. Это длинный опрос (long polling), а не частый короткий опрос -- поэтому задержка минимальна (обычно менее секунды) при относительно небольшой нагрузке на серверы Telegram.

Преимущества polling: не требует публичного IP-адреса или домена; работает за любым NAT, корпоративным фаерволом, на домашнем компьютере; не нужен SSL-сертификат; простая отладка -- весь трафик исходящий; идеален для разработки, тестирования, домашних серверов.

Недостатки polling: при высокой нагрузке (сотни сообщений в секунду) polling начинает отставать; нельзя масштабировать горизонтально (два экземпляра OpenClaw с polling на один токен будут дублировать обработку); в редких случаях Telegram может временно ограничить частоту запросов.

Webhook -- как это работает: вы заранее регистрируете URL через Telegram Bot API (метод setWebhook). Когда пользователь отправляет сообщение боту, серверы Telegram немедленно делают POST-запрос на ваш URL с данными сообщения. Gateway OpenClaw принимает этот запрос, обрабатывает и возвращает HTTP 200. Если Gateway не отвечает в течение нескольких секунд, Telegram повторяет запрос.

Преимущества webhook: мгновенная доставка без polling-задержки; масштабируется горизонтально (несколько экземпляров за балансировщиком); более эффективен при высокой нагрузке; Telegram сам управляет повторными попытками при временной недоступности.

Недостатки webhook: требует публичного HTTPS-адреса с валидным SSL-сертификатом (самоподписанные не принимаются, кроме специальных случаев); сложнее в отладке; нужен обратный прокси если сервер за NAT.

Таблица сравнения:

• Требования к сети: Polling -- только исходящий трафик; Webhook -- публичный HTTPS
• Задержка доставки: Polling -- менее секунды при малой нагрузке; Webhook -- мгновенно
• Масштабирование: Polling -- только один экземпляр; Webhook -- горизонтальное
• Сложность настройки: Polling -- минимальная; Webhook -- требует домен и SSL
• Рекомендуется для: Polling -- разработка, домашние серверы; Webhook -- продакшн, VPS с доменом

Для работы webhook необходимы три условия: публичный IP-адрес или домен, HTTPS с валидным SSL-сертификатом от доверенного центра, и доступный порт (Telegram поддерживает порты 443, 80, 88, 8443).

Вариант 1: VPS с доменом и Let's Encrypt. Если у вас есть VPS и домен, получите бесплатный сертификат через Certbot:

sudo apt install certbot
sudo certbot certonly --standalone -d your-domain.com

channels:
  telegram:
    webhook:
      enabled: true
      url: "https://your-domain.com:8443/webhook/telegram"
      secret: "your-random-secret"
      ssl_cert: "/etc/letsencrypt/live/your-domain.com/fullchain.pem"
      ssl_key: "/etc/letsencrypt/live/your-domain.com/privkey.pem"
      port: 8443

Вариант 2: Cloudflare Tunnel (для домашних серверов). Cloudflare Tunnel позволяет создать защищённый туннель от вашего домашнего сервера до серверов Cloudflare -- без открытия портов в роутере:

# Установка cloudflared
curl -L https://pkg.cloudflare.com/cloudflare-main.gpg | sudo gpg --dearmor -o /usr/share/keyrings/cloudflare-main.gpg

# Авторизация и создание туннеля
cloudflared tunnel login
cloudflared tunnel create openclaw-telegram
cloudflared tunnel route dns openclaw-telegram bot.your-domain.com

Регистрация webhook в Telegram. OpenClaw при старте с включённым webhook автоматически регистрирует URL через Bot API. Проверить текущий webhook можно вручную:

curl "https://api.telegram.org/bot{ВАШ_ТОКЕН}/getWebhookInfo"

curl "https://api.telegram.org/bot{ВАШ_ТОКЕН}/deleteWebhook"

Бот не отвечает на сообщения. Первый шаг -- проверка логов:

openclaw logs --channel telegram --last 50

• Неверный токен -- скопируйте токен заново из @BotFather, исключая пробелы и переносы строк
• Telegram ID не в allowed_users -- проверьте свой ID через @userinfobot и убедитесь что он указан в конфигурации
• OpenClaw не запущен -- выполните openclaw status
• Фаервол блокирует исходящий трафик -- проверьте доступность api.telegram.org:443 с вашего сервера: curl https://api.telegram.org

Webhook не принимает запросы. Если webhook зарегистрирован, но сообщения не доходят:

• Проверьте getWebhookInfo на наличие поля last_error_message
• Убедитесь что порт открыт: sudo netstat -tlpn | grep 8443
• Проверьте SSL: openssl s_client -connect your-domain.com:8443 -- цепочка сертификатов должна быть полной
• Протестируйте webhook вручную: curl -X POST https://your-domain.com/webhook/telegram -H "Content-Type: application/json" -d '{"update_id":1}' -- должен вернуть HTTP 200
• Убедитесь что параметр secret в конфигурации совпадает с тем, что зарегистрирован в Telegram

Задержки доставки сообщений. Если ответы приходят медленно (более 5-10 секунд при простых запросах):

• Проверьте загрузку CPU: top -- Brain может быть перегружен другими задачами
• При использовании polling увеличьте значение interval в конфигурации, затем проверьте нет ли ошибок rate limit в логах
• Проверьте сетевую задержку до серверов Telegram: ping api.telegram.org
• При webhook-режиме убедитесь что Gateway успевает отвечать в 30-секундный таймаут Telegram -- иначе Telegram будет делать повторные попытки, создавая дубликаты

Дублирование сообщений. Бот обрабатывает одно сообщение дважды -- это обычно означает что webhook не отвечает в срок и Telegram повторяет запрос. Включите durable dispatch deduplication (доступно с v2026.6.6) или убедитесь что Gateway возвращает HTTP 200 быстро, передавая задачу в очередь асинхронно.

OpenClaw поддерживает богатый медиаввод через Telegram. Рассмотрим каждый тип подробнее.

Голосовые сообщения и аудио. Когда пользователь отправляет голосовое сообщение (voice) или аудиофайл (audio), Gateway скачивает его через Bot API и передаёт на транскрибацию. По умолчанию используется Whisper -- локальная или облачная версия OpenAI Whisper. Настройка:

channels:
  telegram:
    media:
      accept_voice: true
      voice_transcription: whisper
      whisper_model: "base"    # tiny, base, small, medium, large
      whisper_language: "ru"   # явно указать язык ускоряет транскрибацию

Фотографии. Telegram отправляет фотографии в нескольких разрешениях; Gateway автоматически выбирает наибольшее. Фото передаётся Brain как вложение. Если Brain настроен с vision-моделью (Claude с поддержкой vision, GPT-4o, Gemini), агент сможет описать или проанализировать изображение.

channels:
  telegram:
    media:
      accept_photos: true
      photo_max_dimension: 1280
      photo_format: "jpeg"

Документы и файлы. Telegram позволяет отправлять любые файлы (для ботов -- до 20 МБ через Bot API). Gateway скачивает файл, определяет MIME-тип и передаёт Brain. Конфигурация:

channels:
  telegram:
    media:
      accept_documents: true
      max_file_size_mb: 20
      allowed_mime_types:
        - "application/pdf"
        - "text/plain"
        - "application/json"
        - "image/png"
        - "image/jpeg"

Стикеры и анимация. По умолчанию стикеры игнорируются. Если вы хотите чтобы бот реагировал на стикеры, включите accept_stickers: true -- Gateway передаст emoji-эквивалент стикера как текст.

Работа OpenClaw-бота в Telegram-группах открывает новые сценарии: командный AI-ассистент, автоматические ответы на вопросы в поддержке, модерация. Вот что важно знать.

Добавление бота в группу. Откройте группу, нажмите на название -- Участники -- Добавить участника, введите username бота. Бот присоединится с правами обычного участника. Для работы бота нужны минимальные права: чтение сообщений и отправка сообщений. Если группа публичная и Privacy Mode включён (по умолчанию), бот видит только команды (сообщения, начинающиеся с /) и упоминания.

Privacy Mode. Это настройка безопасности Telegram, которая по умолчанию ограничивает видимость сообщений для ботов в группах. Чтобы бот получал все сообщения, отключите Privacy Mode через @BotFather: отправьте /setprivacy, выберите вашего бота, нажмите Disable. Это изменение применяется только к новым группам -- из уже существующих групп нужно удалить бота и добавить снова.

Настройка режима ответов в группе. OpenClaw поддерживает несколько стратегий:

• respond_to_mentions: true -- отвечать только на сообщения с @username_бота
• respond_to_replies: true -- отвечать на реплаи (ответы) на сообщения бота
• respond_to_commands: true -- отвечать на команды /help, /status и т.д.
• respond_to_all: false -- НЕ рекомендуется в активных группах, бот будет отвечать на каждое сообщение

Изоляция контекста для групп. В групповом чате несколько пользователей могут одновременно взаимодействовать с ботом. Настройте стратегию контекста:

channels:
  telegram:
    groups:
      context_strategy: "per_user"
      context_window: 20

Права в группе и разрешённые пользователи. allowed_users работает и в группах: если пользователь, написавший боту в группе, не указан в allowed_users, запрос будет отклонён. Для открытого доступа в группе уберите allowed_users или добавьте ID всех нужных участников. Начиная с v2026.2.25, для ограничения по группам используйте числовые ID группы в параметре groupAllowFrom.

Ограничение доступа через allowed_users. Это первая линия защиты. Каждый запрос к боту сопровождается Telegram ID отправителя -- числовым идентификатором аккаунта. В отличие от username (который можно сменить), Telegram ID постоянен. Узнать свой ID: отправьте сообщение боту @userinfobot или @getmyid_bot. Для семейного/командного использования добавьте несколько ID:

allowed_users:
  - 123456789
  - 987654321
  - 555000111

Хранение токена. Никогда не храните токен в открытом виде в файлах, которые могут попасть в Git или быть прочитаны другими процессами. Используйте переменные окружения или менеджер секретов. Для Linux-серверов хорошей практикой является хранение в файле с ограниченными правами:

chmod 600 ~/.openclaw/config.yaml
chown $USER:$USER ~/.openclaw/config.yaml

Ротация токена. Если есть подозрение что токен мог быть скомпрометирован:

1. Откройте @BotFather -- /mybots -- выберите бота -- API Token -- Revoke current token
2. BotFather немедленно деактивирует старый токен и выдаст новый
3. Обновите токен в конфигурации OpenClaw и перезапустите сервис
4. Если токен был в Git: используйте git-filter-repo или обратитесь к администратору репозитория для очистки истории

Мониторинг несанкционированного доступа. Gateway записывает Telegram ID каждого отправителя. Регулярно проверяйте логи на наличие неизвестных ID:

openclaw logs --channel telegram | grep "unauthorized"

Webhook security secret. При использовании webhook параметр secret критически важен. Telegram добавляет его как заголовок X-Telegram-Bot-Api-Secret-Token в каждый запрос. Gateway проверяет этот заголовок -- если он отсутствует или не совпадает, запрос отклоняется. Это защищает от атак, при которых злоумышленник напрямую отправляет POST-запросы на ваш webhook URL, минуя серверы Telegram. Генерируйте secret случайным образом: минимум 32 символа, буквы и цифры.

Telegram позволяет зарегистрировать список команд, которые отображаются как меню при вводе «/» в чате с ботом. Это улучшает UX: пользователи видят доступные команды без необходимости их запоминать.

Регистрация команд через @BotFather. Отправьте @BotFather команду /setcommands, выберите вашего бота, затем введите список команд в формате «команда -- описание» (одна команда на строку):

help - Показать справку по использованию
clear - Очистить историю диалога
status - Статус агента и подключённых инструментов
stop - Остановить текущую задачу
btw - Добавить контекст к текущей задаче
memory - Показать активные воспоминания агента

Обработка команд в OpenClaw. OpenClaw автоматически обрабатывает стандартные команды. Поведение команд настраивается в конфигурации:

channels:
  telegram:
    commands:
      /help:
        action: "send_help_message"
        message: "Я AI-агент. Просто напишите мне что нужно сделать."
      /clear:
        action: "clear_context"
        confirm: true
      /status:
        action: "send_status"
        include: ["uptime", "model", "tools_count"]
      /stop:
        action: "stop_current_task"
      /memory:
        action: "show_memory_summary"

Команда /stop. Особенно полезна для длинных задач: если агент выполняет долгую задачу (поиск, анализ большого файла), /stop немедленно прерывает выполнение. Добавлена в OpenClaw v2026.5 вместе с /btw.

Команда /btw (by the way). Позволяет добавить контекст к уже выполняющейся задаче. Например, если агент ищет информацию и вы вспомнили дополнительное условие -- /btw уточните временной период -- агент учтёт это без необходимости перезапускать задачу с нуля.

Кастомные команды. Вы можете добавить собственные команды, которые выполняют произвольные действия через OpenClaw tools:

channels:
  telegram:
    commands:
      /weather:
        action: "run_tool"
        tool: "weather"
        args: {"location": "auto"}
      /news:
        action: "run_tool"
        tool: "news_digest"
        args: {"count": 5}

Версия v2026.6.1 (3 июня 2026) значительно улучшила форматирование ответов агента в Telegram. Базовая настройка через @BotFather при этом не изменилась. Вот что нового:

Примечание: базовая настройка Telegram (создание бота через @BotFather, получение токена, настройка в config.yaml) описана выше и не изменилась с выходом v2026.6.1.

Этот материал подготовлен командой AI-агентов AravanaAI и проверен главным редактором.

Версия v2026.6.10 включает все улучшения Telegram-интеграции из v2026.6.9 (стабильная обработка длинных сообщений, поддержка медиа-групп, улучшенная обработка ошибок при разрывах соединения), а также исправления регрессий модуля памяти, настройки email и переключения моделей. Inline-режим работает без задержек при переключении контекста.

Для production-развёртывания Telegram-бота рекомендуется v2026.6.10. Регрессии v2026.6.9 (модуль памяти, email-конфиг, переключение моделей) исправлены. Настройки Telegram (токен, webhook) совместимы между версиями.

Обновление до v2026.6.10: `npm install -g openclaw@2026.6.10` или `npx openclaw@2026.6.10`. Настройки Telegram (токен, webhook) сохраняются при обновлении автоматически.

OpenClaw v2026.6.11 устранил критическую проблему с цепочками ответов в Telegram. Суть ошибки: при изменении контекста разговора (переключение модели, очистка истории, переход к новой теме) кешированные ответы теряли привязку к исходным сообщениям. В результате reply-цепочки «разрывались»: агент отвечал на сообщение, но Telegram не показывал его как ответ на конкретное сообщение пользователя.

Что исправлено: теперь кешированные reply-ответы сохраняют привязку к исходному сообщению даже после изменения контекста. Цепочки ответов работают корректно во всех сценариях: переключение модели в середине разговора, использование команды /clear, изменение профиля агента.

Обновление до v2026.6.11 рекомендуется всем пользователям, активно использующим reply-функцию Telegram:

npm install -g openclaw@2026.6.11

Настройки Telegram (токен, webhook, allowed_users) сохраняются при обновлении без изменений.

Версия v2026.7.1, выпущенная 6 июля 2026, делает функцию Codex Pairing стабильной. Она позволяет управлять активными Codex-сессиями прямо из Telegram-бота: запускать задачи кодирования на удалённом сервере и получать результаты в Telegram без необходимости держать терминал открытым.

Как начать Codex Pairing сессию: в чате с Telegram-ботом OpenClaw введите команду:

/login

Бот запросит подтверждение и откроет Codex Pairing сессию. После этого вы можете отправлять задачи кодирования напрямую в Telegram-чат, и Codex будет их выполнять на вашем сервере.

Управление активными Codex-запусками из Telegram:

Форматирование ответов: финальные ответы Codex приходят в Telegram с сохранением Markdown-форматирования кода (блоки кода, имена файлов). Промежуточные обновления о прогрессе выводятся как черновики (draft messages), которые обновляются по мере выполнения.

Требования к версии: Codex Pairing доступна в стабильной версии v2026.7.1 и выше. Установка: npm install -g openclaw@2026.7.1 (или актуальная версия). Установка через @next больше не требуется. Одновременно поддерживается только одна активная Codex Pairing сессия на бота.

Настройка в config.yaml: для включения Codex Pairing в Telegram-канале:

channels:
  telegram:
    codex_pairing:
      enabled: true
      require_login: true

Параметр require_login: true требует явной команды /login для каждой сессии -- рекомендуется для безопасности, особенно если allowed_users содержит несколько ID.

Этот материал подготовлен командой AI-агентов AravanaAI и проверен главным редактором.