OpenClaw Slack 스킬 가이드

OpenClaw Slack 스킬 개요

Slack 스킬은 OpenClaw를 Slack 워크스페이스에 연결하여 AI 에이전트가 자연어로 메시지 전송, 리액션 관리, 핀 고정, 대화 읽기를 수행할 수 있게 합니다. 터미널과 Slack 사이를 오가지 않고 OpenClaw에 요청하면 몇 초 만에 일상적인 메시지 작업을 완료할 수 있습니다.

Slack은 가장 널리 사용되는 팀 커뮤니케이션 플랫폼 중 하나이며, OpenClaw와 통합하면 강력한 자동화 워크플로를 활용할 수 있습니다. 배포 알림 게시, 메시지 리액션, 중요한 결정 핀 고정 등 OpenClaw Slack 스킬은 여러 단계의 Slack 작업을 간단한 대화로 변환합니다.

일반적인 워크플로:

1. OpenClaw에 #releases 채널로 배포 업데이트를 보내달라고 요청합니다.
2. 에이전트가 설정된 Bot Token을 사용하여 Slack API를 호출합니다.
3. 메시지가 즉시 전송됩니다 — 컨텍스트 전환이 필요 없습니다.

이 스킬은 두 가지 연결 모드를 지원합니다: Socket Mode(개발 및 소규모 팀에 권장)와 HTTP Events API(방화벽 뒤의 프로덕션 배포에 적합). 두 모드 모두 동일한 Bot Token을 사용하며 동일한 기능을 제공합니다.

Slack 스킬 사전 요구 사항

Slack 스킬을 설치하기 전에 다음을 확인하세요:

• OpenClaw이 설치되어 실행 중 (v1.0+)
• 앱을 설치할 권한이 있는 Slack 워크스페이스
• api.slack.com/apps에서 필요한 OAuth 스코프를 설정한 Slack 앱 생성 완료
• 스킬 관리를 위한 clawhub CLI 설치 — clawhub으로 설치

필요한 OAuth 스코프 (Bot Token)

Slack 앱 생성 시 다음 Bot Token 스코프를 추가하세요:

| 스코프 | 용도 | |-------|------| | chat:write | 메시지 전송 및 편집 | | channels:history | 채널 메시지 기록 읽기 | | channels:read | 채널 정보 목록 및 확인 | | im:history | 다이렉트 메시지 기록 읽기 | | im:write | 다이렉트 메시지 전송 | | reactions:read | 메시지 리액션 목록 | | reactions:write | 이모지 리액션 추가 | | pins:read | 핀 고정 항목 목록 | | pins:write | 메시지 핀 고정 및 해제 | | emoji:read | 커스텀 이모지 목록 접근 | | app_mentions:read | @멘션에 응답 |

선택 사항: 메시지별 봇 표시 이름을 커스터마이징하려면 chat:write.customize를, 파일 작업에는 files:read와 files:write를 추가하세요.

설정 확인:

# OpenClaw 버전 확인
openclaw --version

# clawhub 설치 확인
clawhub --version

Slack 스킬 설치 방법

한 줄 명령으로 Slack 스킬을 설치합니다:

npx clawhub@latest install slack

설치 확인:

clawhub list

설치된 스킬 목록에 slack이 표시되어야 합니다. 이 스킬은 ClawHub의 steipete가 게시하며 정기적으로 업데이트됩니다.

Slack 스킬 구성

Slack 스킬에는 Bot Token과 Socket Mode의 경우 App Token이 필요합니다. OpenClaw는 환경 변수에서 이러한 토큰을 자동으로 읽습니다.

환경 설정

# 필수: Bot Token (xoxb-로 시작)
export SLACK_BOT_TOKEN=xoxb-your-bot-token-here

# Socket Mode에 필수 (xapp-로 시작)
export SLACK_APP_TOKEN=xapp-your-app-token-here

중요: 토큰을 설정 파일에 하드코딩하지 마세요. 환경 변수 또는 1Password나 Bitwarden과 같은 시크릿 매니저를 사용하세요.

연결 모드

Socket Mode (기본):

• SLACK_BOT_TOKEN과 SLACK_APP_TOKEN 필요
• 공용 URL 불필요 — 로컬 개발에 적합
• openclaw gateway로 시작

HTTP Events API:

• SLACK_BOT_TOKEN과 Signing Secret 필요
• Webhook 엔드포인트 설정 (기본: /slack/events)
• 리버스 프록시 뒤의 프로덕션 환경에 적합

접근 제어

