💬
Slack App 등록 완전 가이드 (OpenClaw 연동)
SlackOpenClaw봇설정토큰
Slack App을 OpenClaw와 연동하기 위해 처음부터 설정하는 방법을 정리한 실전 가이드.
1단계: Slack App 생성
- Slack API 접속 후 우측 상단 Create New App 버튼 클릭
- From scratch 선택
- App Name: 봇 이름 입력 (예: 뽀둥이, my-bot 등)
- Pick a workspace: 연결할 워크스페이스 선택
- Create App 클릭
2단계: 기본 정보 설정
Basic Information 메뉴에서:
- App Icon: 봇 이미지 업로드
- Background Color: 봇 색깔 선택
- Collaborators: 주인 멤버 연결 (옵션)
3단계: Bot Token 스코프 설정 (OAuth & Permissions)
OAuth & Permissions 메뉴 → Scopes 섹션 → Bot Token Scopes에 아래 권한 추가:
| 스코프 | 설명 |
|---|---|
app_mentions:read | 멘션 감지 |
assistant:write | 타이핑 표시 |
channels:history | 공개 채널 메시지 읽기 |
channels:read | 채널 정보 읽기 |
chat:write | 메시지 보내기 |
chat:write.customize | 커스텀 이름/아이콘으로 전송 |
commands | 슬래시 커맨드 |
emoji:read | 이모지 목록 접근 |
files:read | 파일 다운로드 |
files:write | 파일 업로드 |
groups:history | 비공개 채널 히스토리 |
groups:read | 비공개 채널 정보 |
im:history | DM 히스토리 |
im:read | DM 정보 |
im:write | DM 보내기 |
mpim:history | 그룹 DM 히스토리 |
mpim:read | 그룹 DM 정보 |
mpim:write | 그룹 DM 보내기 |
pins:read | 핀 읽기 |
pins:write | 핀 쓰기 |
reactions:read | 리액션 읽기 |
reactions:write | 리액션 추가/삭제 |
users:read | 유저 정보 조회 |
스코프 추가 후 상단에 뜨는 Install to Workspace (또는 Reinstall to Workspace) 버튼 클릭
주의 앱 설치가 안 된다고 하면 4단계(App Home)를 먼저 설정하고 돌아오면 된다.
4단계: App Home 설정
App Home 메뉴 → Your App's Presence in Slack 섹션:
- App Display Name 옆 "Edit" 버튼 클릭
- Display Name (Bot Name): 봇 이름 입력 (예: 뽀둥이)
- Default Username: 영문 이름 입력 (예: bbodoong)
- "Save" 클릭
- Always Show My Bot as Online 체크
Show Tabs 섹션:
- Home tab 체크
- Allow users to send Slash commands and messages from the messages tab 체크
5단계: 워크스페이스에 설치 & Bot Token 발급
OAuth & Permissions 메뉴 → Install to Workspace 버튼 클릭 → 승인
설치 완료 후 Bot User OAuth Token 발급됨 (xoxb-로 시작) → 복사 보관
6단계: Socket Mode 켜기
OpenClaw는 Socket Mode로 Slack과 통신한다. 반드시 켜야 봇이 메시지를 받을 수 있다.
- 왼쪽 메뉴 → Socket Mode 클릭
- Enable Socket Mode 토글 ON
- App-Level Token 생성 팝업이 뜨면:
- Token Name:
openclaw등 원하는 이름 입력 - Scope:
connections:write추가 - Generate 클릭
- Token Name:
- 생성된
xapp-으로 시작하는 토큰을 복사 보관
7단계: Event Subscriptions (이벤트 구독)
봇이 메시지를 "들을 수 있게" 이벤트를 등록해야 한다.
- 왼쪽 메뉴 → Event Subscriptions 클릭
- Enable Events 토글 ON
- Delayed Events 토글 ON
- Subscribe to bot events 섹션에서 이벤트 추가:
| 이벤트 | 필요 스코프 |
|---|---|
app_mention | app_mentions:read |
message.channels | channels:history |
message.groups | groups:history |
message.im | im:history |
message.mpim | mpim:history |
- Save Changes 클릭
참고 저장 후 상단에 reinstall 알림이 뜨면 다시 설치해줘야 한다.
8단계: 재설치 & 토큰 저장
OAuth & Permissions → Install to Workspace 클릭 → Bot User OAuth Token 복사 저장
9단계: 봇을 채널에 초대
원하는 채널에서:
/invite @봇이름10단계: openclaw.json 설정
앞 단계에서 받은 토큰들을 openclaw.json에 입력한다.
| 토큰 | 형태 | 찾는 곳 |
|---|---|---|
| Bot Token | xoxb-로 시작 | OAuth & Permissions → Bot User OAuth Token |
| App-Level Token | xapp-로 시작 | Basic Information → App-Level Tokens |
| Slack User ID | U로 시작 | Slack 프로필 → 점 3개(⋯) → Copy member ID |
설정 완료 후 재시작:
openclaw gateway restart완료 여기까지 마치면 OpenClaw 봇이 Slack에서 메시지를 받고 응답할 준비가 된다!