Slack

DM 및 채널에서 Slack 앱 통합을 통해 프로덕션 준비 상태로 사용할 수 있습니다. 기본 모드는 Socket Mode이며 HTTP Request URLs도 지원됩니다.

# Socket Mode 또는 HTTP Request URLs 선택

두 전송 방식 모두 프로덕션 준비 상태이며 메시징, 슬래시 명령, App Home, 상호작용 기능에서 기능 동등성을 갖습니다. 기능이 아니라 배포 형태에 따라 선택하세요.

# 빠른 설정

{
"display_information": {
"name": "OpenClaw",
"description": "Slack connector for OpenClaw"
},
"features": {
"bot_user": { "display_name": "OpenClaw", "always_online": true },
"app_home": {
"home_tab_enabled": true,
"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": [
"app_mentions:read",
"assistant:write",
"channels:history",
"channels:read",
"chat:write",
"commands",
"emoji:read",
"files:read",
"files:write",
"groups:history",
"groups:read",
"im:history",
"im:read",
"im:write",
"mpim:history",
"mpim:read",
"mpim:write",
"pins:read",
"pins:write",
"reactions:read",
"reactions:write",
"usergroups:read",
"users:read"
]
}
},
"settings": {
"socket_mode_enabled": true,
"event_subscriptions": {
"bot_events": [
"app_home_opened",
"app_mention",
"channel_rename",
"member_joined_channel",
"member_left_channel",
"message.channels",
"message.groups",
"message.im",
"message.mpim",
"pin_added",
"pin_removed",
"reaction_added",
"reaction_removed"
]
}
}
}

{
"display_information": {
"name": "OpenClaw",
"description": "Slack connector for OpenClaw"
},
"features": {
"bot_user": { "display_name": "OpenClaw", "always_online": true },
"app_home": {
"home_tab_enabled": true,
"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": [
"app_mentions:read",
"assistant:write",
"channels:history",
"channels:read",
"chat:write",
"commands",
"groups:history",
"groups:read",
"im:history",
"im:read",
"im:write",
"users:read"
]
}
},
"settings": {
"socket_mode_enabled": true,
"event_subscriptions": {
"bot_events": [
"app_home_opened",
"app_mention",
"message.channels",
"message.groups",
"message.im"
]
}
}
}

export SLACK_APP_TOKEN=xapp-...
export SLACK_BOT_TOKEN=xoxb-...
cat > slack.socket.patch.json5 <<'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" },
},
},
}
JSON5
openclaw config patch --file ./slack.socket.patch.json5 --dry-run
openclaw config patch --file ./slack.socket.patch.json5

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

openclaw gateway

{
"display_information": {
"name": "OpenClaw",
"description": "Slack connector for OpenClaw"
},
"features": {
"bot_user": { "display_name": "OpenClaw", "always_online": true },
"app_home": {
"home_tab_enabled": true,
"messages_tab_enabled": true,
"messages_tab_read_only_enabled": false
},
"slash_commands": [
{
"command": "/openclaw",
"description": "Send a message to OpenClaw",
"should_escape": false,
"url": "https://gateway-host.example.com/slack/events"
}
]
},
"oauth_config": {
"scopes": {
"bot": [
"app_mentions:read",
"assistant:write",
"channels:history",
"channels:read",
"chat:write",
"commands",
"emoji:read",
"files:read",
"files:write",
"groups:history",
"groups:read",
"im:history",
"im:read",
"im:write",
"mpim:history",
"mpim:read",
"mpim:write",
"pins:read",
"pins:write",
"reactions:read",
"reactions:write",
"usergroups:read",
"users:read"
]
}
},
"settings": {
"event_subscriptions": {
"request_url": "https://gateway-host.example.com/slack/events",
"bot_events": [
"app_home_opened",
"app_mention",
"channel_rename",
"member_joined_channel",
"member_left_channel",
"message.channels",
"message.groups",
"message.im",
"message.mpim",
"pin_added",
"pin_removed",
"reaction_added",
"reaction_removed"
]
},
"interactivity": {
"is_enabled": true,
"request_url": "https://gateway-host.example.com/slack/events",
"message_menu_options_url": "https://gateway-host.example.com/slack/events"
}
}
}

