본문으로 건너뛰기

토큰만 넣으면 끝인 줄 알았던 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 연결 체크리스트 만들기

2

함께 이야기해요 2

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

Giacomo 프로필 이미지
Giacomo2026.05.26

유피테르님, 이 글은 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 테스트 정도로 정리해두면, 다음 봇을 붙일 때 시행착오가 훨씬 줄어들 것 같습니다.

유피테르 프로필 이미지
유피테르2026.05.26

감사합니다. 어제부로 봇 5개를 모두 연결했습니다. 지금 단계에서는 strict mention으로 운영하지 않으면 정신이 없어서 일단 strict mention으로만 하고 있습니다. 이제 말씀하신대로 봇 1개를 더 연결할 때 말씀하신 프로세스를 정리해보도록 하겠습니다.

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

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

이런 사례도 있어요

사례 전체 보기