Slack 봇 설정

Claw Buff AI 에이전트를 Slack 워크스페이스에 연결해 보세요. 봇이 DM, 멘션, /claw 슬래시 명령어에 응답할 수 있어요. 설정은 약 10분이면 완료됩니다.

사전 준비

• 관리자 권한(또는 앱 설치 권한)이 있는 Slack 워크스페이스
• 배포된 Claw Buff 에이전트 (시작하기)

1단계: Slack 앱 만들기

{
  "display_information": {
    "name": "Claw Buff",
    "description": "AI agent powered by Claw Buff"
  },
  "features": {
    "bot_user": {
      "display_name": "Claw Buff",
      "always_online": false
    },
    "assistant_view": {
      "assistant_description": "AI agent powered by Claw Buff"
    },
    "app_home": {
      "messages_tab_enabled": true,
      "messages_tab_read_only_enabled": false
    }
  },
  "oauth_config": {
    "scopes": {
      "bot": [
        "chat:write",
        "channels:history",
        "channels:read",
        "groups:history",
        "im:history",
        "im:read",
        "im:write",
        "users:read",
        "app_mentions:read",
        "assistant:write"
      ]
    }
  },
  "settings": {
    "event_subscriptions": {
      "bot_events": [
        "app_mention",
        "assistant_thread_started",
        "message.im"
      ]
    },
    "socket_mode_enabled": true
  }
}

2단계: Claw Buff에 연결하기

1. Claw Buff 콘솔 → 채널 페이지를 여세요
2. Slack 카드를 찾고 연결을 클릭하세요
3. 두 토큰을 모두 붙여넣으세요:
   • 봇 토큰 (xoxb-...)
   • 앱 토큰 (xapp-...)
4. 저장 및 활성화를 클릭하세요

봇이 Socket Mode로 연결돼요 — 공개 URL이나 웹훅이 필요 없어요.

3단계: 계정 페어링하기

봇이 응답하려면 먼저 Slack 계정을 페어링해야 해요:

1. 봇에게 DM 보내기 — Slack 사이드바의 Apps에서 봇을 찾아 아무 메시지나 보내세요 (예: "hello")
2. 봇이 페어링 코드를 회신해요 (예: 7EPLYS7R)
3. Claw Buff 콘솔 → 채널 페이지로 이동하세요
4. 대기 중인 페어링 요청 섹션에서 해당 코드 옆의 승인을 클릭하세요

승인이 완료되면 봇이 메시지에 즉시 응답해요.

4단계: 채널 활성화 (선택 사항)

기본적으로 봇은 DM에서만 작동해요. Slack 채널에서 사용하려면:

1. Slack에서 채널 이름을 우클릭 → 채널 세부 정보 보기 → 패널 하단의 Channel ID를 복사하세요

2. 콘솔에서 채널 → Slack 카드의 관리를 클릭하세요
3. 인증된 채널에서 Channel ID를 붙여넣고 추가를 클릭하세요
4. Slack에서 봇을 채널에 초대하세요: /invite @YourBotName 입력

봇이 해당 채널에서 @멘션에 응답하게 돼요. 여러 채널을 추가할 수 있어요.

5단계: 대화 시작하기

• 봇에게 DM — Slack 사이드바의 Apps에서 봇을 찾으세요
• 채널에서 멘션 — @YourBotName을 입력한 후 메시지를 작성하세요
• App Home — 봇의 App Home 탭을 열면 전용 채팅 인터페이스를 사용할 수 있어요

지원 기능

자주 묻는 질문

1. 봇이 응답하지 않나요?

• 두 토큰 모두 확인 — 봇 토큰 (xoxb-)과 앱 토큰 (xapp-) 모두 필요해요
• Socket Mode 확인 — Slack 앱 설정에서 Socket Mode가 활성화되어 있는지 확인하세요
• 콘솔 확인 — 채널 페이지에서 연결 상태와 오류 로그를 확인하세요

2. 봇이 DM에 응답하지 않나요?

다음 스코프가 있는지 확인하세요: im:history, im:read, im:write. 위의 매니페스트를 사용했다면 이미 포함되어 있어요.

3. 채널에서 멘션해도 봇이 응답하지 않나요?

• 봇을 먼저 채널에 초대해야 해요 (/invite @Claw Buff 입력)
• app_mentions:read와 channels:history 스코프가 있는지 확인하세요

4. "not_allowed_token_type" 오류가 나오나요?

봇 토큰과 앱 토큰이 바뀌었을 수 있어요. 봇 토큰은 xoxb-로 시작하고, 앱 토큰은 xapp-으로 시작해요.