30분 만에 Slack AI Agent 만들기 — OpenClaw로 Claude 기반 Slack 봇 구축하기

기술 개요 요약

OpenClaw는 LLM 기반 AI 에이전트를 Slack 같은 채팅 플랫폼에 연결하기 위한 경량 프레임워크다.
Slack에서 발생한 메시지를 Gateway가 수신하고, 이를 LLM(Claude API)에 전달한 뒤 생성된 응답을 다시 Slack으로 반환하는 이벤트 기반 AI Agent 구조로 동작한다.

이 가이드에서는 약 30분 안에 Slack에서 대화하는 AI Agent를 구축하는 과정을 단계별로 설명한다.

---

사전 준비

다음 환경이 준비되어 있어야 한다.

Node 환경 확인

node --version
npm --version

권장 버전

항목	버전
Node.js	v18 이상
npm	v9 이상

필요한 계정

서비스	용도
Anthropic API	Claude 모델 사용
Slack Workspace	봇 테스트

Anthropic API Key 발급
https://console.anthropic.com

---

Step 1 — OpenClaw 설치

OpenClaw CLI를 전역으로 설치한다.

npm install -g openclaw

설치 확인

openclaw --version

버전이 출력되면 정상 설치된 것이다.

---

Step 2 — 프로젝트 생성 및 온보딩

작업 디렉토리를 만든다.

mkdir my-agent
cd my-agent

온보딩 위저드를 실행한다.

openclaw onboard

이 명령어는 다음 설정을 자동으로 진행한다.

• 모델 선택
• API Key 입력
• 채널 연결
• 설정 파일 생성

추천 설정

설정	값
Model	anthropic/claude-sonnet-4-5
Channel	Slack
Agent name	friday

실행 후 프로젝트에 다음 파일이 생성된다.

openclaw.json

---

Step 3 — AI Agent 성격 정의

OpenClaw에서 에이전트의 행동은 코드가 아니라 프롬프트 파일로 정의된다.

파일 생성

touch SOUL.md

예시 내용

# SOUL.md — AI 비서 정의

## 핵심
나는 Boss의 업무 비서다.

## 성격
- 간결하고 핵심 중심
- 한국어 사용
- 불필요한 인사 생략

## 역할
- 질문 답변
- 리서치 정리
- 문서 초안 작성
- 일정 관리 보조

## 경계
- 외부 메시지 발송 전 Boss 확인
- 확실하지 않은 정보는 "확인 필요" 표시

이 파일은 LLM 호출 시 System Prompt로 사용된다.

---

Step 4 — Slack 앱 생성

Slack에서 봇을 생성해야 한다.

Slack App 생성

https://api.slack.com/apps

1. Create App

Create New App
→ From Scratch

설정

항목	값
App Name	My AI Agent
Workspace	테스트 Workspace

---

Step 5 — Slack 권한 설정

메뉴

OAuth & Permissions

Bot Token Scopes 추가

Scope	설명
chat:write	메시지 전송
channels:history	채널 메시지 읽기
groups:history	비공개 채널 읽기
im:history	DM 읽기
app_mentions:read	멘션 감지

---

Step 6 — Socket Mode 활성화

메뉴

Socket Mode

활성화 후 App Token 생성

설정	값
Token name	socket
Scope	connections:write

생성되는 토큰

xapp-...

---

Step 7 — Event Subscriptions 설정

메뉴

Event Subscriptions

Enable 활성화 후 Bot Events 추가

message.channels
message.groups
message.im
app_mention

---

Step 8 — Slack 앱 설치

메뉴

Install App → Install to Workspace

설치 후 다음 토큰을 복사한다.

Bot User OAuth Token

형식

xoxb-...

---

Step 9 — openclaw.json 설정

토큰을 설정 파일에 추가한다.

{
  "model": "anthropic/claude-sonnet-4-5",
  "providers": {
    "anthropic": {
      "apiKey": "sk-ant-..."
    }
  },
  "slack": {
    "botToken": "xoxb-...",
    "appToken": "xapp-..."
  }
}

설정 검증

openclaw doctor

에러가 없다면 준비 완료다.

---

Step 10 — Gateway 실행

OpenClaw Gateway를 실행한다.

openclaw gateway start

정상 실행 로그

Gateway started
Slack socket connected
Agent "friday" ready

이 프로세스는 Slack 이벤트를 계속 모니터링하는 데몬 역할을 한다.

---

Step 11 — Slack에서 테스트

Slack에서 봇에게 DM을 보내거나 멘션한다.

예시

안녕! 너는 누구야?

또는

@friday AI 에이전트 장단점을 정리해줘

Claude API를 통해 응답이 생성된다.

---

동작 구조

전체 아키텍처

Slack Message
      ↓
Slack Events API
      ↓
Socket Mode
      ↓
OpenClaw Gateway
      ↓
Claude API
      ↓
Response 생성
      ↓
Slack Message 전송

Gateway가 AI Agent Runtime 역할을 수행한다.

---

실제 프로젝트 구조

예시

my-agent
 ├─ openclaw.json
 ├─ SOUL.md
 └─ logs

핵심 파일

파일	역할
openclaw.json	설정 파일
SOUL.md	Agent 성격 정의

---

실무 팁

1. 모든 메시지를 처리하지 말 것

추천 트리거

@mention
DM

---

2. API 비용 관리

LLM 호출 구조

Slack 메시지 → Claude API

대화량이 많아지면 비용이 증가한다.

---

3. 에이전트 성격 튜닝

행동을 바꾸고 싶다면

SOUL.md

파일을 수정하면 된다.

코드를 변경할 필요는 없다.

---

마무리

OpenClaw를 사용하면 코드를 거의 작성하지 않고도 Slack AI Agent를 구축할 수 있다.

핵심 개념은 단순하다.

Slack → Gateway → LLM → Slack

이 구조만 이해하면 다양한 확장이 가능하다.

예를 들어

• 사내 문서 검색 봇
• 개발자 Q&A 봇
• 고객 지원 봇
• 업무 자동화 비서

같은 AI Agent를 쉽게 만들 수 있다.

---

참고 자료

OpenClaw Documentation
https://docs.openclaw.ai

Anthropic Claude API
https://docs.anthropic.com

Slack API Documentation
https://api.slack.com