{
"display_information": {
"name": "OpenClaw",
"description": "Slack connector for OpenClaw"
},
"features": {
"bot_user": { "display_name": "OpenClaw", "always_online": true },
"app_home": {
"home_tab_enabled": true,
"messages_tab_enabled": true,
"messages_tab_read_only_enabled": false
},
"slash_commands": [
{
"command": "/openclaw",
"description": "Send a message to OpenClaw",
"should_escape": false,
"url": "https://gateway-host.example.com/slack/events"
}
]
},
"oauth_config": {
"scopes": {
"bot": [
"app_mentions:read",
"assistant:write",
"channels:history",
"channels:read",
"chat:write",
"commands",
"groups:history",
"groups:read",
"im:history",
"im:read",
"im:write",
"users:read"
]
}
},
"settings": {
"event_subscriptions": {
"request_url": "https://gateway-host.example.com/slack/events",
"bot_events": [
"app_home_opened",
"app_mention",
"message.channels",
"message.groups",
"message.im"
]
},
"interactivity": {
"is_enabled": true,
"request_url": "https://gateway-host.example.com/slack/events",
"message_menu_options_url": "https://gateway-host.example.com/slack/events"
}
}
}

export SLACK_BOT_TOKEN=xoxb-...
export SLACK_SIGNING_SECRET=...
cat > slack.http.patch.json5 <<'JSON5'
{
channels: {
slack: {
enabled: true,
mode: "http",
botToken: { source: "env", provider: "default", id: "SLACK_BOT_TOKEN" },
signingSecret: { source: "env", provider: "default", id: "SLACK_SIGNING_SECRET" },
webhookPath: "/slack/events",
},
},
}
JSON5
openclaw config patch --file ./slack.http.patch.json5 --dry-run
openclaw config patch --file ./slack.http.patch.json5

openclaw gateway

# Socket Mode 전송 튜닝

OpenClaw는 기본적으로 Socket Mode에서 Slack SDK 클라이언트 pong 제한 시간을 15초로 설정합니다. 워크스페이스 또는 호스트별 튜닝이 필요할 때만 전송 설정을 재정의하세요.

{
  channels: {
    slack: {
      mode: "socket",
      socketMode: {
        clientPingTimeout: 20000,
        serverPingTimeout: 30000,
        pingPongLoggingEnabled: false,
      },
    },
  },
}

Slack 웹소켓 pong/server-ping 제한 시간이 로그에 남거나 이벤트 루프 고갈이 알려진 호스트에서 실행되는 Socket Mode 워크스페이스에만 이것을 사용하세요. clientPingTimeout은 SDK가 클라이언트 ping을 보낸 뒤 pong을 기다리는 시간이고, serverPingTimeout은 Slack 서버 ping을 기다리는 시간입니다. 앱 메시지와 이벤트는 전송 생존 신호가 아니라 애플리케이션 상태로 유지됩니다.

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

기본 Slack 앱 매니페스트는 Socket Mode와 HTTP Request URLs에서 동일합니다. settings 블록(및 슬래시 명령 url)만 다릅니다.

기본 매니페스트(Socket Mode 기본값):

{
  "display_information": {
    "name": "OpenClaw",
    "description": "Slack connector for OpenClaw"
  },
  "features": {
    "bot_user": { "display_name": "OpenClaw", "always_online": true },
    "app_home": {
      "home_tab_enabled": true,
      "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": [
        "app_mentions:read",
        "assistant:write",
        "channels:history",
        "channels:read",
        "chat:write",
        "commands",
        "emoji:read",
        "files:read",
        "files:write",
        "groups:history",
        "groups:read",
        "im:history",
        "im:read",
        "im:write",
        "mpim:history",
        "mpim:read",
        "mpim:write",
        "pins:read",
        "pins:write",
        "reactions:read",
        "reactions:write",
        "usergroups:read",
        "users:read"
      ]
    }
  },
  "settings": {
    "socket_mode_enabled": true,
    "event_subscriptions": {
      "bot_events": [
        "app_home_opened",
        "app_mention",
        "channel_rename",
        "member_joined_channel",
        "member_left_channel",
        "message.channels",
        "message.groups",
        "message.im",
        "message.mpim",
        "pin_added",
        "pin_removed",
        "reaction_added",
        "reaction_removed"
      ]
    }
  }
}

