---
title: "오픈클로(OpenClaw)로 슬랙 AI 비서 만들기 — 설치부터 봇 연동까지 실전 가이드"
published: 2026-04-18T00:05:03.146Z
canonical: https://jeff.news/article/1780
---
# 오픈클로(OpenClaw)로 슬랙 AI 비서 만들기 — 설치부터 봇 연동까지 실전 가이드

오픈소스 AI 에이전트 런타임 OpenClaw를 활용해 슬랙 AI 비서를 직접 세팅하는 과정을 단계별로 정리한 실전 튜토리얼이다. 터미널과 Claude Code 설치, OpenClaw 설치, 슬랙 봇 토큰 발급, 매니페스트 구성, 웹 UI에서 에이전트 관리까지 필요한 모든 절차를 다룬다.

- 오픈소스 AI 에이전트 런타임 '오픈클로(OpenClaw)'를 써서 슬랙 AI 비서를 직접 세팅하는 방법을 정리한 실전 가이드
  - 오스트리아 개발자 페터 슈타인베르거(Peter Steinberger)가 만든 오픈소스 AI 에이전트 런타임
  - 운영체제 수준 접근 권한을 가지고 Claude/GPT/DeepSeek 같은 LLM과 슬랙·텔레그램·디스코드 같은 메신저를 연결하는 프레임워크
  - 요약하자면 "내 컴퓨터에서 돌아가는 AI 비서 프레임워크"

### 설치 사전 준비
- 터미널 설치가 먼저 — 맥은 iTerm2, 윈도우는 cmder 추천
- Claude Code 네이티브 인스톨
  - Claude 설정 메뉴에서 Claude Code 찾아서 네이티브 인스톨 선택
  - 맥OS용 설치 명령어를 복사해 터미널에 붙여넣기
  - 설치 후 PATH 설정 안내 코드를 실행, 터미널에 `claude` 입력 시 실행되면 OK
  - 초기화된 상태에서 설치해야 다른 환경과 충돌 방지

### API vs 구독 계정
- Claude Code를 API로 쓸지 구독 계정으로 쓸지 결정해야 함
  - API는 사용량 폭주 시 청구서가 무섭게 올라갈 수 있어서 구독 계정 권장
  - 웹에서 로그인 → 승인 클릭으로 바로 연동

### OpenClaw 설치
- 공식 문서의 퀵 스타터 명령어를 `sudo` 붙여서 관리자 권한으로 실행
- AI 모델 설정 단계에선 API 키가 아니라 '토큰' 입력이 필요
  - 새 터미널에서 `claude setup token` → 승인 → 발급된 토큰을 복사해서 입력
  - 모델은 일반적으로 Sonnet이면 충분
- 채널은 슬랙 선택, 에이전트 이름은 원하는 대로 — 참고한 영상에선 '엄석대'로 지었다는 깨알

### 슬랙 봇 토큰 발급
- api.slack.com → Create New App → From Scratch
  - 앱 이름 설정 후 Socket Mode 활성화
  - 이때 `xapp`으로 시작하는 앱 토큰이 발급됨 → **반드시 메모해둘 것**
- 매니페스트로 봇 권한 구성
  - JSON 형식으로 권한 설정
  - 앱 이름은 한글 미지원 → 영어로
  - 매니페스트 붙여넣고 'Install to Workspace' 클릭하면 봇이 워크스페이스에 설치됨

> [!TIP]
> 터미널에 토큰 입력할 때 공백 들어가면 에러 뜸. 채널 이름 인식 안 되면 채널 ID 복사해서 입력하면 정확하게 잡힘.

### 최종 세팅 — 스킬, 훅, 웹 UI
- 컴퓨터 스킬은 전체 사용으로 설정
- 구글 플레이스 API 같은 외부 API 키는 나중에 설정해도 무방
- 훅(Hook) — 스킬 실행 전후에 로그 남기거나 메모리 저장하는 기능, 전부 체크 권장
- 웹 UI에서 에이전트 관리
  - OpenClaw의 핵심 개념은 "에이전트에게 정체성과 역할, 툴을 부여"
  - 'who you are' 항목에서 에이전트의 역할 정의, 언제든 업데이트 가능

### 슬랙 채널 연결과 활용
- 봇을 슬랙 채널에 초대할 땐 "멤버"가 아니라 "앱"으로 초대해야 함
  - 비공개 채널은 권한 문제로 초대 안 될 수 있으니 주의
- 에이전트를 진짜 쓸만하게 만드는 건 '메모리 업데이트'와 '스킬 구성'
  - 기억시키고 싶은 내용 입력 → 에이전트가 컨텍스트로 활용
  - 태그됐을 때만 응답하거나 스레드로 대화 이어가게 설정 가능
  - 카드 뉴스 생성, 데일리 루틴 알림 같은 스킬을 만들어 매일 아침 9시 자동 실행도 가능
- 필자 본인도 세팅 후 "아침에 AI 아티클 자동 수신"용으로 유용하게 쓰는 중이라고

## 핵심 포인트

- OpenClaw는 OS 수준 접근권한으로 LLM과 메신저를 연결하는 오픈소스 AI 에이전트 런타임
- Claude Code는 구독 계정 연동을 추천 — API 사용량 폭주로 비용 폭탄 방지
- 슬랙 앱 생성 시 Socket Mode 활성화로 xapp 앱 토큰 발급, 매니페스트 JSON으로 권한 구성
- 봇은 '멤버'가 아니라 '앱'으로 채널에 초대해야 함, 비공개 채널은 권한 이슈 주의
- 에이전트 메모리 업데이트와 스킬 구성으로 데일리 루틴 자동화까지 확장 가능

## 인사이트

MCP 뜨기 시작하면서 '내 컴퓨터에 에이전트 돌리기' 판이 본격적으로 커지는 중. OpenClaw는 Claude Code를 기반으로 돌리는 구조라 구독자라면 비교적 쉽게 얹어볼 수 있는 스택임.
