Slack

​

Socket Mode 또는 HTTP Request URLs 선택

​

릴레이 모드

{
  channels: {
    slack: {
      mode: "relay",
      botToken: { source: "env", provider: "default", id: "SLACK_BOT_TOKEN" },
      relay: {
        url: "wss://router.example.com/gateway/ws",
        authToken: { source: "env", provider: "default", id: "SLACK_RELAY_AUTH_TOKEN" },
        gatewayId: "team-gateway",
      },
    },
  },
}

​

설치

openclaw plugins install @openclaw/slack

​

빠른 설정

{
  "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
    },
    "assistant_view": {
      "assistant_description": "OpenClaw connects Slack assistant threads to OpenClaw agents.",
      "suggested_prompts": [
        { "title": "What can you do?", "message": "What can you help me with?" },
        {
          "title": "Summarize this channel",
          "message": "Summarize the recent activity in this channel."
        },
        { "title": "Draft a reply", "message": "Help me draft a reply." }
      ]
    },
    "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",
        "assistant_thread_context_changed",
        "assistant_thread_started",
        "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
    },
    "assistant_view": {
      "assistant_description": "OpenClaw connects Slack assistant threads to OpenClaw agents.",
      "suggested_prompts": [
        { "title": "What can you do?", "message": "What can you help me with?" },
        {
          "title": "Summarize this channel",
          "message": "Summarize the recent activity in this channel."
        },
        { "title": "Draft a reply", "message": "Help me draft a reply." }
      ]
    },
    "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",
        "assistant_thread_context_changed",
        "assistant_thread_started",
        "message.channels",
        "message.groups",
        "message.im"
      ]
    }
  }
}

export SLACK_APP_TOKEN=slack-app-token-example
export SLACK_BOT_TOKEN=slack-bot-token-example
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=slack-app-token-example
SLACK_BOT_TOKEN=slack-bot-token-example

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
    },
    "assistant_view": {
      "assistant_description": "OpenClaw connects Slack assistant threads to OpenClaw agents.",
      "suggested_prompts": [
        { "title": "What can you do?", "message": "What can you help me with?" },
        {
          "title": "Summarize this channel",
          "message": "Summarize the recent activity in this channel."
        },
        { "title": "Draft a reply", "message": "Help me draft a reply." }
      ]
    },
    "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",
        "assistant_thread_context_changed",
        "assistant_thread_started",
        "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
    },
    "assistant_view": {
      "assistant_description": "OpenClaw connects Slack assistant threads to OpenClaw agents.",
      "suggested_prompts": [
        { "title": "What can you do?", "message": "What can you help me with?" },
        {
          "title": "Summarize this channel",
          "message": "Summarize the recent activity in this channel."
        },
        { "title": "Draft a reply", "message": "Help me draft a reply." }
      ]
    },
    "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",
        "assistant_thread_context_changed",
        "assistant_thread_started",
        "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=slack-bot-token-example
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 전송 튜닝

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

• socketMode는 HTTP Request URL 모드에서 무시됩니다.
• 기본 channels.slack.socketMode 설정은 재정의하지 않는 한 모든 Slack 계정에 적용됩니다. 계정별 재정의는 channels.slack.accounts.<accountId>.socketMode를 사용합니다. 이것은 객체 재정의이므로 해당 계정에 원하는 모든 소켓 튜닝 필드를 포함하세요.
• OpenClaw 기본값이 있는 것은 clientPingTimeout(15000)뿐입니다. serverPingTimeout과 pingPongLoggingEnabled는 구성된 경우에만 Slack SDK로 전달됩니다.
• Socket Mode 재시작 백오프는 약 2초에서 시작해 약 30초에서 상한에 도달합니다. 복구 가능한 시작, 시작 대기, 연결 해제 실패는 채널이 중지될 때까지 재시도합니다. 잘못된 인증, 폐기된 토큰, 누락된 범위 같은 영구 계정 및 자격 증명 오류는 영원히 재시도하지 않고 빠르게 실패합니다.

​

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

{
  "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
    },
    "assistant_view": {
      "assistant_description": "OpenClaw connects Slack assistant threads to OpenClaw agents.",
      "suggested_prompts": [
        { "title": "What can you do?", "message": "What can you help me with?" },
        {
          "title": "Summarize this channel",
          "message": "Summarize the recent activity in this channel."
        },
        { "title": "Draft a reply", "message": "Help me draft a reply." }
      ]
    },
    "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",
        "assistant_thread_context_changed",
        "assistant_thread_started",
        "channel_rename",
        "member_joined_channel",
        "member_left_channel",
        "message.channels",
        "message.groups",
        "message.im",
        "message.mpim",
        "pin_added",
        "pin_removed",
        "reaction_added",
        "reaction_removed"
      ]
    }
  }
}

{
  "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",
        "assistant_thread_context_changed",
        "assistant_thread_started",
        "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"
    }
  }
}

​

추가 매니페스트 설정