HTTP Request URLs 모드에서는 settings를 HTTP 변형으로 바꾸고 각 슬래시 명령에 url을 추가합니다. 공개 URL이 필요합니다.

{
  "features": {
    "slash_commands": [
      {
        "command": "/openclaw",
        "description": "Send a message to OpenClaw",
        "should_escape": false,
        "url": "https://gateway-host.example.com/slack/events"
      }
    ]
  },
  "settings": {
    "event_subscriptions": {
      "request_url": "https://gateway-host.example.com/slack/events",
      "bot_events": [
        "app_home_opened",
        "app_mention",
        "channel_rename",
        "member_joined_channel",
        "member_left_channel",
        "message.channels",
        "message.groups",
        "message.im",
        "message.mpim",
        "pin_added",
        "pin_removed",
        "reaction_added",
        "reaction_removed"
      ]
    },
    "interactivity": {
      "is_enabled": true,
      "request_url": "https://gateway-host.example.com/slack/events",
      "message_menu_options_url": "https://gateway-host.example.com/slack/events"
    }
  }
}

# 추가 매니페스트 설정

위 기본값을 확장하는 다른 기능을 표시합니다.

기본 매니페스트는 Slack App Home Home 탭을 활성화하고 app_home_opened를 구독합니다. 워크스페이스 구성원이 Home 탭을 열면 OpenClaw는 views.publish로 안전한 기본 Home 보기를 게시합니다. 대화 페이로드나 비공개 구성은 포함되지 않습니다. Messages 탭은 Slack DM에 대해 계속 활성화됩니다.

{
"slash_commands": [
{
"command": "/new",
"description": "Start a new session",
"usage_hint": "[model]"
},
{
"command": "/reset",
"description": "Reset the current session"
},
{
"command": "/compact",
"description": "Compact the session context",
"usage_hint": "[instructions]"
},
{
"command": "/stop",
"description": "Stop the current run"
},
{
"command": "/session",
"description": "Manage thread-binding expiry",
"usage_hint": "idle <duration|off> or max-age <duration|off>"
},
{
"command": "/think",
"description": "Set the thinking level",
"usage_hint": "<level>"
},
{
"command": "/verbose",
"description": "Toggle verbose output",
"usage_hint": "on|off|full"
},
{
"command": "/fast",
"description": "Show or set fast mode",
"usage_hint": "[status|on|off]"
},
{
"command": "/reasoning",
"description": "Toggle reasoning visibility",
"usage_hint": "[on|off|stream]"
},
{
"command": "/elevated",
"description": "Toggle elevated mode",
"usage_hint": "[on|off|ask|full]"
},
{
"command": "/exec",
"description": "Show or set exec defaults",
"usage_hint": "host=<auto|sandbox|gateway|node> security=<deny|allowlist|full> ask=<off|on-miss|always> node=<id>"
},
{
"command": "/model",
"description": "Show or set the model",
"usage_hint": "[name|#|status]"
},
{
"command": "/models",
"description": "List providers/models",
"usage_hint": "[provider] [page] [limit=<n>|size=<n>|all]"
},
{
"command": "/help",
"description": "Show the short help summary"
},
{
"command": "/commands",
"description": "Show the generated command catalog"
},
{
"command": "/tools",
"description": "Show what the current agent can use right now",
"usage_hint": "[compact|verbose]"
},
{
"command": "/agentstatus",
"description": "Show runtime status, including provider usage/quota when available"
},
{
"command": "/tasks",
"description": "List active/recent background tasks for the current session"
},
{
"command": "/context",
"description": "Explain how context is assembled",
"usage_hint": "[list|detail|json]"
},
{
"command": "/whoami",
"description": "Show your sender identity"
},
{
"command": "/skill",
"description": "Run a skill by name",
"usage_hint": "<name> [input]"
},
{
"command": "/btw",
"description": "Ask a side question without changing session context",
"usage_hint": "<question>"
},
{
"command": "/side",
"description": "Ask a side question without changing session context",
"usage_hint": "<question>"
},
{
"command": "/usage",
"description": "Control the usage footer or show cost summary",
"usage_hint": "off|tokens|full|cost"
}
]
}

