Подключите AI-ассистента Clawdbot к Telegram для интеллектуальной автоматизации ботов, умных сообщений и разговоров на базе ИИ в Telegram.

Обзор интеграции Clawdbot с Telegram

Интеграция Clawdbot с Telegram позволяет вам подключить вашего персонального AI-ассистента к Telegram, используя Bot API через grammY. Это готово для продакшена в личных сообщениях ботов и группах, с long-polling по умолчанию и опциональной поддержкой webhook.

Почему стоит использовать Clawdbot с Telegram?

Telegram предлагает мощные API для ботов и функции конфиденциальности. Интеграция Clawdbot с Telegram предоставляет:

Функция	Преимущество Clawdbot Telegram
Интеграция Bot API	Clawdbot Telegram использует нативный Telegram Bot API через grammY
Inline-режим	Clawdbot Telegram поддерживает inline-запросы
Поддержка групп	ЛС разделяют основную сессию; группы остаются изолированными
Потоковая передача черновиков	Передавайте частичные ответы в ЛС Telegram
Ориентация на приватность	Clawdbot работает локально, ваши данные Telegram остаются приватными

Быстрая настройка (для начинающих)

Создайте бота через @BotFather (прямая ссылка)
Убедитесь, что это именно @BotFather, затем скопируйте токен
Установите токен через env (TELEGRAM_BOT_TOKEN=...) или config (channels.telegram.botToken)
Запустите шлюз
Доступ через ЛС по умолчанию требует сопряжения; подтвердите код сопряжения при первом контакте

Минимальная конфигурация:

{
  "channels": {
    "telegram": {
      "enabled": true,
      "botToken": "123:abc",
      "dmPolicy": "pairing"
    }
  }
}

Настройка Clawdbot Telegram

Предварительные требования

Перед подключением Clawdbot к Telegram убедитесь, что у вас есть:

Clawdbot установлен на вашем устройстве
Аккаунт Telegram
Токен Telegram бота от @BotFather

Шаг 1: Создание Telegram бота

Создайте бота через BotFather Telegram:

Откройте Telegram и напишите @BotFather (прямая ссылка)
Убедитесь, что это именно @BotFather
Выполните /newbot, затем следуйте инструкциям (имя + имя пользователя, заканчивающееся на bot)
Скопируйте токен и сохраните его в безопасном месте

Опциональные настройки BotFather:

/setjoingroups — разрешить/запретить добавление бота в группы
/setprivacy — контролировать, видит ли бот все сообщения группы

Шаг 2: Настройка токена

Установите токен через переменную окружения или конфиг:

Переменная окружения:

TELEGRAM_BOT_TOKEN=123:abc

Файл конфигурации (~/.clawdbot/clawdbot.json):

{
  "channels": {
    "telegram": {
      "enabled": true,
      "botToken": "123:abc",
      "dmPolicy": "pairing",
      "groups": {
        "*": { "requireMention": true }
      }
    }
  }
}

Если установлены и env, и config, приоритет имеет config.

Шаг 3: Запуск шлюза

clawdbot gateway --port 18789

Telegram запускается, когда токен разрешён (сначала config, env как резерв).

Шаг 4: Проверка подключения

Проверьте статус вашего Clawdbot Telegram:

clawdbot channels status telegram

Токен + Приватность + Разрешения

Создание токена (BotFather)

/newbot создаёт бота и возвращает токен (держите его в секрете)
Если токен утёк, отзовите/перегенерируйте через @BotFather и обновите ваш конфиг

Видимость сообщений группы (Режим приватности)

Боты Telegram по умолчанию находятся в Режиме приватности, который ограничивает, какие сообщения группы они получают. Варианты:

Отключите режим приватности с помощью /setprivacy
Добавьте бота как администратора группы (боты-администраторы получают все сообщения)

Примечание: Когда вы переключаете режим приватности, Telegram требует удаления + повторного добавления бота в каждую группу, чтобы изменение вступило в силу.

