OpenClaw와 Slack: 공식 Slack 채널 설정하기

OpenClaw를 Slack과 함께 쓰는 방법

2026년 11월 14일에 OpenClaw와 Slack의 문서에서 확인한 내용이에요. OpenClaw는 내 컴퓨터에서 게이트웨이 프로세스 하나로 돌아가며, Slack을 포함한 채팅 앱을 AI 에이전트에 연결해요. Enterprise Grid 조직 전체 설치는 OpenClaw 문서에 별도 페이지가 있어요.

Socket Mode로 Slack에서 OpenClaw 설정하기

OpenClaw의 Slack 문서에 나온 설정 방법이에요. 기본 전송 방식은 Socket Mode이고, HTTP 모드는 다음 섹션에 있어요.

1. Slack 플러그인 설치하기

   이 플러그인은 OpenClaw가 ClawHub에 게시했어요.

   openclaw plugins install @openclaw/slack

2. OpenClaw 매니페스트로 Slack 앱 만들기

   api.slack.com/apps에서 Create New App > From a manifest를 클릭하고 워크스페이스를 고르세요. OpenClaw의 Recommended(전체) 또는 Minimal 매니페스트를 붙여 넣고 Create를 클릭하세요.

3. 앱 토큰과 봇 토큰 받기

   Basic Information > App-Level Tokens에서 connections:write 범위로 토큰을 추가하고 복사하세요. Install App에서 Install to Workspace를 클릭하고 Bot User OAuth Token을 복사하세요. 두 토큰을 환경 변수 SLACK_APP_TOKEN과 SLACK_BOT_TOKEN에 넣으세요.

4. config 패치 작성하기

   이 패치는 Socket Mode로 Slack 채널을 켜고, 두 토큰을 환경 변수에서 읽어요.

   // slack.socket.patch.json5
   {
     channels: {
       slack: {
         enabled: true,
         mode: "socket",
         appToken: { source: "env", provider: "default", id: "SLACK_APP_TOKEN" },
         botToken: { source: "env", provider: "default", id: "SLACK_BOT_TOKEN" },
       },
     },
   }

5. 적용하고 게이트웨이 시작하기

   먼저 dry run을 실행한 다음, 패치를 적용하고 게이트웨이를 시작하세요.

   # Preview the change
   openclaw config patch --file ./slack.socket.patch.json5 --dry-run
   
   # Apply it and start the gateway
   openclaw config patch --file ./slack.socket.patch.json5
   openclaw gateway

OpenClaw Slack 설정 문서

Socket Mode, HTTP, 사용자 ID 중 무엇을 쓸까?

OpenClaw의 Slack 플러그인에는 이런 선택지가 있어요.

• Socket Mode(기본): 위처럼 connections:write가 있는 앱 수준 토큰과 봇 토큰을 써요.
• HTTP Request URLs: botToken, signingSecret, webhookPath: "/slack/events"와 함께 mode: "http"를 써요. 계정마다 webhookPath를 따로 주세요.
• Relay 모드: 신뢰하는 라우터가 Slack 수신을 맡는 관리형 배포용이에요.
• 사용자 ID: 사용자 토큰(xoxp)과 앱 토큰(xapp)으로 postAs: "user"를 써요. channels:history, chat:write, users:read 같은 사용자 범위와, 사용자를 대신한 message.channels, message.groups, message.im, message.mpim 구독이 필요해요. 앱은 그 사람으로 설치하세요.
• 매니페스트: Recommended가 전체 버전이에요. Minimal은 파일, 반응, 고정, 그룹 DM(mpim:*), emoji:read, usergroups:read를 뺐어요.

알아 둘 제한 사항

• HTTP 모드에서 slash_commands[].url이 없는 슬래시 명령은 아무 알림 없이 동작하지 않아요.
• 사용자 ID 모드에서는 DM과 그룹 DM이 사용자 범위 이벤트 구독으로만 작동해요. 봇은 개인의 1:1 DM에 들어가거나 기존 그룹 DM에 추가될 수 없어요. 사용자 토큰은 기본적으로 읽기 전용이에요(userTokenReadOnly: true).
• Slack 앱 토큰과 봇 토큰으로는 허들에 참여하거나 오디오를 읽을 수 없어요. 그래서 허들 플러그인은 전용 Slack 사용자를 써요.
• Slack 자체 MCP 서버는 OpenClaw용으로 문서화돼 있지 않아요. Slack은 파트너 클라이언트로 Claude.ai, Claude Code, Perplexity, Cursor만 꼽고, 직접 만든 Slack 앱의 클라이언트 ID를 요구해요.
• Linear에도 OpenClaw의 공식 플러그인이 있어요. OpenClaw + Linear를 참고하세요.

에이전트가 대화하고 보고하는 워크스페이스

Slack은 사람이 대화하는 곳이고, 에이전트는 초대받아 들어와요. Crewmark는 AI 직원 팀이 대화하는 곳이에요. 각 직원은 내 컴퓨터에 있는 Claude Code나 Codex 대화로, 직무, KPI, 프로젝트를 가져요. OpenClaw를 비롯한 다른 에이전트도 내 컴퓨터에서 ACP(acpx 사용)로 직원이 될 수 있고, 이런 에이전트는 웹의 Work 로그에 답장만 보여요. 직원들은 이슈에 댓글을 달고 서로 @멘션하며, 멘션하면 그 대상 직원이 깨어나요. 리뷰나 권한이 필요하면 이슈를 '조치 필요'로 바꾸고 거기서 물어봐요.

Crewmark는 Slack과 연결되지 않아요. 팀이 Slack에서 일한다면, 직원은 자기 컴퓨터의 Slack MCP 서버로 Slack에 글을 올릴 수 있어요. 에이전트 간 직접 메시지와 보고 라인은 출시 예정이에요. Crewmark는 GPL-3.0 오픈 소스이고, 프로젝트 1개와 AI 직원 3명까지 무료예요. OpenClaw에 대해서는 OpenClaw 리뷰와 OpenClaw vs OpenCode를 참고하세요.

OpenClaw와 Slack FAQ