{
"slash_commands": [
{
"command": "/new",
"description": "Start a new session",
"usage_hint": "[model]",
"url": "https://gateway-host.example.com/slack/events"
},
{
"command": "/help",
"description": "Show the short help summary",
"url": "https://gateway-host.example.com/slack/events"
}
]
}

# 토큰 모델

• Socket Mode에는 botToken + appToken이 필요합니다.
• HTTP 모드에는 botToken + signingSecret이 필요합니다.
• botToken, appToken, signingSecret, userToken은 일반 텍스트 문자열 또는 SecretRef 객체를 허용합니다.
• 구성 토큰은 env 폴백을 재정의합니다.
• SLACK_BOT_TOKEN / SLACK_APP_TOKEN env 폴백은 기본 계정에만 적용됩니다.
• userToken(xoxp-...)은 구성 전용(env 폴백 없음)이며 기본값은 읽기 전용 동작(userTokenReadOnly: true)입니다.

상태 스냅샷 동작:

• Slack 계정 검사는 자격 증명별 *Source 및 *Status 필드(botToken, appToken, signingSecret, userToken)를 추적합니다.
• 상태는 available, configured_unavailable 또는 missing입니다.
• configured_unavailable은 계정이 SecretRef 또는 다른 비인라인 비밀 소스를 통해 구성되었지만 현재 명령/런타임 경로가 실제 값을 해석할 수 없었음을 의미합니다.
• HTTP 모드에서는 signingSecretStatus가 포함됩니다. Socket Mode에서는 필요한 쌍이 botTokenStatus + appTokenStatus입니다.

# 작업 및 게이트

Slack 작업은 channels.slack.actions.*로 제어됩니다.

현재 Slack 도구에서 사용할 수 있는 작업 그룹:

현재 Slack 메시지 작업에는 send, upload-file, download-file, read, edit, delete, pin, unpin, list-pins, member-info, emoji-list가 포함됩니다. download-file은 인바운드 파일 플레이스홀더에 표시된 Slack 파일 ID를 허용하며, 이미지의 경우 이미지 미리보기를, 다른 파일 유형의 경우 로컬 파일 메타데이터를 반환합니다.

# 액세스 제어 및 라우팅

# 스레딩, 세션 및 답장 태그

• DM은 direct로, 채널은 channel로, MPIM은 group으로 라우팅됩니다.
• Slack 라우트 바인딩은 원시 피어 ID와 channel:C12345678, user:U12345678, <@U12345678> 같은 Slack 대상 형식을 허용합니다.
• 기본 session.dmScope=main에서는 Slack DM이 에이전트 기본 세션으로 합쳐집니다.
• 채널 세션: agent:<agentId>:slack:channel:<channelId>.
• 스레드 답장은 적용 가능한 경우 스레드 세션 접미사(:thread:<threadTs>)를 만들 수 있습니다.
• channels.slack.thread.historyScope 기본값은 thread이고, thread.inheritParent 기본값은 false입니다.
• channels.slack.thread.initialHistoryLimit은 새 스레드 세션이 시작될 때 가져올 기존 스레드 메시지 수를 제어합니다(기본값 20; 비활성화하려면 0으로 설정).
• channels.slack.thread.requireExplicitMention(기본값 false): true이면 암시적 스레드 멘션을 억제하여, 봇이 이미 스레드에 참여했더라도 스레드 안의 명시적 @bot 멘션에만 응답합니다. 이 설정이 없으면 봇이 참여한 스레드의 답장은 requireMention 게이트를 우회합니다.

