Русский 
English 
Deutsch 
Español 
Italiano 
Français 
Português do Brasil 
Tiếng Việt 
ไทย 
Bahasa Indonesia 
العربية 
हिन्दी 
Содержание
OpenClaw — это фреймворк ИИ-агентовс открытым исходным кодом, который умеет автоматизировать задачи в таких мессенджерах, как Slack, Discord, WhatsApp и Telegram. Одна из главных причин, по которым OpenClaw стал популярен, в том, что он превращает большие языковые модели в агенты — программные продукты, которые могут работать часами или днями, выполнять сложные последовательности действий и сохранять контекст в нескольких каналах. Telegram с его богатым Bot API и поддержкой обсуждений в ветках подходит идеально. Однако настройка OpenClaw в Telegram и использование режима веток неочевидны многим новым пользователям. В этой статье приведено пошаговое руководство по подключению ассистента к Telegram, объясняется, как режим веток работает изнутри, приведены практические примеры использования, а в конце — советы и рекомендации по устранению неполадок. Вся информация в этом руководстве взята из официальной документации OpenClaw и опыта сообщества.
Почему Telegram?
Telegram популярен, потому что поддерживает ботов, групповые чаты, приватные каналы и ветки в стиле форума. Платформа предлагает щедрый лимит длины сообщения (4096 символов), загрузку медиафайлов, эмодзи-реакции и встроенные клавиатуры. В отличие от некоторых мессенджеров, Bot API Telegram бесплатен, стабилен и хорошо документирован. Слой шлюза OpenClaw обеспечивает полноценную поддержку Telegram; интеграция готова к работе с личными сообщениями ботов и группами и работает через long polling или вебхуки. Иными словами, после правильной настройки ваш ассистент будет надёжно отправлять и получать сообщения без необходимости писать собственный код.
Настройка OpenClaw для работы с Telegram
1. Создайте бота и получите токен API
Откройте Telegram и начните чат с официальным @BotFather ботом. Выполните /newbot, выберите имя и имя пользователя и скопируйте токен, который он вернёт. Этот токен вы вставите в конфигурацию OpenClaw. Боты Telegram полностью управляются через BotFather; позже можно использовать /setprivacy и /setjoingroups чтобы переключать поведение в группах.
2. Настройте OpenClaw
Откройте openclaw.json файл конфигурации (обычно он находится в ~/.openclaw) и добавьте telegram раздел в channels ключ:
{
"channels": {
"telegram": {
"enabled": true,
"botToken": "123:abc",
"dmPolicy": "pairing",
"groups": { "*": { "requireMention": true } }
}
}
}
Этот botToken содержит токен, полученный от BotFather. Поле dmPolicy управляет тем, как ваш ассистент будет отвечать на личные сообщения: pairing (по умолчанию) означает, что бот будет отвечать только на личные сообщения от пользователей, которых вы одобрите; open разрешает всем; allowlist ограничивает доступ конкретным списком ID пользователей; а disabled отключает поддержку личных сообщений. Флаг requireMention важен для групп: если задать true, бот отвечает только когда упоминают его имя пользователя, и не отвечает на каждое сообщение в оживлённом групповом чате.
3. Запустите шлюз и привяжите аккаунт
После сохранения конфигурации выполните openclaw gateway чтобы запустить шлюз сообщений. Затем нужно подтвердить свой аккаунт Telegram: сгенерировать код привязки и подтвердить его. В отдельном терминале выполните openclaw pairing list telegram чтобы увидеть ожидающие запросы, затем подтвердите свой ID пользователя с помощью openclaw pairing approve telegram <CODE>. Коды действуют один час, поэтому выполните этот шаг сразу. После привязки сообщения из вашего аккаунта Telegram будут направляться вашему агенту OpenClaw.
4. Добавьте бота в группы и темы
Чтобы ассистент мог участвовать в групповых чатах или темах форума, добавьте его в нужные группы Telegram, затем обновите channels.telegram.groups в конфигурации. Например:
"channels": {
"telegram": {
"groups": {
"-100123456789": { "requireMention": true },
"*": { "requireMention": false }
},
"groupPolicy": "allowlist"
}
}
Здесь * запись служит правилом по умолчанию для любой группы; requireMention: true гарантирует, что ассистент не будет спамить в канал. Также можно задать groupPolicy до open чтобы бот автоматически вступал в любую группу, которая его приглашает, или disabled чтобы полностью запретить использование групп. После настройки групп перезапустите шлюз и заново добавьте бота в каждую группу, если вы изменили настройки конфиденциальности.
Как работает режим тем
Telegram представил темы форумов в 2022 году, позволив большим группам разделять беседы на отдельные ветки. OpenClaw использует эту возможность, добавляя :topic:<threadId> к внутренним ключам сессий. Это значит, что у каждой темы свой контекст беседы; сообщения из одной ветки не попадают в другую. Из такой схемы следуют две важные особенности:
- Изоляция тем: Когда ассистент получает сообщение с
message_thread_id, он использует ключ сессии видаtelegram:<chatId>:topic:<threadId>. Ответы отправляются в ту же ветку. Так агент сохраняет контекст в долгих обсуждениях с множеством веток. - Общая тема и отдельная тема: Telegram считает ID ветки 1 темой “general” по умолчанию. При отправке сообщений в ветку 1 нужно опустить
message_thread_idв вызове API; иначе Telegram отклонит его. OpenClaw делает это автоматически при отправке ответов.
Режим тредов не ограничен форумными супергруппами. В личных чатах (ЛС) Telegram иногда прикрепляет message_thread_id к ответам на более старые сообщения. OpenClaw сохраняет этот ID и использует ключи сессий с учётом тредов, поэтому история вашего разговора остаётся упорядоченной даже в ЛС.
Настройка режима ответов
По умолчанию OpenClaw устанавливает channels.telegram.replyToMode до выкл., что отключает неявное создание ответов в ветке. Если вы хотите, чтобы ассистент отвечал прямо на сообщение, которое его вызвало, задайте replyToMode до first или все. Также можно добавлять явные теги, например [[reply_to_current]] или [[reply_to:<messageId>]] в ответе агента. Эти теги указывают gateway, в какую ветку направить ответ.
Потоковые ответы и индикаторы набора
OpenClaw поддерживает потоковую отправку частичных ответов в Telegram. Если задать для channels.telegram.streaming значение partial или progress, gateway отправляет временное сообщение и редактирует его по мере того, как модель генерирует текст. Так длинные ответы воспринимаются лучше. Можно даже включить вывод рассуждений в реальном времени с помощью команды /reasoning stream в ходе разговора. Индикаторы набора отправляются автоматически, в том числе в ветках; однако для ветки с ID 1 (общая тема) Telegram игнорирует message_thread_id в действии набора текста.
Реакции, стикеры и инлайн-команды
Bot API Telegram поддерживает реакции на сообщения, стикеры и инлайн-кнопки. OpenClaw предоставляет эти возможности через свою систему действий:
- Реакции: Этот
reactпозволяет агенту поставить на сообщение реакцию в виде эмодзи. Уведомления о реакциях настраиваются черезchannels.telegram.reactionNotificationsиreactionLevel, чтобы включить уведомления для сообщений бота, для всех сообщений или отключить их. Учтите, что Telegram не передаёт ID веток для реакций, поэтому они всегда попадают в основную ветку. - Стикеры: Включите действия со стикерами, задав
channels.telegram.actions.sticker: true. Стикеры кэшируются локально; искать по кэшу можно с помощью действияsticker-searchа для отправки стикера — действиемsticker. - Инлайн-кнопки: Настройте
channels.telegram.capabilities.inlineButtonsчтобы определить, когда разрешены инлайн-клавиатуры (off, dm, group, all или allowlist). После этого можно отправить сообщение с кнопками, добавив в тело действия массивbuttonsв тело действия.
Сценарии использования режима веток
Режим веток открывает мощные рабочие процессы, которые в одном чате были бы запутанными или невозможными. Вот несколько практических сценариев:
1. Координация нескольких проектов
Представьте, что вы ведёте несколько проектов одновременно. Создайте одну супергруппу Telegram и включите темы форума. Для каждого проекта создайте отдельную тему (например, Редизайн сайта, Маркетинговая кампания, Исправление ошибок). Когда вы пишете ассистенту внутри темы, OpenClaw автоматически использует уникальный ключ сессии для этой ветки. Контекст разговора остаётся отдельным, поэтому на вопрос «какой срок?» ассистент понимает, о каком проекте идёт речь.
2. Личные ответвления в групповых чатах
В оживлённом семейном или рабочем чате иногда нужно задать ассистенту вопрос, не прерывая основное обсуждение. Ответьте на своё прежнее сообщение или упомяните бота в ответе; Telegram добавляет message_thread_id, и OpenClaw направляет разговор в ветку, привязанную к этому сообщению. Теперь можно задавать уточняющие вопросы вроде «Что у меня в списке дел?» или «Сделай сводку сегодняшних сообщений», не засоряя основной чат.
3. Длительные задачи
Некоторые задачи требуют времени: пересказ длинного документа, подготовка отчёта или запуск скрипта. Если запускать такие задачи в отдельной ветке, обновления о ходе работы остаются упорядоченными. Задайте channels.telegram.streaming до progress чтобы ассистент отправлял предварительное сообщение и редактировал его, пока не будет готов окончательный результат. Если у вас несколько долгих задач, каждая ветка остаётся изолированной, что предотвращает пересечение обсуждений.
4. Сессии мозгового штурма
Темы форума могут служить комнатами для мозгового штурма. Например, создайте тему под названием Идеи для блога и вместе с агентом обсудите идеи для статей. Ассистент будет помнить предыдущие предложения в рамках ветки, поэтому идеи проще уточнять и развивать. При этом общий чат остаётся чистым.
5. Поддержка клиентов или FAQ
Если вы ведёте чат сообщества, можно создать отдельные темы для разных вопросов поддержки. Пользователи задают вопросы в своих ветках, а ваш агент OpenClaw отвечает с учётом конкретной темы. Поскольку ключи сессий привязаны к веткам, агент не перепутает ответы. Можно даже делегировать задачи: в качестве дальнейших действий агент может завести issue в GitHub или создать события в календаре.
Устранение неполадок и советы
Режим конфиденциальности: По умолчанию боты Telegram работают в режиме конфиденциальности, то есть видят только сообщения, которые начинаются с / команд или упоминают их. Если в группе нужна видимость всех сообщений, отключите конфиденциальность через /setprivacy или сделайте бота администратором. Не забудьте удалить и снова добавить бота, чтобы изменения вступили в силу.
Ограничения истории: OpenClaw хранит ограниченную историю для каждого чата или ветки (по умолчанию 50 сообщений для групп; настраивается через channels.telegram.historyLimit). Увеличьте это ограничение, если агенту нужно больше контекста, но следите за расходом памяти.
Webhook или long polling: По умолчанию OpenClaw использует long polling, который проще настроить. Если вы хотите применять webhook (например, чтобы снизить задержку), задайте channels.telegram.webhookUrl и webhookSecret. Параметры порта и хоста смотрите в документации.
Явные теги ответа: Используйте [[reply_to_current]] или [[reply_to:<id>]] в ответах агента, когда нужен точный контроль над тем, на какое сообщение отвечать. Это особенно помогает ботам, которые одновременно отслеживают несколько веток.
Управление доступом: Используйте channels.telegram.allowFrom и groupPolicy чтобы ограничить, кто может общаться с вашим ботом и в какие группы он может вступать. Это защищает от спама и несанкционированных команд.
Заключение
Telegram — одна из самых универсальных платформ для работы агента OpenClaw. Понимая, как устроен режим веток, и правильно настраивая группы и личные сообщения, вы сможете вести насыщенные беседы с несколькими контекстами, не теряя порядка. Используйте ветки, чтобы разделять проекты, запускать долгие задачи, проводить мозговые штурмы или оказывать поддержку клиентам. Задействуйте такие возможности, как потоковые предпросмотры, встроенные кнопки и уведомления о реакциях, чтобы общение было живым. При правильной настройке ваш ассистент OpenClaw станет естественным участником вашего сообщества в Telegram.