Входящие сообщения нормализуются в общий конверт канала с контекстом ответа и заполнителями медиа
Ответы в группах по умолчанию требуют упоминания (нативное @упоминание или настроенные паттерны)
Ответы всегда маршрутизируются обратно в тот же чат Telegram
Long-polling использует grammY runner с последовательной обработкой для каждого чата

Потоковая передача черновиков

Clawdbot может передавать частичные ответы в ЛС Telegram, используя sendMessageDraft.

Требования:

Режим Threaded включён для бота в @BotFather (режим форумных тем)
Только приватные чатовые треды
channels.telegram.streamMode не установлен в "off"

Потоковая передача черновиков только для ЛС; Telegram не поддерживает её в группах или каналах.

Форматирование (Telegram HTML)

Исходящий текст Telegram использует parse_mode: "HTML"
Markdown-подобный ввод рендерится в безопасный для Telegram HTML
Сырой HTML от моделей экранируется для избежания ошибок парсинга Telegram

Команды

Clawdbot Telegram поддерживает пользовательские команды:

Команда	Действие Clawdbot Telegram
`/start`	Приветственное сообщение от Clawdbot
`/help`	Меню справки Clawdbot Telegram
`/ask`	Прямой вопрос к Clawdbot

Конфигурация Clawdbot Telegram

Полный пример конфигурации

{
  "channels": {
    "telegram": {
      "enabled": true,
      "botToken": "123:abc",
      "dmPolicy": "pairing",
      "groups": {
        "*": { "requireMention": true }
      }
    }
  }
}

Управление доступом (ЛС + Группы)

Доступ к ЛС:

dmPolicy: "pairing" — Неизвестные отправители получают код сопряжения; подтвердите через CLI
dmPolicy: "allowlist" — Отвечать только пользователям из белого списка
dmPolicy: "open" — Отвечать всем (не рекомендуется)

Доступ к группам:

Установите channels.telegram.groups с ключом по id группы или "*" для всех групп
Используйте requireMention: true для ответа только при упоминании

Поиск вашего ID пользователя Telegram

Используйте @userinfobot или похожих ботов для получения вашего числового ID пользователя Telegram.

Хранение учётных данных Clawdbot Telegram

Clawdbot безопасно хранит учётные данные Telegram:

~/.clawdbot/credentials/telegram/bot_token
~/.clawdbot/credentials/telegram/session.json

Ваши данные Clawdbot Telegram остаются на вашей локальной машине.

Устранение неполадок Clawdbot Telegram

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

Если ваш бот Clawdbot Telegram не отвечает:

Проверьте токен: clawdbot channels verify telegram
Проверьте статус бота через @BotFather
Просмотрите логи: cat /tmp/clawdbot/telegram.log

Активация в группе

Чтобы активировать Clawdbot в группе:

Через конфиг (рекомендуется):

{
  "channels": {
    "telegram": {
      "groups": {
        "<group_id>": { "requireMention": true }
      }
    }
  }
}

Через команду (уровень сессии): Используйте /activate в чате группы.

Получение ID группового чата

Перешлите сообщение из группы @userinfobot или используйте Telegram API.

Лучшие практики Clawdbot Telegram

Используйте режим сопряжения: Безопасно по умолчанию с кодами сопряжения
Настройте режим приватности: Настройте в @BotFather в соответствии с вашими потребностями
Обрабатывайте лимиты скорости: Реализуйте надлежащее ограничение скорости
Мониторьте использование: Отслеживайте аналитику бота Clawdbot Telegram

Дальнейшие шаги

Интеграция Clawdbot с WhatsApp - Подключите Clawdbot к WhatsApp
Интеграция Clawdbot с Discord - Настройте Clawdbot в Discord
Руководство по настройке Clawdbot - Полное руководство по установке

Интеграция Clawdbot с Telegram