OpenClaw в Telegram: как подключить AI-агента к мессенджеру

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

В этой статье — подробная инструкция по подключению OpenClaw к Telegram. Разберём каждый шаг: от создания бота до первого запроса.

Зачем подключать OpenClaw к Telegram

Подключение к Telegram даёт несколько ключевых преимуществ:

• Мобильный доступ: управляйте AI-агентом с телефона, планшета или любого устройства, где есть Telegram
• Удалённое управление: давайте команды компьютеру, даже когда вы далеко от него
• Групповые чаты: добавьте бота в рабочий чат, и он поможет всей команде
• Уведомления: агент отправит вам сообщение, когда задача будет выполнена
• Мультимедиа: отправляйте фотографии, документы, голосовые — агент всё обработает
• Привычный интерфейс: не нужно осваивать новое приложение, всё в знакомом мессенджере

Что потребуется

Для подключения OpenClaw к Telegram вам нужно:

1. Установленный OpenClaw или AI Magic Hub на компьютере (Windows, macOS или Linux)
2. Аккаунт Telegram (любой, включая бесплатный)
3. Токен Telegram-бота (создадим на следующем шаге)
4. API-ключ для AI-модели (Claude, GPT или Gemini)

Шаг 1: Создание Telegram-бота через @BotFather

Telegram-бот — это специальный аккаунт, через который OpenClaw будет получать и отправлять сообщения. Создать бота просто:

1. Откройте Telegram и найдите @BotFather (официальный бот Telegram для создания ботов)
2. Отправьте команду /newbot
3. Введите имя бота (отображаемое название, например «Мой AI Ассистент»)
4. Введите username бота (должен заканчиваться на «bot», например my_ai_assistant_bot)
5. BotFather выдаст вам токен — длинную строку вида 123456789:ABCdefGHIjklMNOpqrsTUVwxyz

Важно: сохраните токен в надёжном месте. Не публикуйте его и не отправляйте другим людям. Токен даёт полный контроль над ботом.

Дополнительные настройки бота

Пока вы в BotFather, можно настроить:

• /setdescription — описание бота (видно при первом открытии)
• /setabouttext — текст «О боте»
• /setuserpic — аватарка бота
• /setcommands — список команд (необязательно, OpenClaw понимает обычный текст)

Шаг 2: Подключение бота к OpenClaw

Через AI Magic Hub (рекомендуется)

1. Откройте AI Magic Hub
2. Перейдите в «Настройки» → «Каналы» → «Telegram»
3. Вставьте токен бота
4. Нажмите «Подключить»
5. Готово! Бот начнёт отвечать на сообщения

Через командную строку

Если вы используете OpenClaw напрямую, добавьте токен в конфигурацию:

В файле ~/.openclaw/config.yaml добавьте:

telegram:
  token: "ваш_токен_здесь"
  allowedUsers: ["ваш_telegram_id"]

Затем перезапустите OpenClaw. Бот появится в сети и начнёт принимать сообщения.

Шаг 3: Настройка безопасности

По умолчанию бот будет отвечать только вам — это правильно. Но стоит убедиться в дополнительных мерах безопасности:

Ограничение доступа

В конфигурации OpenClaw укажите свой Telegram ID в поле allowedUsers. Это гарантирует, что только вы можете отправлять команды агенту.

Чтобы узнать свой Telegram ID, напишите боту @userinfobot или @getmyid_bot.

Режимы доступа в группах

• requireMention — бот отвечает только когда его @упомянут. Подходит для рабочих чатов.
• open — бот отвечает на все сообщения. Подходит для личного чата.

Безопасность данных

OpenClaw работает на вашем компьютере. Сообщения проходят через Telegram API, но сам агент выполняет команды локально. Подробнее — в статье безопасность данных при работе с AI.

Шаг 4: Первые команды

После подключения попробуйте отправить боту несколько сообщений:

• «Привет! Как тебя зовут?» — проверка базовой работы
• «Сколько файлов на моём рабочем столе?» — проверка доступа к файлам
• «Найди в интернете курс доллара на сегодня» — проверка веб-поиска
• «Создай файл notes.txt с текстом 'Тестовая заметка'» — проверка записи файлов

Если всё работает — поздравляем! У вас полнофункциональный AI-ассистент в Telegram.

Продвинутые возможности Telegram-интеграции

Голосовые сообщения

OpenClaw умеет обрабатывать голосовые сообщения. Отправьте голосовое — агент распознает речь и выполнит запрос. Можно также настроить голосовые ответы (TTS).

Работа с файлами

Отправьте документ, фотографию или видео в чат — OpenClaw обработает их. Например, отправьте PDF и попросите «Сделай краткое содержание этого документа».

Групповые чаты

Добавьте бота в групповой чат вашей команды. Коллеги смогут обращаться к агенту через @mention. Полезно для совместной работы.

Уведомления

Настройте heartbeat — OpenClaw будет периодически проверять почту, календарь и присылать вам уведомления в Telegram о важных событиях.

Частые проблемы и решения

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

• Убедитесь, что OpenClaw запущен на компьютере
• Проверьте токен — скопируйте из BotFather заново
• Проверьте, что ваш Telegram ID добавлен в allowedUsers
• Проверьте интернет-соединение

Бот отвечает с задержкой

Небольшая задержка (2–5 секунд) нормальна — это время обработки AI-моделью. Если задержка больше 30 секунд, проверьте баланс API-ключа.

Бот отвечает только на английском

Проверьте настройки в SOUL.md или AGENTS.md — добавьте инструкцию «Отвечай на русском языке».

Читайте также: что такое OpenClaw, настройка OpenClaw с нуля, OpenClaw vs ChatGPT.