Claude-бот в Telegram: схема, шаги и проверка

Claude-бот обычно означает Telegram-бота, который принимает сообщение, передаёт его вашему серверу, вызывает Claude API и возвращает ответ. Для рабочего результата нужны два отдельных токена, серверная логика, ограничение доступа и журнал ошибок. Вставлять ключ Anthropic или токен Telegram в страницу, приложение пользователя или публичный репозиторий нельзя.

Из каких частей состоит бот

Telegram отвечает за доставку сообщений, ваш сервер проверяет пользователя и хранит состояние, Claude формирует ответ через Messages API. Официальная документация Anthropic описывает POST /v1/messages: запрос содержит модель, лимит ответа и список сообщений, а результат возвращается структурированными блоками. Актуальная схема приведена в Claude API Reference.

• Бот Telegram с токеном от BotFather.
• Сервер или облачная функция, которая работает постоянно.
• Ключ Anthropic, доступный только серверу.
• Хранилище разрешённых пользователей и короткой истории диалога.
• Ограничения на длину, частоту и тип входных сообщений.
• Понятный ответ при недоступности одного из сервисов.

Секреты хранятся на сервере. Если ключ можно увидеть в исходном коде страницы или мобильного приложения, его нужно считать раскрытым и заменить.

Карта результата до разработки

Опишите один сценарий: кто пишет, какую задачу решает бот, какие данные можно отправлять, что считается хорошим ответом и когда нужен оператор. Не начинайте с «бот умеет всё». Узкий сценарий проще проверить, ограничить и оплачивать.

1. Выберите один тип задачи, например ответы по открытой базе знаний.
2. Запишите допустимые и запрещённые данные.
3. Определите, кто имеет доступ: все, список пользователей или сотрудники.
4. Задайте максимальный размер сообщения и длину истории.
5. Опишите проверку результата и сообщение при ошибке.
6. Только после этого создайте токены и серверный обработчик.

Для общей архитектуры ИИ-ботов пригодится пошаговый разбор создания ИИ-бота. Здесь фокус уже: безопасно связать два официальных API и не перепутать роль каждого компонента.

Создайте Telegram-бота

Telegram предлагает зарегистрировать бота у @BotFather командой /newbot, получить токен и обращаться к Bot API по HTTPS. Официальный учебник также предупреждает хранить токен как пароль и не делиться им. Шаги опубликованы в руководстве Telegram.

1. Откройте официальный @BotFather и выполните /newbot.
2. Задайте понятное имя и свободное имя пользователя бота.
3. Сохраните токен в менеджере секретов или переменной окружения сервера.
4. Отправьте боту /start, чтобы появился тестовый диалог.
5. Получите первое обновление через webhook или long polling.
6. Не публикуйте полный объект обновления в общий журнал, если там есть личные сообщения.

Токен Telegram и ключ Anthropic не взаимозаменяемы. Первый управляет ботом, второй разрешает вызовы модели. Для понимания отдельных этапов регистрации используйте инструкцию по BotFather.

По теме: Как удалить созданного бота в Telegram в 2026: BotFather пошагово

Вызовите Claude только с сервера

Anthropic рекомендует задавать ключ через переменную окружения и отправлять сообщение серверным SDK или HTTP-запросом. Начальный пример и требования к ключу опубликованы в официальном quickstart. Не фиксируйте название модели из случайного примера навсегда: вынесите его в настройку и сверяйте с текущей документацией.

TELEGRAM_BOT_TOKEN=...
ANTHROPIC_API_KEY=...

1. Получить сообщение Telegram
2. Проверить chat_id и размер текста
3. Сформировать короткий список messages
4. Вызвать POST /v1/messages
5. Извлечь текстовый блок ответа
6. Отправить ответ через sendMessage

Псевдокод намеренно не содержит настоящих токенов. В рабочей версии добавьте таймаут, повтор только для безопасных временных ошибок и единый идентификатор запроса. Не повторяйте запрос после неопределённого сбоя бесконечно: вы можете получить дубли и лишний расход.

Как хранить контекст диалога

Messages API допускает передачу нескольких чередующихся сообщений, но историю собирает ваше приложение. Для каждого диалога храните только необходимый контекст, ограничивайте объём и давайте команду очистки. Не считайте Telegram архивом для серверной памяти.

• Системное правило с ролью и границами бота.
• Последние релевантные реплики, а не весь чат навсегда.
• Идентификатор пользователя без лишних личных данных.
• Время последней активности и срок удаления истории.
• Флаг передачи оператору при запрещённой или рискованной задаче.

Для бота по документам храните источник ответа отдельно и просите модель ссылаться на него. Для свободного собеседника заранее скажите, что ответы могут ошибаться. Если нужна общая разница между ботом и агентом, используйте простое объяснение ИИ-агента.

По теме: Как создать бота для группы в Telegram в 2026: права и настройка

Проверка перед открытием доступа

Тестируйте не только счастливый путь. Создайте таблицу входа, ожидаемого ответа и допустимой реакции при отказе. Проверка должна доказать, что секреты не раскрываются, чужой пользователь не получает доступ, а длинное сообщение не кладёт обработчик.

• Разрешённый пользователь получает ответ по выбранному сценарию.
• Неизвестный пользователь получает нейтральный отказ без деталей системы.
• Пустое и слишком длинное сообщение обрабатываются предсказуемо.
• Команда очистки удаляет серверную историю диалога.
• При таймауте Claude бот сообщает о временном сбое и не зацикливает повторы.
• Токены не встречаются в ответах, журналах и исходном коде клиента.
• Сообщение с персональными данными не сохраняется дольше заявленного срока.

Диагностика по месту разрыва

Если Telegram не видит бота, проверьте регистрацию и токен. Если сообщения приходят, но ответа нет, проверьте webhook, журнал обработчика и таймаут. Если Claude возвращает отказ или ошибку, сохраните код и безопасную часть ответа, затем сверяйте форму запроса с официальной схемой.

• Нет обновлений: webhook указывает на недоступный адрес либо long polling уже запущен в другом процессе.
• Ответ приходит дважды: два обработчика получают одно событие или повтор не учитывает идентификатор update.
• Контекст перепутан: история хранится без разделения по диалогам.
• Бот зависает на длинном ответе: ограничьте вывод и делите отправку на безопасные части.
• Расход растёт: сокращайте историю и отсекайте повторные или служебные сообщения до вызова модели.
• Ключ раскрыт: отзовите его, создайте новый и только потом ищите источник утечки.

По теме: Как сделать, чтобы боту приходили сообщения: Telegram 2026

Когда Claude-бот не подходит

Не отправляйте через внешнюю модель медицинские, платёжные, кадровые или другие чувствительные данные без отдельной правовой и технической оценки. Бот также не подходит, если задача решается обычным меню, поиском или шаблонным ответом: модель добавит стоимость и непредсказуемость без пользы.

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

Частые вопросы

Можно ли сделать Claude-бота без сервера?

Для постоянной безопасной работы нужен серверный компонент или облачная функция. Иначе негде защищать ключи, принимать события и хранить состояние.

Можно ли вставить ключ Anthropic в JavaScript сайта?

Нет. Код браузера доступен посетителю. Вызов к Anthropic должен проходить через ваш сервер с проверкой доступа.

Где хранится память бота?

Её хранит ваше приложение или база. В каждом запросе вы передаёте нужный контекст по правилам Messages API.

Нужна ли отдельная подписка Claude?

Доступ к API и потребительская подписка являются разными продуктами. Перед запуском сверяйте условия API в официальной консоли Anthropic.