netwaif

Slack Claude Orchestrator — Communication skill for Claude Code

Communication community

Orchestrator connecting Slack and local Claude Code with session management.

How to install Slack Claude Orchestrator

This entry records only its repository, not the path inside it, so there is no exact command to give. Open netwaif/slack-claude-orchestrator and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

What Slack Claude Orchestrator does

Orchestrator connecting Slack and local Claude Code with session management.

Alternatives in Communication

Open SaaS — A 100% free modern JS SaaS boilerplate (React, NodeJS, Prisma) 14.1k ★
Slack — Communication Slack integration via HTTP/OAuth MCP 14k ★
HolaOS — Open-source agentic workspace enterprises can make their own 10.9k ★

README

Slack Claude Orchestrator

Slack과 로컬 환경의 Claude Code를 연결하는 오케스트레이터입니다. Slack에서 메시지를 보내면, 로컬 환경에서 실행되는 Claude Code가 작업을 수행하고 결과를 Slack으로 반환합니다.

**플랫폼 지원**: Windows, macOS, Linux

핵심 기능

세션 관리: UUID 기반 대화 세션 유지
파일 첨부 지원: Slack에서 업로드한 파일을 Claude에게 전달 (다중 파일 지원)
비동기 처리: Threading으로 Slack 응답성 유지
Modal UI: 사용자 친화적인 입력 인터페이스

사용 예시

영수증 → 파일로 정리
아이폰 사진 → 블로그 업로드에 최적화된 파일로 변환
홈네트워크 장비 문제 점검
로컬 환경의 Claude Code가 할 수 있는 모든 작업

요구사항

Python 3.8+
Claude CLI 설치 필수 (claude --version으로 확인)
Slack 워크스페이스 관리자 권한

빠른 시작 (5분)

1. 저장소 클론 및 설정

macOS/Linux

git clone 
cd slack-claude-orchestrator
python -m venv venv
source venv/bin/activate
pip install -r requirements.txt

Windows (PowerShell)

git clone 
cd slack-claude-orchestrator
python -m venv venv
venv\Scripts\Activate.ps1
pip install -r requirements.txt

Windows (CMD)

git clone 
cd slack-claude-orchestrator
python -m venv venv
venv\Scripts\activate.bat
pip install -r requirements.txt

2. 환경변수 설정

macOS/Linux

cp .env.example .env
# .env 파일을 열어서 토큰 입력

Windows (PowerShell)

Copy-Item .env.example .env
# .env 파일을 열어서 토큰 입력

Windows (CMD)

copy .env.example .env
REM .env 파일을 열어서 토큰 입력

`.env` 파일 예시:

SLACK_BOT_TOKEN=xoxb-your-bot-token
SLACK_APP_TOKEN=xapp-your-app-token

3. Slack App 생성

자세한 내용은 [SETUP_GUIDE.md](SETUP_GUIDE.md) 참고

**필수 권한:**

files:read (⚠️ 파일 다운로드에 필수!)
app_mentions:read, chat:write
channels:history, groups:history, im:history, mpim:history

4. 봇 실행

python main.py

Slack에서 `@BotName` mention → "Respond" 버튼 → 작업 요청

아키텍처

slack-claude-orchestrator/
├── main.py              # Slack Bot 서버 (Socket Mode)
├── claude_runner.py     # Claude CLI 래퍼
├── slack_ui.py          # Modal/Block UI 컴포넌트
├── requirements.txt     # Python 의존성
├── .env.example         # 환경변수