​

Slack

​

빠른 설정

{
  channels: {
    slack: {
      enabled: true,
      mode: "socket",
      appToken: "xapp-...",
      botToken: "xoxb-...",
    },
  },
}

SLACK_APP_TOKEN=xapp-...
SLACK_BOT_TOKEN=xoxb-...

openclaw gateway

{
  channels: {
    slack: {
      enabled: true,
      mode: "http",
      botToken: "xoxb-...",
      signingSecret: "your-signing-secret",
      webhookPath: "/slack/events",
    },
  },
}

​

토큰 모델

• botToken + appToken은 소켓 모드에 필수입니다.
• HTTP 모드는 botToken + signingSecret이 필요합니다.
• 구성 토큰은 환경 변수 대체보다 우선합니다.
• SLACK_BOT_TOKEN / SLACK_APP_TOKEN 환경 변수 대체는 기본 계정에만 적용됩니다.
• userToken (xoxp-...)은 구성에서만 사용 가능하며 (환경 변수 대체 없음) 기본적으로 읽기 전용 동작 (userTokenReadOnly: true)을 가집니다.
• 선택 사항: 발신 메시지를 활성 에이전트 신원(사용자 정의 username 및 아이콘)을 사용하도록 하려면 chat:write.customize를 추가하십시오. icon_emoji는 :emoji_name: 구문을 사용합니다.

​

접근 제어 및 라우팅

​

명령어 및 슬래시 동작

• 네이티브 명령어 자동 모드는 Slack에 대해 비활성화되어 있습니다 (commands.native: "auto"는 Slack 네이티브 명령어를 활성화하지 않음).
• channels.slack.commands.native: true (혹은 글로벌 commands.native: true)로 Slack 네이티브 명령어 핸들러를 활성화하세요.
• 네이티브 명령어가 활성화되면, Slack에 일치하는 슬래시 명령어를 등록하세요 (/<command> 이름).
• 네이티브 명령어가 활성화되지 않은 경우, channels.slack.slashCommand를 통해 단일 구성된 슬래시 명령어를 실행할 수 있습니다.
• 네이티브 인수 메뉴는 다음과 같이 렌더링 전략에 적응합니다:
  • 최대 5개 옵션: 버튼 블록
  • 6-100개 옵션: 정적 선택 메뉴
  • 100개를 초과하는 옵션: 상호작용 옵션 핸들러가 있는 경우 비동기 옵션 필터링과 함께 외부 선택 사용
  • 인코딩된 옵션 값이 Slack 제한을 초과할 경우, 흐름은 버튼으로 되돌아갑니다
• 긴 옵션 페이로드에 대해, 슬래시 명령어 매개변수 메뉴는 값을 선택하기 전에 확인 대화를 사용합니다.

• enabled: false
• name: "openclaw"
• sessionPrefix: "slack:slash"
• ephemeral: true

• agent:<agentId>:slack:slash:<userId>

​

쓰레딩, 세션 및 응답 태그

• 다이렉트 메시지는 direct로 라우팅되고, 채널은 channel, MPIM은 group으로 라우팅됩니다.
• 기본 session.dmScope=main으로, Slack 다이렉트 메시지는 에이전트 메인 세션에 통합됩니다.
• 채널 세션: agent:<agentId>:slack:channel:<channelId>.
• 스레드 응답은 경우에 따라 스레드 세션 접미사 (:thread:<threadTs>)를 생성할 수 있습니다.
• channels.slack.thread.historyScope 기본값은 thread; thread.inheritParent 기본값은 false입니다.
• channels.slack.thread.initialHistoryLimit는 새 스레드 세션이 시작될 때 가져올 기존 스레드 메시지 수를 제어합니다 (기본값 20; 비활성화하려면 0으로 설정).

• channels.slack.replyToMode: off|first|all (기본값 off)
• channels.slack.replyToModeByChatType: direct|group|channel별
• 다이렉트 채팅에 대한 기존 대체: channels.slack.dm.replyToMode

• [[reply_to_current]]
• [[reply_to:<id>]]

​

미디어, 청킹 및 전달

​

조작 및 게이트

​

이벤트 및 운영 행동

• 메시지 수정/삭제/스레드 방송은 시스템 이벤트로 매핑됩니다.
• 반응 추가/삭제 이벤트는 시스템 이벤트로 매핑됩니다.
• 멤버 가입/탈퇴, 채널 생성/이름 변경, 핀 추가/제거 이벤트는 시스템 이벤트로 매핑됩니다.
• 어시스턴트 스레드 상태 업데이트 (스레드에서 “입력 중…” 표시기용)는 assistant.threads.setStatus를 사용하며 봇 범위 assistant:write가 필요합니다.
• channel_id_changed는 configWrites가 활성화되었을 때 채널 구성 키를 마이그레이션할 수 있습니다.
• 채널 주제/목적 메타데이터는 신뢰할 수 없는 컨텍스트로 취급되며 라우팅 컨텍스트에 주입될 수 있습니다.
• 블록 작업 및 모달 상호작용은 구조화된 Slack interaction: ... 시스템 이벤트와 풍부한 페이로드 필드를 방출합니다:
  • 블록 작업: 선택한 값, 레이블, 선택자 값, workflow_* 메타데이터
  • 모달 view_submission 및 view_closed 이벤트는 라우팅된 채널 메타데이터 및 양식 입력과 함께 제공됩니다.

