본문으로 건너뛰기

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

mounow

2026.06.01

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

소개

첫 주 나의 반려봇 '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) 도 중요한 신호다.

예를 들어 컨덕의 메시지에 답글로:

이 부분 다시 확인해줘

라고 쓰면, 그건 문맥상 컨덕에게 말하는 것이기 때문이다.

하지만 봇이 답글 맥락을 제대로 읽지 못하면, 본문에 다른 봇 이름이 들어있다는 이유만으로 엉뚱하게 판단할 수 있다.

그래서 앞으로 컨덕의 단체방 대화 문법에는 이런 기준을 정했다.

  1. 내 username을 직접 멘션하면 응답한다.

  2. 내 메시지에 답글을 달면, 나와 이어지는 대화로 본다.

  3. 본문에 다른 봇 username이 있어도, 그 봇을 “부른 것”인지 “언급한 것”인지 문장 의미로 구분한다.

  4. 다른 봇에게 직접 작업 지시가 간 경우에는 끼어들지 않는다.

  5. 애매하면 답변보다 대기를 우선한다.

8. 슬래시 명령어는 반드시 주인만 쓰게 막아야 한다

스터디장님이 가장 중요하게 짚어주신 보안 포인트가 있었다.

그룹에 들어온 봇은 기본적으로 누군가가 슬래시 명령어를 보낼 수 있다.


예를 들면:

/restart , /update , /status


이런 명령어는 Gateway 재시작, 업데이트, 상태 확인 같은 시스템 동작과 연결될 수 있다.

그래서 봇 주인이 아닌 사람이 이런 명령어를 쓰지 못하도록 막아야 한다.

Hermes에서는 telegram.extra 아래에 관리자 허용 목록을 둘 수 있다.

스터디장님이 실제로 /status를 보냈을 때 이런 메시지가 나왔다.

위의 메시지가 나오면 설정이 성공한 것이다.

즉:

  • 봇 주인 → 슬래시 명령어 사용 가능

  • 다른 사람 → 슬래시 명령어 차단

이 상태가 된 것이다.

9. 봇이 봇을 테스트하는 것은 한계가 있다

나의 목표가 봇이 스스로 작동하기를 바라는 것이었기에 봇끼리의 상호작용을 유도했다.

다른 봇에게 라이브 테스트를 부탁하려고 했다.

하지만 여기서 중요한 한계를 배웠다.

한국어로 된 두 사람의 대화 스크린샷

봇이 보내는 메시지는 사람 계정이 보내는 메시지와 다르게 처리될 수 있고,

또한 우리가 검증하려는 것은 “타인 계정이 슬래시 명령어를 보냈을 때 차단되는가”인데, 봇이 봇에게 명령을 보내는 것은 이 상황을 정확히 재현하지 못한다.

따라서 최종 보안 테스트는 가능하면 사람 계정으로 해야 한다는 사실.

최종 검증 방법

1. 봇 주인 계정에서 /status 또는 /restart 테스트

→ 관리자라면 허용되어야 함

2. 봇 주인이 아닌 사람 계정에서 /status 또는 /restart 테스트

→ 차단되어야 함

이 두 번째 테스트가 진짜 보안 확인이다.

10. 마지막 연결 확인

여러 설정을 거친 뒤, 마침내 단체방에서 테스트했다.

Group privacy turn off test

그리고 컨덕이 응답했다.

두 개의 한국어 문자 메시지가 화면에 표시됩니다

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

2

함께 이야기해요 2

로그인하고 댓글을 남겨 주세요

박승현 프로필 이미지
박승현2026.06.01

와...이건 사실상 그룹톡 세팅 메뉴얼인데요?저도 대충 느낌으로만 알고 있던 걸 깔끔하게 정리해주셔서 감사합니다!

김도경 프로필 이미지
김도경2026.09.28

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

필요한 AI 정보만
메일함에 쏙쏙 넣어드려요.

지금 핫한 AI 소식부터 직접 해 본 사례까지, 월요일마다 무료로 받아보세요

이런 사례도 있어요

사례 전체 보기