사전 요구 사항
- 관리자 권한이 있는 Slack 워크스페이스
- LemonClaw 인스턴스:
- 호스팅형: Claw 인스턴스 생성
- 셀프 호스팅형: LemonClaw 설치
설정 가이드
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-으로 시작)을 복사합니다. 이 토큰이 필요합니다.
봇 권한 설정
- 사이드바에서 OAuth & Permissions로 이동합니다.
- Bot Token Scopes 아래에 다음 스코프를 추가합니다:
chat:write— 메시지 전송im:history— DM 기록 읽기im:read— DM 보기im:write— DM 시작app_mentions:read— @멘션 감지
- 상단의 Install to 워크스페이스를 클릭합니다.
- 앱을 승인합니다.
- Bot User OAuth Token(
xoxb-으로 시작)을 복사합니다.
이벤트 활성화
- 사이드바에서 Event Subscriptions로 이동합니다.
- Enable Events를 ON으로 토글합니다.
- Subscribe to bot events 아래에 다음을 추가합니다:
message.im— DM 메시지app_mention— 채널 내 @멘션
- Save Changes를 클릭합니다.
LemonClaw WebUI 열기
- 호스팅형 Claw를 사용하는 경우, Claw Dashboard로 이동하여 Open WebUI를 클릭합니다.
- LemonClaw를 셀프 호스팅하는 경우, 본인의 WebUI(예:
http://your-ip:18789)를 열고 토큰으로 로그인합니다. - WebUI에서 Settings → Channels로 이동합니다.
- Slack 섹션을 확장합니다.
- App Token(
xapp-...)과 Bot Token(xoxb-...)을 붙여넣습니다. - Save를 클릭합니다.
액세스 제어
그룹 설정
LemonClaw WebUI의 Channels 설정에서 채널 액세스를 구성하세요:| 설정 | 옵션 | 설명 |
|---|---|---|
| Group Policy | Open (기본값) / Allowlist / Disabled | 봇이 응답할 채널을 제어합니다 |
| Require @mention | On / Off | 봇이 @멘션되었을 때만 응답합니다 |
| Group IDs | 채널 ID 목록 | 특정 채널로 제한합니다 (비어 있음 = 모든 채널) |
| Group Allowed Users | 사용자 ID 목록 | 이 사용자들만 봇을 트리거할 수 있습니다 (allowlist 모드) |
문제 해결
봇이 DM에 응답하지 않음
봇이 DM에 응답하지 않음
- 두 토큰이 모두 올바른지 확인하세요 (App Token은
xapp-으로 시작, Bot Token은xoxb-로 시작) message.im이벤트가 구독되어 있는지 확인하세요- 앱이 워크스페이스에 설치되어 있는지 확인하세요
봇이 @멘션에 응답하지 않음
봇이 @멘션에 응답하지 않음
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 필드에 입력합니다