Slack 연동
기준일: 2026-07-26
난이도: 중급
공식 기준: Slack
개요
Hermes Slack 봇은 Bolt + Socket Mode(WebSocket) 로 동작합니다. 공개 HTTP 엔드포인트 없이 방화벽·노트북·사설 서버에서도 연결됩니다. Classic RTM 앱은 2025-03 폐기 — 새 앱을 만드세요.
핵심 개념
| 항목 | 값 |
|---|---|
| 라이브러리 | slack-bolt / slack_sdk |
| 연결 | WebSocket (공개 URL 불필요) |
| 토큰 | Bot xoxb- + App-Level xapp- (connections:write) |
| 사용자 ID | Member ID (U…) |
| 권장 생성 | hermes slack manifest --agent-view --write |
상세
빠른 앱 생성
hermes slack manifest --agent-view --write
# ~/.hermes/slack-manifest.json → api.slack.com From an app manifest
수동 시: Bot Token Scopes(chat:write, app_mentions:read, channels:history, groups:history, im:*, mpim:*, users:read, files:read/write 등), Socket Mode, 이벤트(message.im, message.mpim, message.channels, message.groups, app_mention), App Home Messages Tab, Install to Workspace.
Hermes 설정
SLACK_BOT_TOKEN=xoxb-...
SLACK_APP_TOKEN=xapp-...
SLACK_ALLOWED_USERS=U01ABC2DEF3
# SLACK_HOME_CHANNEL=C01234567890
hermes gateway setup
hermes gateway
응답 규칙
| 컨텍스트 | 동작 |
|---|---|
| 1:1 DM | 멘션 없이 응답 |
| 채널 | 기본 @멘션 필요, 스레드로 답 |
| 스레드 | 활성 세션 후 멘션 없이 이어가기 가능 |
| 그룹 DM(MPIM) | 공유 표면 — 채널과 같은 멘션/allow 정책 |
슬래시·스레드 !cmd
매니페스트에 등록된 /btw, /stop, /model 등. 스레드 안 네이티브 슬래시는 Slack 제한 → !queue, !stop 등 bang prefix. 슬래시 응답은 ephemeral.
주요 config
platforms:
slack:
reply_to_mode: "first" # off | first | all
extra:
reply_in_thread: true
rich_blocks: false
allow_bots: "none" # none | mentions | all
멘션 관련: require_mention, strict_mention, free_response_channels, ignore_other_user_mentions, thread_require_mention, allowed_channels.
상태줄: typing_status_text, display.live_status (assistant:write 스코프 필요).
멀티 워크스페이스: SLACK_BOT_TOKEN 콤마 목록 + ~/.hermes/slack_tokens.json.
트러블슈팅 체크
채널 무응답 시: message.channels/groups 이벤트, history 스코프, 재설치, /invite, @멘션. DM 차단 → Messages Tab. 스코프 변경 후 반드시 reinstall.
보안
SLACK_ALLOWED_USERS 설정(미설정 시 기본 거부). 토큰 비공개. allow_bots: all은 루프 위험 — peer 봇은 mentions 권장.
체크리스트
- 공식 원문과 명령·설정 키를 대조했다
- 로컬/
config.yaml/.env에서 재현 경로를 확인했다 - 권한·allowlist·시크릿 노출을 점검했다
- 실패 시 롤백·비활성화 방법을 알고 있다
다음 단계
- 공식 문서: Slack
- 메시징 게이트웨이
- Hermes Agent 소개
기준일: 2026-07-26 — 공식 문서 동기화 코퍼스