Telegram으로 로컬 AI 코딩 어시스턴트를 원격 제어하는 봇 개발

실용적 조언

로컬 AI 서버에 HTTP API를 노출하고 Telegram 봇을 연결하면 모바일에서도 코드 리뷰 및 승인 프로세스를 수행할 수 있다.

섹션별 상세

작성자는 자리를 비운 사이 발생하는 아이디어 손실을 막기 위해 원격 제어 필요성을 느꼈다. Telegram 봇을 통해 모바일 기기에서 로컬 OpenCode 서버에 프롬프트를 전송하고 작업을 시작할 수 있는 환경을 구축했다. 이를 통해 데스크톱 앞에 있지 않아도 코드베이스 검색 및 프로젝트 파일 브라우징이 가능해졌다.

시스템은 OpenCode의 HTTP API를 활용하여 세션, 모델, 모드(빌드/계획/리뷰/디버그)를 전환하는 기능을 제공한다. TypeScript와 grammY 프레임워크를 기반으로 구축되었으며, 메시지 큐를 도입하여 서버가 바쁜 상태일 때도 여러 프롬프트를 대기시킬 수 있도록 설계했다. 로컬 프로젝트 디렉토리에서 실행 시 포트 충돌을 자동으로 처리하는 편의성도 갖췄다.

보안 및 제어 측면에서 AI의 파일 수정 권한을 사용자가 모바일에서 직접 승인하거나 거부할 수 있는 워크플로우를 포함했다. AI가 추론 중이거나 도구를 실행하고 파일을 편집하는 과정을 실시간 업데이트로 받아볼 수 있어 원격에서도 작업 진행 상황을 정밀하게 모니터링할 수 있다. 모든 세션 상태와 비용 데이터는 로컬에 지속적으로 저장된다.

용어 해설

코딩 에이전트(Coding Agent): — 사용자의 지시에 따라 코드를 작성, 수정, 디버깅하는 자율형 AI 도구이다. 이 글에서는 로컬 환경에서 실행되는 OpenCode가 그 역할을 수행하며, 파일 시스템 접근 및 도구 실행 권한을 가진다.
HTTP API: — 애플리케이션 간에 데이터를 주고받기 위해 HTTP 프로토콜을 사용하는 인터페이스이다. 본 프로젝트에서는 Telegram 봇 서버가 로컬 OpenCode 서버와 통신하여 명령을 전달하고 상태를 받아오는 통로로 활용된다.
폴링(Polling): — 하나의 장치나 프로그램이 충돌을 피하거나 상태를 확인하기 위해 다른 장치의 상태를 주기적으로 검사하는 방식이다. Telegram 봇이 서버의 바쁜 상태나 업데이트를 실시간으로 확인하기 위해 사용된다.

언급된 도구

OpenCode추천

로컬 AI 코딩 어시스턴트

grammY추천

Telegram 봇 개발 프레임워크

TypeScript중립

개발 언어

언급된 리소스

GitHubOpencode-Telegram GitHub Repository