​

Ack 반응

• channels.slack.accounts.<accountId>.ackReaction
• channels.slack.ackReaction
• messages.ackReaction
• 에이전트 신원 이모지 대체 (agents.list[].identity.emoji, 없으면 ”👀”)

• Slack은 쇼트코드 (예: "eyes")를 기대합니다.
• 채널이나 계정에 대해 반응을 비활성화하려면 ""를 사용하세요.

​

매니페스트 및 범위 체크리스트

{
  "display_information": {
    "name": "OpenClaw",
    "description": "Slack connector for OpenClaw"
  },
  "features": {
    "bot_user": {
      "display_name": "OpenClaw",
      "always_online": false
    },
    "app_home": {
      "messages_tab_enabled": true,
      "messages_tab_read_only_enabled": false
    },
    "slash_commands": [
      {
        "command": "/openclaw",
        "description": "Send a message to OpenClaw",
        "should_escape": false
      }
    ]
  },
  "oauth_config": {
    "scopes": {
      "bot": [
        "chat:write",
        "channels:history",
        "channels:read",
        "groups:history",
        "im:history",
        "mpim:history",
        "users:read",
        "app_mentions:read",
        "assistant:write",
        "reactions:read",
        "reactions:write",
        "pins:read",
        "pins:write",
        "emoji:read",
        "commands",
        "files:read",
        "files:write"
      ]
    }
  },
  "settings": {
    "socket_mode_enabled": true,
    "event_subscriptions": {
      "bot_events": [
        "app_mention",
        "message.channels",
        "message.groups",
        "message.im",
        "message.mpim",
        "reaction_added",
        "reaction_removed",
        "member_joined_channel",
        "member_left_channel",
        "channel_rename",
        "pin_added",
        "pin_removed"
      ]
    }
  }
}

​

문제 해결

openclaw channels status --probe
openclaw logs --follow
openclaw doctor

openclaw pairing list slack

​

텍스트 스트리밍

• off: 실시간 미리보기 스트리밍 비활성화.
• partial (기본값): 미리보기 텍스트를 최신 부분 출력으로 교체.
• block: 청크된 미리보기 업데이트를 추가.
• progress: 생성 중에 진행 상태 텍스트를 표시하고 최종 텍스트를 전송.

channels:
  slack:
    streaming: partial
    nativeStreaming: false

• channels.slack.streamMode (replace | status_final | append)는 channels.slack.streaming으로 자동 마이그레이션됩니다.
• boolean channels.slack.streaming은 channels.slack.nativeStreaming으로 자동 마이그레이션됩니다.

​

Requirements

1. Slack 앱 설정에서 Agents and AI Apps를 활성화합니다.
2. 앱에 assistant:write 범위가 있는지 확인합니다.
3. 해당 메시지에 사용할 수 있는 응답 스레드가 있어야 합니다. 스레드 선택은 여전히 replyToMode를 따릅니다.

​

Behavior

• 첫 번째 텍스트 청크는 스트림을 시작합니다 (chat.startStream).
• 나중 텍스트 청크는 동일한 스트림에 추가됩니다 (chat.appendStream).
• 응답 종료는 스트림을 완료합니다 (chat.stopStream).
• 미디어 및 텍스트가 아닌 페이로드는 일반 전달로 대체됩니다.
• 스트리밍이 응답 중 실패하면, OpenClaw는 나머지 페이로드에 대해 일반 전달로 대체됩니다.

​

구성 참조 포인터

• 구성 참조 - Slack 신호 강도가 높은 Slack 필드:
  • 모드/인증: mode, botToken, appToken, signingSecret, webhookPath, accounts.*
  • DM 접근: dm.enabled, dmPolicy, allowFrom (기존: dm.policy, dm.allowFrom), dm.groupEnabled, dm.groupChannels
  • 채널 접근: groupPolicy, channels.*, channels.*.users, channels.*.requireMention
  • 쓰레딩/히스토리: replyToMode, replyToModeByChatType, thread.*, historyLimit, dmHistoryLimit, dms.*.historyLimit
  • 전달: textChunkLimit, chunkMode, mediaMaxMb, streaming, nativeStreaming
  • 운영/기능: configWrites, commands.native, slashCommand.*, actions.*, userToken, userTokenReadOnly

​

관련 항목

• Pairing
• 채널 라우팅
• 문제 해결
• 구성
• 슬래시 명령어