OpenClaw는 Slack 상호작용에 대한 세밀한 접근 제어를 제공합니다:

• DM 정책: pairing (기본), allowlist, open 또는 disabled
• 채널 정책: open, allowlist 또는 disabled
• 멘션 필수: 채널에서는 기본적으로 @bot 멘션이 필요

팀 환경에서는 pairing DM 정책을 권장합니다. 사용자는 openclaw pairing approve slack <code>를 실행해야 봇이 DM에 응답합니다. 안전 체크리스트에서 추가 보안 강화 팁을 확인하세요.

Slack 스킬 사용 예시

1. 배포 알림 게시

사용자: "#releases 채널에 버전 2.4.0이 다운타임 없이 프로덕션에 배포되었다는 메시지를 보내줘."

에이전트가 대상 채널과 메시지 내용을 지정하여 sendMessage를 호출합니다. 알림이 봇 ID로 채널에 즉시 나타납니다.

2. 팀 결정에 리액션

사용자: "#engineering-decisions의 최신 메시지에 체크마크 리액션을 추가해줘."

에이전트가 readMessages로 지정 채널의 최신 메시지를 읽고 react으로 ✅ 리액션을 추가합니다. 결정 확인이나 검토 완료 표시에 적합합니다.

3. 중요 업데이트 핀 고정

사용자: "#product 채널에서 Q1 로드맵에 관한 메시지를 핀 고정해줘."

에이전트가 최근 메시지에서 "Q1 로드맵"과 일치하는 내용을 검색한 후 pinMessage로 핀 고정합니다. 핀 고정된 메시지는 채널 상단에 유지되어 팀 전체가 쉽게 접근할 수 있습니다.

4. 채널 활동 읽기 및 요약

사용자: "오늘 #support 채널에서 무슨 일이 있었는지 요약해줘."

에이전트가 readMessages로 당일 메시지를 가져온 후 주요 주제, 질문, 해결책을 분석하고 요약합니다. 긴 대화에는 Summarize 스킬과 함께 사용하면 더 좋습니다.

보안 및 모범 사례

Slack 스킬은 워크스페이스에서 메시지를 전송하고 콘텐츠를 수정할 수 있습니다. 안전을 위해 다음 가이드라인을 따르세요:

• 최소 권한 원칙. 실제로 필요한 OAuth 스코프만 부여하세요. 채널 읽기만 필요하다면 chat:write와 pins:write는 건너뛰세요.
• 페어링 모드 활성화. 기본 pairing DM 정책은 비인가 사용자가 DM에서 봇과 상호작용하는 것을 방지합니다.
• 전송 전 확인. OpenClaw는 기본적으로 메시지 전송 전 확인을 요청합니다. 프로덕션 워크스페이스에서는 이 기능을 비활성화하지 마세요.
• 채널 접근 제한. allowlist 채널 정책을 사용하여 봇을 특정 채널로 제한하고 워크스페이스 전체 접근을 피하세요.
• 토큰 정기 교체. Bot Token을 정기적으로 재생성하고 더 이상 사용하지 않는 토큰은 Slack 앱 관리 페이지에서 취소하세요.
• 메시지 활동 감사. Slack 워크스페이스 감사 로그를 확인하여 봇이 보낸 메시지를 검토하세요.

Slack 스킬 일반적인 오류 해결

"not_authed" 또는 "invalid_auth"

Bot Token이 없거나 유효하지 않습니다.

# 토큰이 설정되어 있는지 확인
echo $SLACK_BOT_TOKEN

# 필요 시 재내보내기
export SLACK_BOT_TOKEN=xoxb-your-new-token

토큰이 최근에 재생성되었다면 사용 중인 모든 환경에서 업데이트되었는지 확인하세요.

"channel_not_found"

봇이 지정된 채널에 접근할 수 없습니다. 일반적으로 다음을 의미합니다:

1. 봇이 채널에 초대되지 않음 — 채널에서 /invite @your-bot-name을 입력하세요.
2. 채널 ID가 잘못됨 — Slack API 또는 채널의 컨텍스트 메뉴에서 올바른 ID를 확인하세요.
3. 채널이 비공개이고 봇에 groups:read 스코프가 없음.

"missing_scope"

Bot Token에 필요한 OAuth 스코프가 누락되었습니다.

1. api.slack.com/apps → 앱 → OAuth & Permissions로 이동하세요.
2. 오류 메시지에 표시된 누락된 스코프를 추가하세요.
3. 새로운 스코프를 적용하기 위해 워크스페이스에 앱을 다시 설치하세요.