채널 통합

OpenClaw를 Slack에 연결하기

Slack 워크스페이스에 OpenClaw를 추가하세요. 슬래시 명령어 지원으로 채널, 스레드 또는 DM에서 AI 지원을 받으세요.

💼 왜 Slack을 사용해야 할까요?

✓WebSocket 연결 — Slack Bot API + Socket Mode를 통한 실시간 메시징
✓슬래시 명령어 — 네이티브 /clawd 명령어 인터페이스
✓스레드 지원 — 기록 컨텍스트로 대화를 체계적으로 관리
✓풍부한 서식 — 리액션과 핀이 있는 서식화된 응답
✓유연한 접근 — DM, 공개 채널, 비공개 채널

요구 사항

•Slack Bot 토큰 — xoxb-...로 시작
•Slack App 토큰 — xapp-...로 시작 (Socket Mode용)
•Slack App — 적절한 OAuth 스코프가 설정된 앱

설정 단계

Slack App 생성

Slack API 포털로 이동하여 새 애플리케이션을 만드세요:

• api.slack.com/apps 방문
• "Create New App" 클릭
• "From scratch" 선택
• 이름 지정 (예: "OpenClaw") 및 워크스페이스 선택

Bot 토큰 스코프 추가

봇의 OAuth 권한을 설정하세요:

• 사이드바에서 "OAuth & Permissions"로 이동
• "Bot Token Scopes"에서 다음을 추가:
- app_mentions:read — 멘션 읽기
- channels:history — 채널 메시지 보기
- channels:read — 채널 정보 보기
- chat:write — 메시지 보내기
- im:history — DM 기록 보기
- im:read — DM 정보 보기
- im:write — DM 대화 시작
- reactions:write — 리액션 추가
- users:read — 사용자 정보 보기

Socket Mode 활성화

Socket Mode는 공개 URL 없이 실시간 통신을 가능하게 합니다:

• 사이드바에서 "Socket Mode"로 이동
• "Enable Socket Mode" 토글 켜기
• connections:write 스코프로 App-Level 토큰 생성
• 토큰 복사 (xapp-...로 시작)

워크스페이스에 App 설치

앱을 설치하고 Bot 토큰을 받으세요:

• 사이드바에서 "Install App"으로 이동
• "Install to Workspace" 클릭
• 요청된 권한 승인
• Bot User OAuth 토큰 복사 (xoxb-...로 시작)

OpenClaw 설정

openclaw.json에 Slack 설정을 추가하세요:

{
  "channels": {
    "slack": {
      "enabled": true,
      "botToken": "xoxb-...",
      "appToken": "xapp-..."
    }
  }
}

채널에 봇 초대

봇이 응답할 채널에 봇을 추가하세요:

• Slack에서 채널 열기
• /invite @OpenClaw 입력
• 또는 채널 이름 클릭 -> 통합 -> 앱 추가
• openclaw restart로 OpenClaw를 재시작하고 봇을 멘션하여 테스트하세요.

기능

스레드 지원

설정 가능한 기록 범위로 스레드 내 대화 컨텍스트 유지.

이모지 리액션

봇이 메시지 확인 또는 상태 표시를 위해 리액션을 추가할 수 있습니다.

메시지 고정

나중에 쉽게 참조할 수 있도록 중요한 응답을 고정하세요.

슬래시 명령어

어디서나 빠른 AI 쿼리를 위해 /clawd를 사용하세요.

멤버 정보

필요할 때 워크스페이스 멤버 정보를 조회하세요.

DM 지원

봇과의 비공개 1:1 대화.

고급 설정

Slack 통합을 위한 전체 설정 옵션:

{
  "channels": {
    "slack": {
      "enabled": true,
      "botToken": "xoxb-...",
      "appToken": "xapp-...",
      "dm": {
        "enabled": true,
        "policy": "pairing",
        "allowFrom": ["U123", "U456"]
      },
      "channels": {
        "#general": {
          "allow": true,
          "requireMention": true,
          "users": ["U123"]
        }
      },
      "historyLimit": 50,
      "slashCommand": {
        "enabled": true,
        "name": "clawd"
      },
      "actions": {
        "reactions": true,
        "messages": true,
        "pins": true
      }
    }
  }
}

dm.enabled — 봇에 대한 직접 메시지 허용
dm.policy — DM 접근 정책 ("pairing" 또는 "open")
dm.allowFrom — DM이 허용된 사용자 ID 배열
channels — 채널별 설정 객체
requireMention — @멘션될 때만 응답
historyLimit — 컨텍스트에 포함할 메시지 수
slashCommand — 슬래시 명령어 설정 구성
actions — 리액션, 메시지, 핀 활성화/비활성화

채널 정책

허용 목록 모드

명시적으로 설정된 채널에서만 응답. 통제된 환경에 적합.

오픈 모드

봇이 초대된 모든 채널에서 응답. requireMention으로 응답을 제어하세요.

Slack 사용자 ID 가져오는 방법

프로필에서:

사용자 이름 클릭 -> 프로필 보기 -> 점 세 개(...) 클릭 -> 멤버 ID 복사

Slack 관리자에서:

워크스페이스 설정 -> 멤버 관리 -> 멤버 목록을 CSV로 내보내기

⚠️ 문제 해결

채널에서 봇이 응답하지 않나요?

봇이 채널에 초대되었고 올바른 스코프가 있는지 확인하세요. requireMention이 활성화되어 있는지 확인하세요.

Socket Mode 연결 오류가 발생하나요?

App 토큰(xapp-...)이 올바르고 connections:write 스코프가 있는지 확인하세요.

슬래시 명령어가 표시되지 않나요?

Slack 앱 설정에서 "Slash Commands"로 이동하여 Socket Mode를 가리키는 명령어를 수동으로 만드세요.

권한 거부 오류가 발생하나요?

새 스코프를 추가한 후 워크스페이스에 앱을 다시 설치하세요. 일부 스코프 변경은 재설치가 필요합니다.

Slack 연결 완료!

이제 더 많은 채널을 설정하거나 맞춤 스킬로 봇을 향상시키세요.

Discord 추가 스킬 탐색