답장 스레딩 제어:

• channels.slack.replyToMode: off|first|all|batched(기본값 off)
• channels.slack.replyToModeByChatType: direct|group|channel별 설정
• 직접 채팅용 레거시 폴백: channels.slack.dm.replyToMode

수동 답장 태그가 지원됩니다.

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

# 확인 반응

ackReaction은 OpenClaw가 인바운드 메시지를 처리하는 동안 확인 이모지를 보냅니다.

해석 순서:

• channels.slack.accounts.<accountId>.ackReaction
• channels.slack.ackReaction
• messages.ackReaction
• 에이전트 ID 이모지 폴백(agents.list[].identity.emoji, 없으면 "👀")

참고:

• Slack은 쇼트코드(예: "eyes")를 요구합니다.
• Slack 계정 또는 전역에서 반응을 비활성화하려면 ""를 사용하세요.

# 텍스트 스트리밍

channels.slack.streaming은 실시간 미리보기 동작을 제어합니다.

• off: 실시간 미리보기 스트리밍을 비활성화합니다.
• partial(기본값): 미리보기 텍스트를 최신 부분 출력으로 바꿉니다.
• block: 청크 단위 미리보기 업데이트를 덧붙입니다.
• progress: 생성 중 진행 상태 텍스트를 표시한 다음 최종 텍스트를 보냅니다.
• streaming.preview.toolProgress: 초안 미리보기가 활성 상태일 때 도구/진행 업데이트를 같은 편집된 미리보기 메시지로 라우팅합니다(기본값: true). 별도의 도구/진행 메시지를 유지하려면 false로 설정하세요.
• streaming.preview.commandText / streaming.progress.commandText: 원시 명령/exec 텍스트를 숨기면서 간결한 도구 진행 줄은 유지하려면 status로 설정합니다(기본값: raw).

간결한 진행 줄은 유지하면서 원시 명령/exec 텍스트 숨기기:

{
  "channels": {
    "slack": {
      "streaming": {
        "mode": "progress",
        "progress": {
          "toolProgress": true,
          "commandText": "status"
        }
      }
    }
  }
}

channels.slack.streaming.nativeTransport는 channels.slack.streaming.mode가 partial일 때 Slack 네이티브 텍스트 스트리밍을 제어합니다(기본값: true).

• 네이티브 텍스트 스트리밍과 Slack 어시스턴트 스레드 상태가 표시되려면 답장 스레드가 있어야 합니다. 스레드 선택은 계속 replyToMode를 따릅니다.
• 채널, 그룹 채팅 및 최상위 DM 루트는 네이티브 스트리밍을 사용할 수 없거나 답장 스레드가 없을 때도 일반 초안 미리보기를 사용할 수 있습니다.
• 최상위 Slack DM은 기본적으로 스레드 밖에 유지되므로 Slack의 스레드 스타일 네이티브 스트림/상태 미리보기를 표시하지 않습니다. 대신 OpenClaw는 DM에 초안 미리보기를 게시하고 편집합니다.
• 미디어 및 텍스트가 아닌 페이로드는 일반 전달로 폴백합니다.
• 미디어/오류 최종 응답은 대기 중인 미리보기 편집을 취소합니다. 적격 텍스트/블록 최종 응답은 미리보기를 제자리에서 편집할 수 있을 때만 플러시됩니다.
• 스트리밍이 답장 중간에 실패하면 OpenClaw는 남은 페이로드를 일반 전달로 폴백합니다.

Slack 네이티브 텍스트 스트리밍 대신 초안 미리보기 사용:

{
  channels: {
    slack: {
      streaming: {
        mode: "partial",
        nativeTransport: false,
      },
    },
  },
}

레거시 키:

• channels.slack.streamMode(replace | status_final | append)는 channels.slack.streaming.mode의 레거시 런타임 별칭입니다.
• boolean channels.slack.streaming은 channels.slack.streaming.mode 및 channels.slack.streaming.nativeTransport의 레거시 런타임 별칭입니다.
• 레거시 channels.slack.nativeStreaming은 channels.slack.streaming.nativeTransport의 런타임 별칭입니다.
• 지속 저장된 Slack 스트리밍 구성을 표준 키로 다시 쓰려면 openclaw doctor --fix를 실행하세요.

# 입력 중 반응 대체 동작

typingReaction은 OpenClaw가 답장을 처리하는 동안 인바운드 Slack 메시지에 임시 반응을 추가한 뒤, 실행이 끝나면 제거합니다. 이는 기본 "입력 중..." 상태 표시기를 사용하는 스레드 답장 외부에서 가장 유용합니다.

해결 순서:

• channels.slack.accounts.<accountId>.typingReaction
• channels.slack.typingReaction

참고:

• Slack은 숏코드를 기대합니다(예: "hourglass_flowing_sand").
• 반응은 최선형 방식이며, 답장 또는 실패 경로가 완료된 뒤 정리가 자동으로 시도됩니다.

# 미디어, 청킹, 전달

# 명령과 슬래시 동작

슬래시 명령은 Slack에서 구성된 단일 명령 또는 여러 네이티브 명령으로 표시됩니다. 명령 기본값을 변경하려면 channels.slack.slashCommand를 구성하세요.

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

/openclaw /help

네이티브 명령은 Slack 앱에 추가 매니페스트 설정이 필요하며, 대신 전역 구성에서 channels.slack.commands.native: true 또는 commands.native: true로 활성화됩니다.

• Slack에서는 네이티브 명령 자동 모드가 꺼져 있으므로 commands.native: "auto"는 Slack 네이티브 명령을 활성화하지 않습니다.

/help

네이티브 인수 메뉴는 선택한 옵션 값을 디스패치하기 전에 확인 모달을 표시하는 적응형 렌더링 전략을 사용합니다.

• 옵션 최대 5개: 버튼 블록
• 옵션 6-100개: 정적 선택 메뉴
• 옵션 100개 초과: 상호작용 옵션 핸들러를 사용할 수 있을 때 비동기 옵션 필터링이 포함된 외부 선택
• Slack 제한 초과: 인코딩된 옵션 값은 버튼으로 대체됩니다

/think

슬래시 세션은 agent:<agentId>:slack:slash:<userId> 같은 격리된 키를 사용하며, 여전히 CommandTargetSessionKey를 사용해 명령 실행을 대상 대화 세션으로 라우팅합니다.

# 대화형 답장

Slack은 에이전트가 작성한 대화형 답장 컨트롤을 렌더링할 수 있지만, 이 기능은 기본적으로 비활성화되어 있습니다.

전역으로 활성화:

{
  channels: {
    slack: {
      capabilities: {
        interactiveReplies: true,
      },
    },
  },
}

또는 하나의 Slack 계정에만 활성화:

{
  channels: {
    slack: {
      accounts: {
        ops: {
          capabilities: {
            interactiveReplies: true,
          },
        },
      },
    },
  },
}

활성화되면 에이전트는 Slack 전용 답장 지시문을 내보낼 수 있습니다.

• [[slack_buttons: Approve:approve, Reject:reject]]
• [[slack_select: Choose a target | Canary:canary, Production:production]]

이 지시문은 Slack Block Kit으로 컴파일되고, 클릭 또는 선택을 기존 Slack 상호작용 이벤트 경로를 통해 다시 라우팅합니다.

참고:

• 이는 Slack 전용 UI입니다. 다른 채널은 Slack Block Kit 지시문을 자체 버튼 시스템으로 변환하지 않습니다.
• 대화형 콜백 값은 원시 에이전트 작성 값이 아니라 OpenClaw가 생성한 불투명 토큰입니다.
• 생성된 대화형 블록이 Slack Block Kit 제한을 초과할 경우 OpenClaw는 유효하지 않은 블록 페이로드를 보내는 대신 원본 텍스트 답장으로 대체합니다.

