사전 요구 사항
설정 가이드
Slack 앱 생성
- Slack API로 이동하여 Create New App을 클릭합니다
- From scratch를 선택합니다
- 앱 이름(예: “AI Assistant”)을 입력하고 워크스페이스를 선택합니다
- Create App을 클릭합니다
Socket Mode 활성화
- 왼쪽 사이드바에서 Socket Mode로 이동합니다
- Enable Socket Mode를 ON으로 토글합니다
- 토큰 이름을 지정하고(예: “claw-socket”) Generate를 클릭합니다
- App-Level Token(
xapp-으로 시작)을 복사합니다 — 나중에 필요합니다
Bot 권한 설정
- 사이드바의 OAuth & Permissions로 이동합니다
- Bot Token Scopes 아래에 다음 스코프들을 추가합니다:
chat:write— 메시지 전송im:history— DM 히스토리 읽기im:read— DM 보기im:write— DM 시작하기app_mentions:read— @mention 감지
- 상단의 Install to Workspace를 클릭합니다
- 앱을 승인합니다
- Bot User OAuth Token(
xoxb-로 시작)을 복사합니다
이벤트 활성화
- 사이드바의 Event Subscriptions로 이동합니다
- Enable Events를 ON으로 토글합니다
- Subscribe to bot events 아래에 다음을 추가합니다:
message.im— DM 메시지app_mention— 채널 내 @mention
- Save Changes를 클릭합니다
LemonData 대시보드에서 설정
- Claw 대시보드로 이동합니다
- 인스턴스의 설정 아이콘을 클릭합니다
- IM Integrations 탭을 엽니다
- Slack 섹션을 확장합니다
- App Token(
xapp-...)과 Bot Token(xoxb-...)을 붙여넣습니다 - Save를 클릭합니다
액세스 제어
그룹 설정
대시보드의 IM Integrations 탭에서 채널 액세스를 설정하세요:| 설정 | 옵션 | 설명 |
|---|---|---|
| Group Policy | Open (기본값) / Allowlist / Disabled | 봇이 응답할 채널을 제어합니다 |
| Require @mention | On / Off | @mention 되었을 때만 봇이 응답합니다 |
| Group IDs | 채널 ID 목록 | 특정 채널로 제한합니다 (비어 있음 = 모든 채널) |
| Group Allowed Users | 사용자 ID 목록 | 이 사용자들만 봇을 트리거할 수 있습니다 (allowlist 모드) |
문제 해결
봇이 DM에 응답하지 않습니다
봇이 DM에 응답하지 않습니다
- 두 토큰이 모두 정확한지 확인하세요 (App Token은
xapp-, Bot Token은xoxb-로 시작합니다) message.im이벤트가 구독되어 있는지 확인하세요- 앱이 워크스페이스에 설치되어 있는지 확인하세요
봇이 @mention에 응답하지 않습니다
봇이 @mention에 응답하지 않습니다
app_mentions:read스코프와app_mention이벤트가 설정되었는지 확인하세요- 봇이 먼저 해당 채널에 초대되어야 합니다 (
/invite @botname입력)
'not_allowed_token_type' 오류
'not_allowed_token_type' 오류
- App Token 필드에 Bot Token이 아닌 App-Level Token(
xapp-)을 사용하고 있는지 확인하세요 - Bot Token(
xoxb-)은 Bot Token 필드에 입력해야 합니다