{
  "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": "/approve",
      "description": "Approve or deny pending approval requests",
      "usage_hint": "<id> <decision>"
    },
    {
      "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과 relay.url, relay.authToken, relay.gatewayId가 필요합니다. 앱 토큰이나 서명 시크릿은 사용하지 않습니다.
• botToken, appToken, signingSecret, relay.authToken, userToken은 일반 텍스트 문자열 또는 SecretRef 객체를 허용합니다.
• 구성 토큰은 env fallback보다 우선합니다.
• SLACK_BOT_TOKEN / SLACK_APP_TOKEN env fallback은 기본 계정에만 적용됩니다.
• userToken은 구성 전용(env fallback 없음)이며 기본값은 읽기 전용 동작(userTokenReadOnly: true)입니다.

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

​

작업 및 게이트

​

액세스 제어 및 라우팅

{
  channels: {
    slack: {
      groupPolicy: "allowlist",
      channels: {
        C12345678: { allow: true, requireMention: true },
      },
    },
  },
}

{
  channels: {
    slack: {
      groupPolicy: "allowlist",
      channels: {
        "#eng-my-channel": { allow: true, requireMention: true },
      },
    },
  },
}

​

스레드, 세션 및 답장 태그

• DM은 direct로, 채널은 channel로, MPIM은 group으로 라우팅됩니다.
• Slack 라우트 바인딩은 원시 피어 ID와 channel:C12345678, user:U12345678, <@U12345678> 같은 Slack 대상 형식을 허용합니다.
• 기본 session.dmScope=main에서는 Slack DM이 에이전트 메인 세션으로 합쳐집니다.
• 채널 세션: agent:<agentId>:slack:channel:<channelId>.
• 일반 최상위 채널 메시지는 replyToMode가 off가 아니어도 채널별 세션에 유지됩니다.
• Slack 스레드 답장은 아웃바운드 답장 스레딩이 replyToMode="off"로 비활성화되어 있어도 부모 Slack thread_ts를 세션 접미사(:thread:<threadTs>)로 사용합니다.
• OpenClaw는 보이는 Slack 스레드를 시작할 것으로 예상되는 적격 최상위 채널 루트를 agent:<agentId>:slack:channel:<channelId>:thread:<rootTs>에 시드하여, 루트와 이후 스레드 답장이 하나의 OpenClaw 세션을 공유하게 합니다. 이는 app_mention 이벤트, 명시적인 봇 또는 구성된 멘션 패턴 일치, 그리고 replyToMode가 off가 아닌 requireMention: false 채널에 적용됩니다.
• 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)

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

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

​

범위(messages.ackReactionScope)

• "all": DM과 그룹에서 반응합니다.
• "direct": DM에서만 반응합니다.
• "group-all": 모든 그룹 메시지에 반응합니다(DM 제외).
• "group-mentions"(기본값): 그룹에서 반응하지만, 봇이 멘션된 경우(또는 옵트인한 그룹 멘션 가능 대상)에만 반응합니다. DM은 제외됩니다.
• "off" / "none": 절대 반응하지 않습니다.

{
  messages: {
    ackReaction: "eyes",
    ackReactionScope: "all", // DM과 그룹에서 반응
  },
}

​

텍스트 스트리밍

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

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

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

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

{
  channels: {
    slack: {
      streaming: {
        mode: "progress",
        progress: {
          nativeTaskCards: true,
          render: "rich",
        },
      },
    },
  },
}

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

​

입력 중 반응 폴백

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

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

​

미디어, 청크 처리 및 전달

​

명령 및 슬래시 동작

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

/openclaw /help

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

/help

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

/think

​

대화형 답글

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

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

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

• compileSlackInteractiveReplies(...)
• parseSlackOptionsLine(...)
• isSlackInteractiveRepliesEnabled(...)
• buildSlackInteractiveBlocks(...)

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

​

Plugin 소유 모달 제출

• callback_id를 openclaw:<namespace>:<payload>로 설정합니다.
• 또는 기존 callback_id를 유지하고 모달 private_metadata에 pluginInteractiveData: "<namespace>:<payload>"를 넣습니다.

​

Slack의 네이티브 승인

• 실행 및 Plugin 승인은 Slack 네이티브 Block Kit 프롬프트로 렌더링될 수 있습니다.
• channels.slack.execApprovals.*는 네이티브 실행 승인 클라이언트 활성화와 DM/채널 라우팅 구성으로 유지됩니다.
• 실행 승인 DM은 channels.slack.execApprovals.approvers 또는 commands.ownerAllowFrom을 사용합니다.
• Plugin 승인은 시작 세션에 대해 Slack이 네이티브 승인 클라이언트로 활성화된 경우, 또는 approvals.plugin이 시작 Slack 세션이나 Slack 대상으로 라우팅되는 경우 Slack 네이티브 버튼을 사용합니다.
• Plugin 승인 DM은 channels.slack.allowFrom, 이름 있는 계정의 allowFrom, 또는 계정 기본 라우트의 Slack Plugin 승인자를 사용합니다.
• 승인자 권한 부여는 계속 적용됩니다. 실행 전용 승인자는 Plugin 승인자이기도 하지 않는 한 Plugin 요청을 승인할 수 없습니다.

• channels.slack.execApprovals.enabled
• channels.slack.execApprovals.approvers (선택 사항, 가능하면 commands.ownerAllowFrom으로 폴백)
• channels.slack.execApprovals.target (dm | channel | both, 기본값: dm)
• agentFilter, sessionFilter

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

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

​

이벤트 및 운영 동작

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

​

구성 참조

​

문제 해결

{
  messages: {
    groupChat: {
      visibleReplies: "automatic",
    },
  },
}

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

openclaw pairing list slack

​

첨부 파일 비전 참조

​

지원되는 미디어 유형

​

인바운드 파이프라인

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

​

스레드 루트 첨부 파일 상속

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

​

다중 첨부 파일 처리

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

​

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

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

​

알려진 제한

​

관련 문서

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

​

관련 항목