우물안 오리, 세상 밖으로 날아오르다. -’봇.알.못’도 따라할 수 있는 Hermes 봇 ,단체방 초기 세팅 매뉴얼
2026.06.01

소개
첫 주 나의 반려봇 'conDUCK'을 만들고, 2주차에 스터디원들 그리고 그들의 봇들과 함께 대화하는 단체창 실험실이 생겼다. 1:1 대화와는 다르게 단체창에서 이것저것 살펴야 할 것들을 '봇.알.못'인 내가 몸소 부딪히면서 단체창 들어간 수난기.
진행 방법
지난 한 주를 돌아보니, 가장 큰 실험은 제 개인 AI 비서인 컨덕(conDUCK) 을 텔레그램 단체방에 초대한 일이었다.
처음에는 단순하게 생각했다.
“봇을 단체방에 초대하면 되겠지?”
그런데 실제로 해보니, 봇을 단체방에 넣는 일은 사람을 초대하는 것과 조금 달랐다.
특히 비개발자이자 AI 첫발을 딛은 내가 봇 설정이나 텔레그램 BotFather, Gateway, Privacy Mode 같은 개념도 익숙하지 않았기 때문에 중간중간 막히는 부분이 많았다.
그래도 스터디장님, 희수님(스터디장의 오케스트레이션 봇), 그리고 컨덕과 함께 하나씩 확인하면서 결국 단체방 입성에 성공했다.
이번 글은 그 과정을 정리한 “봇알못도 따라할 수 있는 Hermes 봇, 단체방 초기 세팅 매뉴얼” 이다.
1. 먼저 정해야 할 것: 봇이 단체방에서 어떻게 행동할까?
봇을 단체방에 넣기 전에 가장 먼저 정해야 할 것은 기술 설정이 아니라 운영 방식이었다.
안전형: @멘션이나 답글을 받을 때만 응답, 평소 대화는 기록하지 않음
관찰형: @멘션이나 답글을 받을 때만 응답, 평소 대화는 맥락으로만 저장
참여형: 허용된 방에서는 모든 메시지에 자연스럽게 응답
공지방 전용: 공지방은 읽고 요약 중심, 일반 대화방은 멘션 때만 응답
나는 관찰형을 선택했다.
즉, 컨덕이 아무 때나 끼어들지는 않지만, 방의 흐름을 이해할 수 있도록 일부 대화 맥락은 참고할 수 있게 하는 방식이다.
다만 이 방식은 중요한 문제로 ‘봇이 단체방 대화를 읽고 참고할 수 있다는 사실을 방 멤버들이 알아야 한다.’는 생각이 들었다.
그래서 단체방에 컨덕을 초대하기 전에 아래처럼 공지했다.
Conduck은 대화 맥락을 이해하기 위해 일부 메시지를 기록/참조할 수 있습니다.
다만 기본 응답은 @멘션이나 답글로 호출될 때만 하도록 설정했습니다.
민감한 개인정보, 토큰, 비밀번호, 계정 정보는 이 방에 올리지 말아주세요.
AI 봇을 단체방에 넣는다는 것은 단순히 “편리한 도구 하나 추가”가 아니라, 방 안의 대화 흐름에 새로운 참여자이자 기록자가 들어오는 일이기 때문이다.
2. 봇은 초대링크를 스스로 누를 수 없다
/처음 막힌 지점은 초대 방식이었다.
나는 컨덕이 나처럼 행동할 수 있기를 바랬고, 내가 단체방 초대링크로 들어갔듯이 컨덕도 스스로 할 수 있도록 초대링크로 시도해보았다.
저는 단체방 초대링크를 컨덕에게 보내면 봇이 스스로 들어올 수 있을 거라고 생각했다.
하지만 컨덕은 이렇게 답했다.

