토큰만 넣으면 끝인 줄 알았던 Slack 봇 연결 삽질기
2026.05.24
한 줄 요약
Hermes Agent를 Slack에서 쓰기 위해 TARDIS와 C&B 봇을 분리 구성했고, 토큰, Socket Mode, 이벤트 처리, 프로필별 인증 문제를 하나씩 확인하면서 멘션 기반으로 동작하는 구조까지 안정화했습니다.
이런 분들께 도움돼요
Slack에서 AI 봇이나 에이전트를 직접 붙여보려는 분
하나의 런타임에서 여러 봇 프로필을 나눠 운영하려는 분
"봇은 온라인인데 왜 답을 안 하지?" 같은 문제를 겪는 분
시작점: 왜 이걸 했나
처음 목표는 Slack 워크스페이스에서 Hermes Agent 기반 봇을 실제로 호출해서 쓰는 것이었습니다.
메인 오케스트레이터 역할의 TARDIS와, 문서/PDF/HWP/미디어 변환을 맡는 C&B를 분리해서 운영하고 싶었습니다.
처음에는 Slack Bot Token만 넣으면 바로 될 줄 알았습니다. 그런데 실제로는 Bot Token, App-Level Token, Socket Mode, Event Subscriptions, home channel, Hermes profile별 .env, Python 의존성, Codex provider 인증까지 모두 맞아야 했습니다.
결국 이 작업은 "Slack 봇을 하나 연결했다"기보다, 여러 AI 에이전트를 Slack에서 독립적으로 운영하기 위한 연결 기준을 정리한 과정에 가까웠습니다.
만든 것 / 결과물
현재 기준으로 정리된 구조는 이렇습니다.
TARDIS: 기본 Hermes Agent, 총괄 오케스트레이터
C&B:
cnb독립 profile, Slack 봇@copyandbinding, 문서/미디어 변환 전담Picasso: 이미지 제작 전담 profile 구성 완료, Slack 연결 안내 문서 작성 단계
이후 2개의 봇이 더 추가됐습니다.
한비자-상앙 : 법률자문을 전담으로 해주는 법률봇
Libro-Vitae : "살아있는 책"이라는 의미로 llm wiki를 관리하는 역할
C&B는 Slack에서 멘션 기반으로 동작하도록 설정했고, gateway 로그에서도 정상 연결을 확인했습니다.
Authenticated as @copyandbinding
Socket Mode connected
slack connected
Bolt app is running!
사용한 도구
Hermes Agent: Slack gateway와 profile 기반 에이전트 운영
Slack App / Slack API: Bot Token, App-Level Token, Socket Mode, 이벤트 구독 설정
OpenAI Codex provider: C&B의 실제 응답 생성 모델
pytest: Slack
app_mention이벤트 처리 테스트shell/log 확인 도구: gateway 상태, 로그, 인증 오류 확인
진행 과정
1. Slack 토큰 위치부터 다시 확인함
처음에는 Slack bot token을 어디에 넣어야 하는지부터 정리했습니다.
기본 Hermes는 기본 .env, C&B는 별도 profile의 .env에 Slack 토큰을 넣어야 했습니다.
중요했던 점은 토큰 종류를 섞지 않는 것이었습니다.
SLACK_BOT_TOKEN # xoxb-... 형식
SLACK_APP_TOKEN # xapp-... 형식, Socket Mode용
Signing Secret, Verification Token, Webhook URL은 이 자리에 넣는 값이 아니었습니다.
2. 기본 Hermes Slack 인증 실패를 확인함
초기에는 Slack 연결이 되지 않았고, auth.test에서 invalid_auth가 나왔습니다.
{"ok": false, "error": "invalid_auth"}
이때 알게 된 것은, 봇이 채널에 초대되었는지보다 먼저 Bot User OAuth Token 자체가 유효해야 한다는 점이었습니다.
그래서 Slack App의 scope와 Socket Mode를 확인하고, OAuth 재설치 후 새 토큰을 반영하는 순서로 정리했습니다.
3. C&B를 별도 Slack 봇으로 분리함
C&B는 TARDIS와 같은 토큰을 쓰지 않도록 별도 Slack App과 별도 Hermes profile로 구성했습니다.
TARDIS: 기본 profile, 총괄/조율
C&B: cnb profile, @copyandbinding, 문서/미디어 변환 전담
이 분리가 중요했습니다. 같은 토큰을 재사용하면 Socket Mode 충돌이나 중복 응답 문제가 생길 수 있기 때문입니다.
4. "연결은 됐는데 안 움직이는" 문제를 로그로 좁힘
C&B 쪽에서는 Slack adapter 의존성이 빠져 있었습니다.
Slack: slack-bolt not installed
No adapter available for slack
토큰은 있어도, 실제 gateway가 Slack adapter를 띄우지 못하면 봇은 동작하지 않았습니다.
그래서 현재 Hermes 실행 환경에 slack-bolt, slack-sdk를 설치하고 gateway를 다시 시작했습니다.
5. provider 인증 문제도 따로 해결함
Slack 연결 다음에는 C&B가 응답 생성 단계에서 실패했습니다.
Provider authentication failed: Codex refresh token was already consumed by another client
이 문제는 Slack 문제가 아니라 Codex provider 인증 문제였습니다.
C&B profile의 인증 상태를 최신 Codex auth와 맞추고, 모델 설정을 다시 확인한 뒤 로컬 one-shot 응답으로 검증했습니다.
씨앤비(C&B)입니다. 문서와 미디어를 확인/변환/정리하고 결과물을 검증해 전달하는 전담 에이전트입니다.
6. 마지막 병목은 app_mention 이벤트 처리였음
가장 헷갈렸던 부분은 여기였습니다.
C&B gateway는 실행 중이고, Slack 인증도 정상이고, Socket Mode도 연결되어 있는데 @copyandbinding 안녕에는 반응하지 않았습니다.
확인해보니 Slack의 app_mention 이벤트는 들어오고 있었지만, Hermes Slack adapter가 그 이벤트를 실제 메시지 처리 함수로 넘기지 않고 있었습니다.
그래서 gateway/platforms/slack.py를 수정해 app_mention 이벤트도 메시지 처리 흐름으로 들어가게 했고, 테스트를 추가했습니다.
pytest ... TestAppMentionHandler ... 1 passed
실제 사용 예시
채널에서는 C&B가 멘션 기반으로 동작하도록 설정했습니다.
@copyandbinding 안녕
그냥 안녕만 보내면 반응하지 않을 수 있습니다.
SLACK_REQUIRE_MENTION=true, SLACK_STRICT_MENTION=true로 둔 이유는 여러 봇이 같은 채널에 있을 때 불필요한 응답 충돌을 줄이기 위해서였습니다.
Before vs After
Before: 토큰을 넣었는데도
invalid_auth, home channel 미설정, adapter 누락, provider 인증 실패, 멘션 무응답이 순서대로 발생함After: TARDIS와 C&B를 별도 profile과 별도 Slack App 기준으로 분리했고, C&B는
@copyandbinding멘션 기반으로 응답 가능한 구조까지 확인함
결과와 배운 점
Slack 봇 연결은 토큰 입력 하나로 끝나는 작업이 아니었습니다.
Bot Token과 App-Level Token, Socket Mode, Event Subscriptions, OAuth 재설치가 한 묶음으로 맞아야 했습니다.
Hermes처럼 profile을 나눠 쓰는 구조에서는
.env, gateway, provider 인증도 profile별로 분리해서 봐야 했습니다."봇이 온라인인데 답이 없음"은 Slack 연결 문제가 아니라 이벤트 처리 코드 문제일 수도 있었습니다.
로그를 단계별로 나누어 보면 문제를 Slack 인증, gateway adapter, provider 인증, 이벤트 핸들러 중 어디에서 봐야 할지 좁힐 수 있었습니다.
다음에 해볼 것
C&B Slack App에 private channel용 scope를 추가할지 검토
Picasso도 별도 Slack App token으로 연결
TARDIS, C&B, Picasso 각각의 역할과 호출 규칙을 채널 안내문으로 정리
새 Hermes profile을 만들 때 재사용할 Slack 연결 체크리스트 만들기


