Как подключить FoneClaw к боту Telegram: BotFather, токен и первая задача
Пошаговое руководство по подключению FoneClaw к личному боту Telegram: создать бота через BotFather, сохранить токен, привязать приватный чат, проверить задачу Android и разобрать частые ошибки подключения.
- Для подключения нужен отдельный Telegram-бот, созданный через официального @BotFather командой /newbot; токен бота нужно хранить как пароль и не отправлять посторонним.
- FoneClaw привязывает приватный чат к тому Telegram-аккаунту, который первым напишет вашему боту после сохранения токена; отправьте hello в течение десяти минут и дождитесь подтверждения.
- Успешная переписка с ботом еще не означает выполненное Android-действие: после первой команды проверьте результат в FoneClaw и на телефоне, включая разрешения и применимые подтверждения.
- Если подключение не работает, различайте неверный токен, неправильного бота, уже занятый бот, сетевую ошибку и конфликт webhook; удаление webhook останавливает текущую доставку в другой сервис.
Создайте отдельного бота Telegram
Чтобы подключить FoneClaw к боту Telegram, вам нужен именно бот, а не доступ ко всему личному Telegram-аккаунту. Такой бот становится отдельным входом для приватной переписки с FoneClaw: вы пишете команду боту, а FoneClaw обрабатывает поддерживаемую задачу на Android с учетом текущих разрешений и подтверждений. Если вам нужно управлять уже открытым Telegram голосом на телефоне, это другой сценарий; его лучше смотреть отдельно в материале Голосовое управление Telegram.
Создавайте бота через официального Telegram BotFather. В Telegram откройте @BotFather, отправьте команду /newbot, задайте имя и имя пользователя бота, затем сохраните выданный токен. Токен не является паролем от вашего личного Telegram-аккаунта и не является кодом входа в Telegram. Он подтверждает доступ к самому боту, поэтому обращайтесь с ним как с паролем: не публикуйте, не пересылайте в общие чаты и не вставляйте в сторонние сервисы без необходимости.
Лучше создать отдельного бота только для FoneClaw. Так проще избежать конфликта с другим сервисом, который уже использует того же бота, и легче понять, где возникла ошибка. Один бот, один сценарий подключения и один приватный чат дают самый предсказуемый старт.
Привяжите свой приватный аккаунт
После создания бота откройте в FoneClaw Telegram Connections — раздел подключений Telegram. В поле BotFather token вставьте токен, который вы получили от @BotFather, и нажмите Save bot token, чтобы сохранить токен бота.
После сохранения токена откройте в Telegram своего нового бота, а не @BotFather. Отправьте ему ровно hello в течение десяти минут. Затем дождитесь подтверждения привязки. Важно, что привязка работает для приватных чатов: FoneClaw связывает подключение с тем Telegram-аккаунтом, который первым отправил сообщение этому боту после сохранения токена.
Если первым написал не тот аккаунт, используйте новое отдельное подключение с новым выделенным ботом для нужного аккаунта. Если вы отправили сообщение BotFather, а не своему боту, FoneClaw не сможет привязать нужный приватный чат. Если десятиминутное окно истекло, нажмите Connect this chat на телефоне, затем отправьте hello своему боту в новом указанном десятиминутном окне и дождитесь подтверждения. Не добавляйте бота в группу или канал для первого теста: этот сценарий рассчитан на приватную переписку.
Проверьте первый результат на Android
После подтверждения подключения начните с простой задачи без даты. Например, напишите боту: «Сохрани задачу: проверить договор с Анной». В запросе нет дня, даты или относительного времени, поэтому правильный результат — обычная задача без срока, которую нужно увидеть в списке задач.
Успешная доставка сообщения через Telegram еще не доказывает, что Android-действие выполнено. Проверьте результат в FoneClaw: задача должна быть сохранена с понятной формулировкой и без выдуманной даты. Если действие требует разрешения или подтверждения на телефоне, проходите этот шаг в FoneClaw или в Android, а не считайте, что одно сообщение в Telegram уже выдало все права.
Для первого запуска FoneClaw на телефоне полезно держать под рукой руководство Как начать пользоваться FoneClaw на Android бесплатно. А если вам важно, как работают задачи без срока и перенос даты позже, смотрите подробный разбор ИИ-задача Android без даты: сохранить и перенести срок.
Когда первая задача сохранена, можно пробовать более конкретные поддерживаемые действия. Но проверяйте их по итоговому месту результата: задача в списке, событие в календаре, открытый экран или другое видимое изменение на телефоне.
Разберите конкретную ошибку подключения
Ошибки подключения лучше разбирать по виду проблемы, а не повторять все шаги заново. Самые частые случаи такие:
| Что видно | Что это обычно означает | Что сделать |
|---|---|---|
| Токен отклонен | Скопирован не тот текст, токен обрезан или взят не у @BotFather | Получите токен у @BotFather и вставьте его полностью в поле BotFather token |
| Нет подтверждения после hello | Сообщение отправлено не своему боту, десятиминутное окно истекло или первым написал другой аккаунт | Нажмите Connect this chat на телефоне, затем отправьте hello своему боту в новом указанном десятиминутном окне |
| Бот уже подключен | Этот бот уже используется существующим подключением | Используйте свежего отдельного бота или удалите прежнее подключение, если оно больше не нужно |
| Telegram недоступен | Проблема сети или доступа к Telegram | Проверьте интернет, доступ к Telegram и повторите подключение позже |
| Конфликт получения обновлений или webhook | Бот уже обслуживается другим сервисом или адресом доставки | Лучше создать отдельного бота для FoneClaw |
С webhook будьте особенно аккуратны. Если бот уже подключен к другому сервису через webhook, удаление webhook остановит доставку сообщений в текущий адрес доставки этого сервиса. Делайте это только если вы действительно хотите прекратить работу того подключения. Для большинства пользователей безопаснее создать нового бота через @BotFather и использовать его только с FoneClaw.
Не используйте один и тот же бот для нескольких независимых автоматизаций. Это усложняет диагностику: непонятно, кто получает сообщения, кто занял доставку и почему FoneClaw не видит ваш hello.
Поставьте подключение на паузу, возобновите или удалите
Подключение Telegram-бота не обязано быть включено всегда. В FoneClaw есть элементы управления Pause connection и Resume connection. Пауза останавливает прием через это подключение, а возобновление возвращает его в работу. Если подключение стоит на паузе, новые сообщения боту не должны рассматриваться как активный канал задач, пока вы его не возобновите.
Если вы обновляете токен, привязка и история чата сохраняются. Это удобно, когда вы меняете токен для того же подключения, но не хотите начинать настройку заново. Обновление токена не предназначено для привязки другого Telegram-аккаунта. Новый токен все равно нужно хранить так же аккуратно, как старый: он дает доступ к боту.
Удаление подключения — более сильное действие. Оно удаляет сохраненный токен, ожидающие запросы и записи доставки для этого подключения. Локальная история чата при этом сохраняется. Само удаление подключения в FoneClaw не отзывает токен на стороне Telegram; если вам нужно прекратить действие токена полностью, управляйте ботом через Telegram и @BotFather.
Подключение бота — только один из входов в FoneClaw. FoneClaw выполняет поддерживаемые Android-действия через настроенную модель, доступные разрешения и применимые подтверждения. Текущие возможности описаны на странице функций FoneClaw, а установить актуальное приложение можно со страницы загрузки FoneClaw.