봇은 사람처럼 초대링크를 눌러서 들어오는 존재가 아니란다.
관리자나 방 멤버가 직접 봇 username을 검색해서 추가해야 한다고 안내다.
봇 초대 방법 - 단체방에서:
1. 그룹 이름을 누른다.(대화창 맨 위, 가운데)
2. 멤버 추가 또는 Add Members를 누른다.
3. 봇의 정확한 username을 검색⇒봇을 선택해서 추가한다.
ex) 컨덕의 경우 실제 username은 이런 식입니다. @conduck_hermes_bot
3. 초대했는데 봇이 답을 안 한다면: “못 받은 것”과 “받았지만 무시한 것”을 나눠야 한다
컨덕을 단체방에 초대한 뒤, 바로 문제가 생겼다. 불러도 대답이 없었다.
처음에는 “봇이 멈췄나?” 싶었다.
하지만 나중에 배운 핵심은 이것이었다.
봇이 답을 안 할 때는 먼저
-메시지가 봇에게 아예 안 들어온 것인지,
-들어왔지만 응답 조건을 통과하지 못한 것인지 구분해야 한다.
이 둘은 완전히 다른 문제입니다.
경우 1. 메시지가 아예 안 들어온 경우
BotFather의 Group Privacy Mode가 켜져 있음
봇이 그룹에 제대로 들어오지 않음
봇에게 그룹 메시지를 볼 권한이 없음
Gateway가 해당 봇 토큰으로 실행되고 있지 않음
같은 봇 토큰을 두 프로세스가 동시에 polling 중임
경우 2. 메시지는 들어왔지만 응답하지 않는 경우
require_mention: true라서 명시 호출이 필요함
allowed_chats에 해당 그룹 chat_id가 없음
다른 봇을 멘션해서 내 봇이 “내가 부른 게 아니구나”라고 판단함
답글 맥락을 호출 신호로 처리하지 못함
시스템 프롬프트나 응답 정책이 너무 엄격함
저희가 실제로 본 로그 중에는 이런 상태가 있었다.
[log] Telegram group message observed (no bot trigger)
[의미] 메시지는 봤지만, 봇이 “나를 부른 메시지”라고 판단하지 않았다.
즉, 이 경우는 연결 문제가 아니라 트리거 판단 문제였다.
4. BotFather에서 Privacy Mode를 확인해야 한다
단체방 봇 설정에서 가장 많이 막히는 부분이 Group Privacy Mode였다.
BotFather에서 확인한다.
1. 텔레그램에서 @BotFather를 연다.
2. /mybots 입력 ⇒ 내 봇 선택 ⇒ Bot Settings ⇒ Group Privacy
3. Group Privacy
Turn off 또는 Disabled 상태인지 확인
Privacy Mode가 켜져 있으면 봇은 그룹의 모든 메시지를 볼 수 없다.
일부 명령어나 직접 멘션만 받을 수 있다.
관찰형 모드처럼 봇이 단체방의 일반 대화 맥락도 참고해야 한다면, Group Privacy를 꺼야한다.

