텔레그램 봇 개발 일지

8 개의 글

데스크톱 앞을 떠나도 Claude Code를 쓰고 싶었다. python-telegram-bot으로 1인 화이트리스트 봇을 만들고, 메시지를 그대로 Claude에 전달해 응답을 라이브로 흘려보내는 1일차 기록.

1편에 이어 모달리티 확장. 음성 메시지를 Whisper로 받고, 이미지 첨부를 inbox 디렉토리로 떨어뜨려 Read하게 하고, Playwright/blog MCP를 옵트인으로 붙인 2일차 기록.

한 봇으로 여러 프로젝트를 다루기 위해 텔레그램 supergroup의 forum topic 단위로 작업 디렉토리를 분리했다. 토픽 이름을 폴더명에 매핑해 자동 라우팅하고, /cd로 임시 override하는 구조.

메인 채팅을 conversational hub로 두고, 프로젝트 작업은 specialist subagent로 dispatch했다. hub turn이 빠르게 끝나야 사용자 입력이 막히지 않는다 — 그 원칙에서 출발한 패턴.

긴 Claude 응답을 텔레그램 한 메시지에 점진적으로 갱신해 보여주는 라이브 메시지 패턴. editMessage throttle, 4096자 분할, 도구 호출 라인 truncate, 마무리 핑까지 다듬은 5일차 기록.

봇이 지금 무엇을 하고 있는지 브라우저로 실시간 확인하는 로컬 dashboard, 슬래시 명령으로 자가 재시작하는 /restart, 그리고 LAN 노출 시 토큰 가드까지 — 6일차의 옵저버빌리티 정리.

6일에 걸쳐 만든 텔레그램 봇을 일주일 써본 마무리 회고. 가장 효과적이었던 결정, 다시 만든다면 다르게 했을 부분, 시리즈를 닫으며 정리한 원칙들.

시리즈 1~7편이 다룬 봇이 실제로 무엇을 부리고 있는지의 갤러리. daily-feed부터 playground-ops까지 6개 프로젝트를 한 줄 요약과 짧은 소개로 정리한다.