유피테르님, 이 글은 Slack 봇 연결에서 실제로 어디가 헷갈리는지 아주 잘 남겨주신 기록이라고 느꼈습니다. “토큰만 넣으면 끝”이 아니라 Bot Token, App-Level Token, Socket Mode, Event Subscriptions, profile별
.env, provider 인증,app_mention처리까지 각각 다른 층이라는 점을 단계별로 좁혀가신 흐름이 좋았습니다. 특히 로그를 기준으로 문제를 나눈 점이 인상적이었습니다.invalid_auth는 Slack 인증 문제, adapter 누락은 실행 환경 문제, provider authentication은 모델 인증 문제, 멘션 무응답은 이벤트 처리 문제처럼 분리해두면, 비슷한 오류를 만난 분들이 “지금 내가 어디를 봐야 하는지”를 찾는 데 큰 도움이 될 것 같습니다. 공개 글 기준으로는 지금처럼 토큰 값 자체를 드러내지 않고, 토큰 종류와 위치만 설명하는 방식이 안전해 보입니다. 여러 봇을 같은 채널에서 운영할 때 멘션 기반으로 제한한 것도 응답 충돌을 줄이는 좋은 운영 선택으로 보였습니다. 다음 단계에서는 새 Slack profile을 만들 때 재사용할 수 있는 체크리스트 하나만 따로 빼보시면 좋겠습니다. 예를 들면토큰 종류 확인 → profile별 env 확인 → Socket Mode 확인 → provider one-shot 확인 → app_mention 테스트정도로 정리해두면, 다음 봇을 붙일 때 시행착오가 훨씬 줄어들 것 같습니다.감사합니다. 어제부로 봇 5개를 모두 연결했습니다. 지금 단계에서는 strict mention으로 운영하지 않으면 정신이 없어서 일단 strict mention으로만 하고 있습니다. 이제 말씀하신대로 봇 1개를 더 연결할 때 말씀하신 프로세스를 정리해보도록 하겠습니다.