중요한 주의점
Privacy Mode를 바꾼 뒤에도 바로 적용되지 않을 수 있습니다.
그럴 때는: 봇을 그룹에서 제거 ⇒ 다시 초대 ⇒ 다시 멘션 테스트
5. Hermes 설정에서 허용된 방만 응답하게 해야 한다
단체방에서 아무나 내 봇을 부를 수 있게 하면 위험하다.
그래서 Hermes에서는 특정 그룹만 허용하도록 설정할 수 있다.
Hermes 설정 파일은 보통 여기에 있습니다.
~/.hermes/config.yaml
적용내용 :
—
telegram:
require_mention: true
observe_unmentioned_group_messages: true
exclusive_bot_mentions: true
allowed_chats:
"<허용할 그룹 chat_id>"
group_allowed_chats:
"<허용할 그룹 chat_id>"
—
각 항목을 쉽게 말하면 이렇다.
require_mention: true → 봇을 부를 때만 응답
observe_unmentioned_group_messages: true
→ 부르지 않은 일반 대화는 응답하지 않지만 맥락으로 참고 가능
exclusive_bot_mentions: true
→ 여러 봇이 있는 방에서 다른 봇을 멘션한 메시지에는 끼어들지 않음
allowed_chats → 봇이 응답해도 되는 단체방 목록
group_allowed_chats → 그룹 맥락 관찰이 허용된 단체방 목록
고라파덕이 “컨덕아!” 하고 불러도, 그 방이 허용 목록에 없으면 컨덕은 응답하지 않는다.
6. 단체방에서는 정확한 호출명이 중요하다
여러 봇이 있는 단체방에서는 멘션이 헷갈릴 수 있다.
컨덕의 실제 username은 : @conduck_hermes_bot
현재 설정에 exclusive_bot_mentions: true가 켜져 있으면, 메시지 안에 다른 봇 username이 있을 때 컨덕은 이렇게 판단할 수 있다.
“이건 나에게 한 말이 아니라 다른 봇에게 한 말이구나.”
그래서 단체방에서 컨덕을 확실히 부르려면 아래처럼 해야 한다.
@conduck_hermes_bot 지금 보여?
또는 호출어를 설정해두었다면:
컨덕아 지금 보여?
7. 답글도 중요한 호출 신호다
@멘션 이외에 반응해하는 대화는 뭐가 있을까?
단체방에서는 @멘션만 중요한 것이 아니라 답글(Reply) 도 중요한 신호다.
예를 들어 컨덕의 메시지에 답글로:
이 부분 다시 확인해줘
라고 쓰면, 그건 문맥상 컨덕에게 말하는 것이기 때문이다.
하지만 봇이 답글 맥락을 제대로 읽지 못하면, 본문에 다른 봇 이름이 들어있다는 이유만으로 엉뚱하게 판단할 수 있다.
그래서 앞으로 컨덕의 단체방 대화 문법에는 이런 기준을 정했다.
내 username을 직접 멘션하면 응답한다.
내 메시지에 답글을 달면, 나와 이어지는 대화로 본다.
본문에 다른 봇 username이 있어도, 그 봇을 “부른 것”인지 “언급한 것”인지 문장 의미로 구분한다.
다른 봇에게 직접 작업 지시가 간 경우에는 끼어들지 않는다.
애매하면 답변보다 대기를 우선한다.
8. 슬래시 명령어는 반드시 주인만 쓰게 막아야 한다스터디장님이 가장 중요하게 짚어주신 보안 포인트가 있었다.
그룹에 들어온 봇은 기본적으로 누군가가 슬래시 명령어를 보낼 수 있다.
예를 들면:
/restart , /update , /status
이런 명령어는 Gateway 재시작, 업데이트, 상태 확인 같은 시스템 동작과 연결될 수 있다.
그래서 봇 주인이 아닌 사람이 이런 명령어를 쓰지 못하도록 막아야 한다.
Hermes에서는 telegram.extra 아래에 관리자 허용 목록을 둘 수 있다.

스터디장님이 실제로 /status를 보냈을 때 이런 메시지가 나왔다.
위의 메시지가 나오면 설정이 성공한 것이다.
즉:
봇 주인 → 슬래시 명령어 사용 가능
다른 사람 → 슬래시 명령어 차단
이 상태가 된 것이다.
9. 봇이 봇을 테스트하는 것은 한계가 있다
나의 목표가 봇이 스스로 작동하기를 바라는 것이었기에 봇끼리의 상호작용을 유도했다.
다른 봇에게 라이브 테스트를 부탁하려고 했다.
하지만 여기서 중요한 한계를 배웠다.

봇이 보내는 메시지는 사람 계정이 보내는 메시지와 다르게 처리될 수 있고,
또한 우리가 검증하려는 것은 “타인 계정이 슬래시 명령어를 보냈을 때 차단되는가”인데, 봇이 봇에게 명령을 보내는 것은 이 상황을 정확히 재현하지 못한다.
따라서 최종 보안 테스트는 가능하면 사람 계정으로 해야 한다는 사실.
최종 검증 방법
1. 봇 주인 계정에서 /status 또는 /restart 테스트
→ 관리자라면 허용되어야 함
2. 봇 주인이 아닌 사람 계정에서 /status 또는 /restart 테스트
→ 차단되어야 함
이 두 번째 테스트가 진짜 보안 확인이다.
10. 마지막 연결 확인
여러 설정을 거친 뒤, 마침내 단체방에서 테스트했다.
Group privacy turn off test
그리고 컨덕이 응답했다.

이렇게 컨덕은 단체방에 입성했습니다. 꽥!



공유해 주셔서 감사합니다.