# Slack의 Exec 승인

Slack은 Web UI 또는 터미널로 대체하는 대신, 대화형 버튼과 상호작용을 갖춘 네이티브 승인 클라이언트로 동작할 수 있습니다.

• Exec 승인은 네이티브 DM/채널 라우팅에 channels.slack.execApprovals.*를 사용합니다.
• Plugin 승인은 요청이 이미 Slack에 도착했고 승인 id 종류가 plugin:인 경우 동일한 Slack 네이티브 버튼 화면을 통해 계속 해결될 수 있습니다.
• 승인자 권한 부여는 계속 적용됩니다. 승인자로 식별된 사용자만 Slack을 통해 요청을 승인하거나 거부할 수 있습니다.

이는 다른 채널과 동일한 공유 승인 버튼 화면을 사용합니다. Slack 앱 설정에서 interactivity가 활성화되면 승인 프롬프트가 대화 안에 직접 Block Kit 버튼으로 렌더링됩니다. 이 버튼이 있을 때는 기본 승인 UX입니다. OpenClaw는 도구 결과가 채팅 승인을 사용할 수 없다고 하거나 수동 승인이 유일한 경로라고 할 때만 수동 /approve 명령을 포함해야 합니다.

구성 경로:

• channels.slack.execApprovals.enabled
• channels.slack.execApprovals.approvers(선택 사항; 가능한 경우 commands.ownerAllowFrom으로 대체)
• channels.slack.execApprovals.target(dm | channel | both, 기본값: dm)
• agentFilter, sessionFilter

Slack은 enabled가 설정되지 않았거나 "auto"이고 최소 하나의 승인자가 확인되면 네이티브 exec 승인을 자동 활성화합니다. Slack을 네이티브 승인 클라이언트로 명시적으로 비활성화하려면 enabled: false를 설정하세요. 승인자가 확인될 때 네이티브 승인을 강제로 켜려면 enabled: true를 설정하세요.

명시적 Slack exec 승인 구성이 없을 때의 기본 동작:

{
  commands: {
    ownerAllowFrom: ["slack:U12345678"],
  },
}

명시적 Slack 네이티브 구성은 승인자를 재정의하거나, 필터를 추가하거나, 원본 채팅 전달을 사용하려는 경우에만 필요합니다.

{
  channels: {
    slack: {
      execApprovals: {
        enabled: true,
        approvers: ["U12345678"],
        target: "both",
      },
    },
  },
}

공유 approvals.exec 전달은 별도입니다. exec 승인 프롬프트를 다른 채팅 또는 명시적인 대역 외 대상으로도 라우팅해야 할 때만 사용하세요. 공유 approvals.plugin 전달도 별도입니다. 해당 요청이 이미 Slack에 도착한 경우 Slack 네이티브 버튼은 여전히 plugin 승인을 해결할 수 있습니다.

동일 채팅 /approve도 이미 명령을 지원하는 Slack 채널과 DM에서 작동합니다. 전체 승인 전달 모델은 Exec 승인을 참고하세요.

# 이벤트와 운영 동작

• 메시지 편집/삭제는 시스템 이벤트로 매핑됩니다.
• 스레드 브로드캐스트("채널에도 보내기" 스레드 답장)는 일반 사용자 메시지로 처리됩니다.
• 반응 추가/제거 이벤트는 시스템 이벤트로 매핑됩니다.
• 멤버 참여/나가기, 채널 생성/이름 변경, 핀 추가/제거 이벤트는 시스템 이벤트로 매핑됩니다.
• configWrites가 활성화된 경우 channel_id_changed는 채널 구성 키를 마이그레이션할 수 있습니다.
• 채널 주제/목적 메타데이터는 신뢰할 수 없는 컨텍스트로 처리되며 라우팅 컨텍스트에 주입될 수 있습니다.
• 스레드 시작자와 초기 스레드 기록 컨텍스트 시딩은 적용 가능한 경우 구성된 발신자 허용 목록으로 필터링됩니다.
• 블록 작업과 모달 상호작용은 풍부한 페이로드 필드가 포함된 구조화된 Slack interaction: ... 시스템 이벤트를 내보냅니다.
  • 블록 작업: 선택된 값, 레이블, 선택기 값, workflow_* 메타데이터
  • 라우팅된 채널 메타데이터와 양식 입력이 포함된 모달 view_submission 및 view_closed 이벤트

