Подключение Telegram

Telegram — основной канал общения с AI-агентом OpenClaw. Чтобы начать, нужно создать бота через BotFather и подключить его к платформе.

Создание бота в BotFather

Откройте BotFather

Найдите в Telegram бота @BotFather (с синей галочкой) и откройте с ним чат.

Создайте нового бота

Отправьте команду /newbot. BotFather попросит выбрать:

Имя бота — отображаемое имя, например «Мой AI Помощник»
Username — уникальное имя, заканчивающееся на bot, например my_ai_helper_bot

Скопируйте токен

После создания бота BotFather отправит сообщение с токеном. Это строка вида:

7123456789:AAF1xxxxxxxxxxxxxxxxxxxxxxxxxxx

Скопируйте её целиком.

Вставьте токен в OpenClaw

Перейдите в личный кабинет, вставьте токен в поле и нажмите «Создать агента».

Режимы подключения Telegram

При создании агента вы выбираете, кто сможет общаться с вашим ботом:

Приватный режим (рекомендуется)

Бот отвечает только вам. Для настройки нужен ваш Telegram ID — узнать его можно, написав боту @userinfobot. Введите полученный числовой ID в поле при создании агента.

Это самый безопасный вариант: никто кроме вас не сможет использовать бота.

Открытый режим

Бот отвечает всем пользователям. Подходит для публичных ботов — например, служба поддержки или информационный ассистент. Telegram ID не требуется.

Автоматический паринг (pairing)

Если не указать Telegram ID и не выбрать открытый режим, бот использует механизм pairing: первый пользователь, написавший боту, автоматически становится его владельцем.

Что такое Telegram pairing

Pairing (сопряжение) — это процесс привязки Telegram-аккаунта к боту. Когда бот запускается в режиме pairing, он ждёт первое входящее сообщение и привязывается к отправителю.

Как это работает:

Вы создаёте агента без указания Telegram ID
Находите своего бота в Telegram и пишете ему любое сообщение
OpenClaw автоматически привязывает ваш аккаунт к боту
После привязки бот будет отвечать только вам

Важно. Если кто-то другой напишет боту раньше вас — он станет владельцем. Для гарантированного доступа используйте приватный режим с указанием Telegram ID.

Проверка работы

После создания агента (статус «Работает»):

Найдите вашего бота в Telegram по username, который вы задали
Нажмите «Начать» (Start)
Напишите любое сообщение — агент должен ответить

Настройка бота (опционально)

Вы можете настроить бота через @BotFather:

/setdescription — описание бота (видно при первом открытии)
/setabouttext — текст «О боте»
/setuserpic — аватар бота

Эти настройки влияют только на внешний вид бота в Telegram и не затрагивают работу агента.

Решение проблем

Бот не отвечает

Проверьте статус агента в личном кабинете — он должен быть «Работает»
Если статус «Создаётся» — подождите 1-2 минуты
Если статус «Ошибка» — удалите агента и создайте нового

Ошибка 1008 «pairing required»

Эта ошибка означает, что бот ждёт сопряжения с Telegram-аккаунтом. Напишите боту любое сообщение в Telegram — pairing произойдёт автоматически. Если ошибка сохраняется — удалите агента и создайте нового с указанием Telegram ID (приватный режим).

Бот отвечает другому пользователю

Это происходит, если кто-то написал боту раньше вас в режиме pairing. Удалите агента и создайте нового, указав свой Telegram ID для приватного режима.

Совет. Если у вас возникли проблемы с ботом, самый быстрый способ решения — удалить агента и создать нового с указанием Telegram ID в приватном режиме.

История: Clawdbot → MoltBook → OpenClaw

Если вы встречали названия Clawdbot (ClawdBot) или MoltBook (Moltbot) — это прежние названия проекта OpenClaw. Платформа прошла через два ребрендинга, но технология осталась той же: персональный AI-агент с Telegram-ботом, веб-чатом и браузером.

Все боты, созданные под старыми названиями, продолжают работать. Команда openclaw полностью совместима с прежним пакетом clawdbot.