FoneClaw Telegram 봇 연결: BotFather로 개인 봇 설정하기
BotFather에서 전용 Telegram 봇을 만들고 FoneClaw에 토큰을 저장한 뒤, 내 개인 대화로 연결하고 첫 Android 할 일을 확인하는 설정 가이드입니다.
- FoneClaw Telegram 봇 연결은 Telegram 앱 전체를 대신 조작하는 설정이 아니라, 내가 만든 전용 봇을 통해 FoneClaw와 개인 대화로 요청을 주고받는 방식입니다.
- BotFather에서 /newbot으로 봇을 만들고 받은 토큰은 개인 계정 비밀번호나 로그인 코드가 아니지만, 봇을 인증하는 값이므로 비공개로 보관해야 합니다.
- FoneClaw에 토큰을 저장한 뒤 10분 안에 내 봇에게 hello를 보내면, 첫 메시지를 보낸 Telegram 계정과 개인 대화가 연결됩니다. 시간이 지났다면 휴대폰에서 Connect this chat을 눌러 새 10분 창을 열고 다시 hello를 보냅니다.
- 연결이 됐다는 사실과 Android 작업이 실제로 완료됐다는 사실은 다릅니다. 날짜 없는 할 일처럼 낮은 위험 작업 하나를 요청하고, FoneClaw에서 승인과 저장 결과를 확인하세요.
전용 Telegram 봇 만들기
FoneClaw Telegram 봇 연결은 두 가지를 구분해서 시작해야 합니다. 하나는 Telegram 앱에서 음성 입력으로 메시지를 다루는 사용법이고, 다른 하나는 내가 만든 Telegram 봇을 FoneClaw와 연결해 개인 대화로 요청을 보내는 설정입니다. 이 글은 두 번째, 즉 전용 Telegram 봇 연결 절차만 다룹니다. Telegram을 음성 입력과 함께 쓰는 별도 흐름은 Telegram 음성 입력과 FoneClaw 사용 흐름에서 따로 확인할 수 있습니다.
먼저 Telegram에서 공식 BotFather 튜토리얼에 안내된 @BotFather를 엽니다. BotFather에게 /newbot을 보내고, 봇 이름과 사용자 이름을 정합니다. 생성이 끝나면 BotFather가 고유한 토큰을 줍니다. 이 토큰은 내 Telegram 개인 계정의 비밀번호나 로그인 코드가 아닙니다. 하지만 봇을 인증하는 값이므로 다른 사람에게 보내거나 공개 채팅에 붙여 넣으면 안 됩니다.
가능하면 FoneClaw용으로 전용 봇을 하나 새로 만드세요. 이미 다른 서비스가 쓰는 봇을 재사용하면 메시지 수신 방식이 충돌할 수 있습니다. 특히 다른 프로그램이 같은 봇을 계속 가져가거나 webhook으로 받는 중이면 FoneClaw 연결이 실패할 수 있습니다. 전용 봇을 쓰면 나중에 중지, 재개, 삭제할 때도 다른 서비스에 영향을 덜 줍니다.
내 개인 Telegram 계정 연결하기
FoneClaw에서 Telegram Connections를 열고 BotFather가 준 토큰을 입력합니다. BotFather token은 봇 토큰을 넣는 입력란이고, Save bot token은 입력한 토큰을 저장하는 컨트롤입니다. 이 두 영어 라벨을 기준으로 찾으면 됩니다.
토큰을 저장한 다음에는 BotFather가 아니라 방금 만든 내 봇을 Telegram에서 엽니다. 그 봇에게 10분 안에 문자 그대로 hello를 보냅니다. FoneClaw는 개인 대화를 연결하며, 첫 메시지를 보낸 Telegram 계정에 연결이 묶입니다. 설정할 때는 반드시 본인이 먼저 내 봇에게 hello를 보내야 합니다.
10분 창이 지났다면 휴대폰에서 Connect this chat을 누르세요. 이 컨트롤은 현재 대화를 다시 연결하기 위한 새 안내를 여는 버튼입니다. 새로 표시된 10분 창 안에 내 봇에게 hello를 보내고, 연결 확인 메시지가 올 때까지 기다린 뒤 대화를 시작하세요. 봇 연결은 Telegram의 모든 개인 대화를 읽는 권한이 아닙니다. 이 연결은 내가 만든 봇과 나 사이의 개인 대화를 FoneClaw 요청 통로로 쓰는 방식입니다. 현재 기능 범위와 지원되는 Android 작업은 FoneClaw 기능 안내에서 확인할 수 있고, 앱 설치 경로는 FoneClaw 다운로드에서 볼 수 있습니다.
지원되는 Android 결과 하나 확인하기
연결이 끝났다면 복잡한 작업보다 낮은 위험 작업 하나로 확인하세요. 예를 들어 Telegram에서 내 봇에게 “시장 조사 아이디어 정리하기를 할 일로 저장해 줘”라고 보낼 수 있습니다. 이 문장에는 날짜, 요일, 상대 날짜가 없습니다. 따라서 캘린더 일정이 아니라 날짜 없는 할 일로 남기는 것이 자연스럽습니다.
봇이 메시지를 받았다는 사실과 FoneClaw가 Android 작업을 실제로 완료했다는 사실은 다릅니다. 요청이 FoneClaw로 전달된 뒤에는 필요한 권한이나 적용 가능한 승인 흐름이 앱 안에서 나타날 수 있습니다. 승인이 필요한 단계가 있다면 내용을 확인하고 진행하세요. 완료 후에는 FoneClaw의 할 일 목록에서 저장된 항목이 보이는지 확인해야 합니다.
날짜 없는 할 일을 일정처럼 만들지 않는 기준은 Android AI 할 일 날짜 없이 안전하게 저장하기에서 더 자세히 설명합니다. FoneClaw를 처음 설치했거나 권한 안내가 낯설다면 안드로이드 무료 AI 에이전트 사용법: FoneClaw 첫 설정과 첫 작업을 먼저 따라가면 좋습니다. Telegram 봇은 요청을 보내는 통로이고, Android 작업의 권한과 결과 확인은 FoneClaw 쪽에서 봐야 합니다.
연결 오류를 원인별로 확인하기
연결이 안 될 때는 같은 과정을 반복하기보다 표시된 오류의 종류를 나눠 보세요. 토큰 문제, 잘못된 봇, 안내된 10분 안에 hello를 보내지 않은 경우, 이미 연결된 봇, Telegram 연결 불가, 다른 poller나 webhook 충돌은 해결 방법이 다릅니다.
| 증상 | 확인할 것 | 다음 조치 |
|---|---|---|
| 토큰이 거부됨 | BotFather가 준 토큰을 빠짐없이 붙여 넣었는지 확인 | 공백, 줄바꿈, 오래된 토큰을 다시 점검 |
| hello를 보냈는데 묶이지 않음 | BotFather가 아니라 내가 만든 봇에게 보냈는지 확인 | 휴대폰에서 Connect this chat을 누른 뒤, 새로 표시된 10분 창 안에 내 봇에게 hello 전송 |
| 이미 연결된 봇으로 표시됨 | 그 봇이 기존 연결이나 다른 서비스에서 이미 쓰이는지 확인 | 전용 봇을 새로 만들거나 기존 연결 상태를 정리 |
| Telegram에 닿지 않음 | 네트워크, Telegram 접속 상태, FoneClaw 앱 상태 확인 | 연결이 회복된 뒤 토큰 저장과 hello 과정을 다시 확인 |
| poller 또는 webhook 충돌 | 다른 서비스가 같은 봇을 사용 중인지 확인 | 가능하면 새 전용 봇 사용 |
webhook을 제거하면 그 봇의 현재 전달 대상이 멈춥니다. 다른 서비스가 그 webhook으로 메시지를 받고 있었다면, 제거 후에는 그 서비스가 더 이상 봇 메시지를 받지 못할 수 있습니다. 따라서 webhook 충돌이 보이면 먼저 새 전용 봇을 만드는 편이 안전합니다. 기존 webhook을 제거하는 선택은 그 서비스를 멈춰도 된다는 판단이 있을 때만 하세요.
연결을 일시 중지, 재개, 삭제하기
연결을 잠시 멈추고 싶을 때는 Pause connection을 사용합니다. 다시 받으려면 Resume connection을 눌러야 합니다. 일시 중지된 상태에서는 봇 대화가 살아 있어 보여도 FoneClaw가 새 요청을 처리하지 않을 수 있으므로, 요청이 안 들어온다면 먼저 연결 상태를 확인하세요.
토큰을 바꿔 저장해도 기존 연결과 대화 이력은 보존되는 흐름으로 안내됩니다. 예를 들어 BotFather에서 토큰을 다시 발급받아 교체해야 하는 상황이라면, 새 토큰을 저장한 뒤 기존 연결이 유지되는지 확인하면 됩니다. 다만 토큰은 봇을 인증하는 값이므로, 유출이 의심되면 빠르게 교체하고 예전 토큰을 더 쓰지 않는 것이 좋습니다.
연결을 삭제하면 저장된 토큰, 대기 중인 요청, 전달 기록이 삭제됩니다. 반면 로컬 채팅 이력은 남는 것으로 안내됩니다. 삭제가 Telegram 쪽의 봇 토큰 자체를 폐기하는 것은 아닙니다. Telegram에서 토큰을 무효화하거나 다시 발급하려면 BotFather에서 별도로 처리해야 합니다. 이후 다시 쓰려면 토큰 저장과 개인 대화 연결 과정을 다시 확인해야 합니다.
Telegram 연결은 편리한 원격 요청 통로이지만, 항상 켜진 무제한 자동화로 이해하면 안 됩니다. FoneClaw는 지원되는 Android 작업을 현재 권한과 승인 흐름 안에서 처리합니다. 할 일 저장, 캘린더 작업, 앱 실행처럼 결과가 남는 작업은 완료 후 기기에서 저장된 결과를 직접 확인하는 습관을 두세요.