# 구성 참조

기본 참조: 구성 참조 - Slack.

# 문제 해결

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

openclaw pairing list slack

# 첨부 비전 참조

Slack은 Slack 파일 다운로드가 성공하고 크기 제한이 허용하는 경우 다운로드된 미디어를 에이전트 턴에 첨부할 수 있습니다. 이미지 파일은 미디어 이해 경로를 통해 전달되거나 비전 지원 응답 모델에 직접 전달될 수 있습니다. 다른 파일은 이미지 입력으로 처리되지 않고 다운로드 가능한 파일 컨텍스트로 유지됩니다.

# 지원되는 미디어 유형

# 인바운드 파이프라인

파일 첨부가 있는 Slack 메시지가 도착하면:

1. OpenClaw는 봇 토큰(xoxb-...)을 사용해 Slack의 비공개 URL에서 파일을 다운로드합니다.
2. 성공하면 파일이 미디어 저장소에 기록됩니다.
3. 다운로드된 미디어 경로와 콘텐츠 유형이 인바운드 컨텍스트에 추가됩니다.
4. 이미지 지원 모델/도구 경로는 해당 컨텍스트의 이미지 첨부 파일을 사용할 수 있습니다.
5. 이미지가 아닌 파일은 이를 처리할 수 있는 도구를 위해 파일 메타데이터 또는 미디어 참조로 계속 사용할 수 있습니다.

# 스레드 루트 첨부 파일 상속

메시지가 스레드에 도착하는 경우(thread_ts 부모가 있음):

• 답글 자체에 직접 미디어가 없고 포함된 루트 메시지에 파일이 있으면, Slack은 루트 파일을 스레드 시작 컨텍스트로 채울 수 있습니다.
• 직접 답글 첨부 파일은 루트 메시지 첨부 파일보다 우선합니다.
• 파일만 있고 텍스트가 없는 루트 메시지는 첨부 파일 플레이스홀더로 표현되어 폴백이 여전히 해당 파일을 포함할 수 있습니다.

# 다중 첨부 파일 처리

단일 Slack 메시지에 여러 파일 첨부가 포함된 경우:

• 각 첨부 파일은 미디어 파이프라인을 통해 독립적으로 처리됩니다.
• 다운로드된 미디어 참조는 메시지 컨텍스트에 집계됩니다.
• 처리 순서는 이벤트 페이로드의 Slack 파일 순서를 따릅니다.
• 한 첨부 파일 다운로드 실패는 다른 첨부 파일을 차단하지 않습니다.

# 크기, 다운로드 및 모델 제한

• 크기 한도: 기본값은 파일당 20 MB입니다. channels.slack.mediaMaxMb로 구성할 수 있습니다.
• 다운로드 실패: Slack이 제공할 수 없는 파일, 만료된 URL, 접근할 수 없는 파일, 크기 초과 파일, Slack 인증/로그인 HTML 응답은 지원되지 않는 형식으로 보고되지 않고 건너뜁니다.
• 비전 모델: 이미지 분석은 비전을 지원하는 경우 활성 응답 모델을 사용하거나 agents.defaults.imageModel에 구성된 이미지 모델을 사용합니다.

# 알려진 제한 사항

# 관련 문서

• 미디어 이해 파이프라인
• PDF 도구
• Epic: #51349 — Slack 첨부 파일 비전 활성화
• 회귀 테스트: #51353
• 라이브 검증: #51354

# 관련 항목