피드로 돌아가기
Dev.toDevOps
원문 읽기
Telegram 기반 Coding Agent 제어를 위한 OpenClaw Gateway 아키텍처 구축
Coding Agents over Telegram, Part 2: From Zero to an Agent That Answers
AI 요약
Context
로컬 환경에서 구동되는 Coding Agent를 원격에서 제어하기 위한 인터페이스 부재 상황. 단순한 챗봇 연결을 넘어 tmux pane과 쉘 액세스를 연동하여 실시간으로 코드를 작성하고 실행하는 원격 제어 환경 필요.
Technical Solution
- Telegram Bot API와 로컬 tmux 세션을 연결하는 OpenClaw Gateway 중심의 Relay 구조 설계
- Node.js 24.11.1 및 pnpm 11.2.2 버전 고정을 통한 Runtime 호환성 확보 및 Native Build 오류 방지
- Telegram Supergroup의 Topic 기능을 활용하여 프로젝트별 독립적인 제어 채널 분리
- Bot Admin 권한 부여를 통한 Privacy Mode 우회 및 그룹 내 모든 메시지 수신 구조 확보
openclaw.json설정 파일의 권한 제한(chmod 600)과 Allowlist 기반의 사용자 ID 검증으로 보안 계층 생성- 기존 Coding Agent(opencode, Claude Code 등)를 대체하지 않고 Wrapper 형태로 구동하는 Interface Layer 설계
실천 포인트
- Runtime 버전 불일치로 인한 Silent Failure 방지를 위해 Node.js 및 패키지 매니저 버전 핀 고정 - 외부 메시징 플랫폼 연동 시 Privacy Mode 설정을 확인하여 이벤트 수신 누락 여부 검증 - API Token 등 민감 정보가 포함된 설정 파일의 파일 시스템 권한(chmod 600) 강제 적용 - 원격 쉘 제어 환경 구축 시 세션 유지 및 복구를 위한 tmux Target Pane 명시적 지정