Community코딩 & 개발github.com

beautyfree/telegram-agent

Claude Code, Codex CLI, Cursor, Gemini CLI, Cline, Windsurf 등 다양한 AI 에이전트에서 사용 가능한 범용 텔레그램 에이전트 스킬입니다. MCP 대비 약 50배 낮은 컨텍스트를 사용하는 Lazy-loading 방식을 채택했으며, 독립 실행형 CLI와 SKILL.md 번들, 원클릭 설치를 지원합니다.

telegram-agent란 무엇인가요?

이 스킬은 AI 에이전트(Claude Code, Codex CLI, Cursor, Gemini CLI, Cline, Windsurf)가 텔레그램과 상호작용할 수 있도록 설계된 범용 텔레그램 에이전트입니다. MCP(Model Context Protocol) 기반 솔루션과 달리 Lazy-loading 방식을 사용하여 약 50배 더 적은 컨텍스트를 소비하므로, AI의 작업 메모리와 응답 비용을 크게 절감할 수 있습니다. 독립 실행형 CLI 도구와 함께 SKILL.md 파일 번들을 제공하여 원클릭 설치가 가능하며, 다양한 AI 에이전트 플랫폼에서 일관된 기능을 제공합니다. 이를 통해 개발자는 AI 에이전트에게 텔레그램 메시지 전송, 읽기, 채널 관리 등의 작업을 지시할 수 있으며, 복잡한 설정 없이 즉시 사용할 수 있습니다.

지원 대상✓Claude Code✓Codex CLI✓Cursor✓Gemini CLI✓Windsurf
npx skills add beautyfree/telegram-agent

Installed? Explore more 코딩 & 개발 skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

telegram-agent은(는) 무엇을 하나요?

Claude Code, Codex CLI, Cursor, Gemini CLI, Cline, Windsurf 등 다양한 AI 에이전트에서 사용 가능한 범용 텔레그램 에이전트 스킬입니다. MCP 대비 약 50배 낮은 컨텍스트를 사용하는 Lazy-loading 방식을 채택했으며, 독립 실행형 CLI와 SKILL.md 번들, 원클릭 설치를 지원합니다.

설치 방법

다음 명령어를 사용하여 원클릭으로 설치할 수 있습니다:

curl -sSL https://raw.githubusercontent.com/beautyfree/telegram-agent/main/install.sh | bash

사용 방법

  1. 텔레그램 봇 토큰을 발급받으세요. BotFather에서 /newbot 명령어로 생성할 수 있습니다.
  2. 발급받은 토큰을 환경 변수 TELEGRAM_BOT_TOKEN에 설정하세요.
  3. AI 에이전트에게 텔레그램 작업을 요청하세요.

지원 기능

  • 메시지 전송
  • 메시지 읽기
  • 채널 관리
  • 인라인 모드 쿼리 처리
  • 웹훅 설정

환경 변수

변수명설명필수 여부
TELEGRAM_BOT_TOKEN텔레그램 봇 토큰필수
TELEGRAM_CHAT_ID기본 채팅 ID선택

예제

# 메시지 전송 예제
send_message(chat_id="@my_channel", text="Hello from AI Agent!")

라이선스

MIT

관련 스킬