팀 Telegram 어시스턴트
기준일: 2026-07-26
난이도: 중급
공식 기준: Team Telegram Assistant
개요
팀 전체가 쓰는 Telegram 봇을 Gateway·allowlist·pairing으로 운영하는 단계별 가이드입니다.
핵심 개념
| 단계 | 내용 |
|---|---|
| Bot + gateway | 상시 연결 |
| Allowlist / pairing | 팀 접근 통제 |
| Profiles | 역할·모델 분리 |
| Ops | 로그·재시작·업데이트 |
상세
What We're Building
- Any authorized team member
- Runs on your server
- Per-user sessions
- Secure by default
- Scheduled tasks
Prerequisites
- Hermes Agent installed
- A Telegram account
- An LLM provider configured
Step 1: Create a Telegram Bot
- Open Telegram
- Send
/newbot - Copy the bot token
- Set a description
- Set bot commands
Use this token to access the HTTP API:
7123456789:AAH1bGciOiJSUzI1NiIsInR5cCI6Ikp...
Step 2: Configure the Gateway
- Option A: Interactive Setup (Recommended) — 공식 하위 절. 구현·설정 세부 원문 참조.
- Option B: Manual Configuration — 공식 하위 절. 구현·설정 세부 원문 참조.
- Finding Your User ID — 공식 하위 절. 구현·설정 세부 원문 참조.
- Message @userinfobot on Telegram
- It instantly replies with your numeric user ID
- Copy that number into
TELEGRAM_ALLOWED_USERS
hermes gateway setup
Step 3: Start the Gateway
- Quick Test — 공식 하위 절. 구현·설정 세부 원문 참조.
- Production: Install as a Service — 공식 하위 절. 구현·설정 세부 원문 참조.
- Verify It's Running — 공식 하위 절. 구현·설정 세부 원문 참조.
hermes gateway
Step 4: Set Up Team Access
- Approach A: Static Allowlist — 공식 하위 절. 구현·설정 세부 원문 참조.
- Approach B: DM Pairing (Recommended for Teams) — 공식 하위 절. 구현·설정 세부 원문 참조.
- Security Considerations — 공식 하위 절. 구현·설정 세부 원문 참조.
- Teammate DMs the bot
- Teammate sends you the code
- You approve it
# In ~/.hermes/.env
TELEGRAM_ALLOWED_USERS=123456789,987654321,555555555
Step 5: Configure the Bot
- Set a Home Channel — 공식 하위 절. 구현·설정 세부 원문 참조.
- Configure Tool Progress Display — 공식 하위 절. 구현·설정 세부 원문 참조.
- Set Up a Personality with SOUL.md — 공식 하위 절. 구현·설정 세부 원문 참조.
- Add Project Context — 공식 하위 절. 구현·설정 세부 원문 참조.
| Mode | What You See |
|---|---|
off |
Clean responses only — no tool activity |
new |
Brief status for each new tool call (recommended for messaging) |
all |
Every tool call with details |
verbose |
Full tool output including command results |
TELEGRAM_HOME_CHANNEL=-1001234567890
TELEGRAM_HOME_CHANNEL_NAME="Team Updates"
Step 6: Set Up Scheduled Tasks
- Daily Standup Summary — 공식 하위 절. 구현·설정 세부 원문 참조.
- Server Health Check — 공식 하위 절. 구현·설정 세부 원문 참조.
- Managing Scheduled Tasks — 공식 하위 절. 구현·설정 세부 원문 참조.
- Pull requests opened/merged in the last 24 hours
- Issues created or closed
- Any CI/CD failures on the main branch
Every weekday at 9am, check the GitHub repository at
github.com/myorg/myproject for:
1. Pull requests opened/merged in the last 24 hours
2. Issues created or closed
3. Any CI/CD failures on the main branch
Format as a brief standup-style summary.
Production Tips
- Use Docker for Safety — 공식 하위 절. 구현·설정 세부 원문 참조.
- Monitor the Gateway — 공식 하위 절. 구현·설정 세부 원문 참조.
- Keep Hermes Updated — 공식 하위 절. 구현·설정 세부 원문 참조.
- Log Locations — 공식 하위 절. 구현·설정 세부 원문 참조.
| What | Location |
|---|---|
| Gateway logs | journalctl --user -u hermes-gateway (Linux) or ~/.hermes/logs/gateway.log (macOS) |
| Cron job output | ~/.hermes/cron/output/{job_id}/{timestamp}.md |
| Cron job definitions | ~/.hermes/cron/jobs.json |
| Pairing data | ~/.hermes/pairing/ |
| Session history | ~/.hermes/sessions/ |
# In ~/.hermes/.env
TERMINAL_ENV=docker
TERMINAL_DOCKER_IMAGE=nikolaik/python-nodejs:python3.11-nodejs20
Going Further
체크리스트
- 공식 원문 Team Telegram Assistant과 대조했다
- 관련 코드·설정·권한을 로컬에서 확인했다
- 보안·opt-in·allowlist 정책을 지켰다
- 스모크 테스트 또는 단계 검증을 수행했다
다음 단계
기준일: 2026-07-26 — 공식 문서 동기화 코퍼스