grinev/opencode-telegram-bot

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

OpenCode 모바일 클라이언트 (Telegram): 휴대폰에서 AI 코딩 작업을 실행하고 모니터링하며, 모든 작업은 로컬 머신에서 실행됩니다. 예약 작업을 지원하며, 가벼운 OpenClaw 대안으로 사용할 수 있습니다.

개요

이 봇은 Telegram을 통해 OpenCode AI 코딩 에이전트와 상호작용할 수 있는 모바일 인터페이스를 제공합니다. 사용자는 텔레그램 메시지를 통해 코딩 작업을 시작하고, 진행 상황을 모니터링하며, 결과를 확인할 수 있습니다. 모든 AI 작업은 사용자의 로컬 머신에서 실행되어 데이터 프라이버시와 보안을 유지합니다.

주요 기능

• 원격 작업 실행: 휴대폰에서 Telegram 메시지로 AI 코딩 작업을 트리거합니다.
• 실시간 모니터링: 작업 진행 상황과 출력을 실시간으로 확인합니다.
• 예약 작업: 미리 정의된 일정에 따라 작업을 자동으로 실행합니다.
• 다중 인스턴스 관리: 여러 OpenCode 인스턴스를 동시에 관리합니다.
• 가벼운 대안: OpenClaw의 간소화된 대안으로, 모바일 중심의 워크플로우에 최적화되었습니다.

설치 및 설정

1. 이 저장소를 로컬 머신에 클론합니다.
2. 필요한 종속성을 설치합니다:

   pip install -r requirements.txt
   

3. 환경 변수를 설정합니다:
   • TELEGRAM_BOT_TOKEN: Telegram 봇 토큰
   • OPENCODE_API_KEY: OpenCode API 키
   • OPENCODE_ENDPOINT: OpenCode 서버 엔드포인트 (기본값: http://localhost:8000)
4. 봇을 실행합니다:

   python bot.py
   

사용법

기본 명령어

• /start - 봇 시작 및 인증
• /run <작업 설명> - 새 AI 코딩 작업 실행
• /status [작업 ID] - 특정 작업 또는 모든 작업의 상태 확인
• /cancel <작업 ID> - 실행 중인 작업 취소
• /schedule <시간> <작업 설명> - 예약 작업 생성 (예: /schedule 08:00 코드 리뷰 실행)
• /list - 모든 예약 작업 보기
• /help - 도움말 표시

예시

/run 주석이 있는 코드 정리
/status 123
/schedule 14:30 로그 파일 분석

의존성

• Python 3.8 이상
• python-telegram-bot 라이브러리
• OpenCode CLI 또는 API에 접근 가능

라이선스

이 프로젝트는 MIT 라이선스 하에 배포됩니다. 자세한 내용은 LICENSE 파일을 참조하세요.

기여

버그 신청, 기능 제안, 풀 리퀘스트는 언제나 환영합니다. 변경 사항을 적용하기 전에 이슈를 열어 논의해 주세요.