Python과 AI를 사용하여 Telegram 봇을 만드는 방법 (2026)

Telegram 봇은 AI 어시스턴트를 배포하는 가장 실용적인 방법 중 하나입니다. 사용자들은 이미 Telegram을 사용하고 있고, 별도의 앱을 설치할 필요가 없으며, Bot API가 매우 간단하기 때문입니다. 이 가이드에서는 python-telegram-bot과 Claude API를 사용하여 명령어, 인라인 키보드 (Inline Keyboards), 대화 기록 (Conversation History), 에러 처리 (Error Handling), 그리고 systemd 배포를 포함한 완전한 기능을 갖춘 AI 봇을 구축합니다.

사전 요구 사항 (Prerequisites)

• Python 3.10 이상
• **@botfather**로부터 받은 Telegram Bot Token
• Anthropic API 키 (ANTHROPIC_API_KEY)

1단계: 봇 생성하기

Telegram을 열고 **@botfather**를 찾아 /newbot을 전송한 뒤, 토큰을 저장하세요.

2단계: 의존성 설치하기

pip install python-telegram-bot anthropic

3단계: 기본 봇 구조

import os
import anthropic
from telegram import Update
...

4단계: 대화 기록 (Conversation History)

MAX_HISTORY = 20

def get_history(context):
...

5단계: 사용자 정의 명령어 (Custom Commands)

async def summarize(update: Update, context: ContextTypes.DEFAULT_TYPE):
    if not context.args:
        await update.message.reply_text("Usage: /summarize <text>")
...

6단계: 인라인 키보드 (Inline Keyboards)

from telegram import InlineKeyboardButton, InlineKeyboardMarkup
from telegram.ext import CallbackQueryHandler

...

7단계: systemd를 이용한 배포

# /etc/systemd/system/telegram-ai-bot.service
[Unit]
Description=Telegram AI Bot
...

sudo systemctl enable --now telegram-ai-bot

요약

여러분은 대화 기록, 사용자 정의 명령어, 인라인 키보드, 그리고 systemd 배포를 갖춘 프로덕션 준비 완료(Production-ready)된 AI Telegram 봇을 구축했습니다.

원문은 kalyna.pro에서 처음 게시되었습니다.