​

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",
    },
  },
}

openclaw gateway

​

매니페스트 및 scope 체크리스트

{
  "display_information": {
    "name": "OpenClaw",
    "description": "OpenClaw용 Slack 커넥터"
  },
  "features": {
    "bot_user": {
      "display_name": "OpenClaw",
      "always_online": true
    },
    "app_home": {
      "messages_tab_enabled": true,
      "messages_tab_read_only_enabled": false
    },
    "slash_commands": [
      {
        "command": "/openclaw",
        "description": "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",
        "users:read"
      ]
    }
  },
  "settings": {
    "socket_mode_enabled": true,
    "event_subscriptions": {
      "bot_events": [
        "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": "OpenClaw용 Slack 커넥터"
  },
  "features": {
    "bot_user": {
      "display_name": "OpenClaw",
      "always_online": true
    },
    "app_home": {
      "messages_tab_enabled": true,
      "messages_tab_read_only_enabled": false
    },
    "slash_commands": [
      {
        "command": "/openclaw",
        "description": "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",
        "users:read"
      ]
    }
  },
  "settings": {
    "event_subscriptions": {
      "request_url": "https://gateway-host.example.com/slack/events",
      "bot_events": [
        "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"
    }
  }
}

​

추가 매니페스트 설정

    "slash_commands": [
      {
        "command": "/new",
        "description": "새 세션 시작",
        "usage_hint": "[model]"
      },
      {
        "command": "/reset",
        "description": "현재 세션 재설정"
      },
      {
        "command": "/compact",
        "description": "세션 컨텍스트 Compact",
        "usage_hint": "[instructions]"
      },
      {
        "command": "/stop",
        "description": "현재 실행 중지"
      },
      {
        "command": "/session",
        "description": "스레드 바인딩 만료 관리",
        "usage_hint": "idle <duration|off> 또는 max-age <duration|off>"
      },
      {
        "command": "/think",
        "description": "사고 수준 설정",
        "usage_hint": "<level>"
      },
      {
        "command": "/verbose",
        "description": "상세 출력 전환",
        "usage_hint": "on|off|full"
      },
      {
        "command": "/fast",
        "description": "빠른 모드 표시 또는 설정",
        "usage_hint": "[status|on|off]"
      },
      {
        "command": "/reasoning",
        "description": "reasoning 표시 여부 전환",
        "usage_hint": "[on|off|stream]"
      },
      {
        "command": "/elevated",
        "description": "elevated 모드 전환",
        "usage_hint": "[on|off|ask|full]"
      },
      {
        "command": "/exec",
        "description": "exec 기본값 표시 또는 설정",
        "usage_hint": "host=<auto|sandbox|gateway|node> security=<deny|allowlist|full> ask=<off|on-miss|always> node=<id>"
      },
      {
        "command": "/model",
        "description": "모델 표시 또는 설정",
        "usage_hint": "[name|#|status]"
      },
      {
        "command": "/models",
        "description": "provider 또는 provider의 모델 목록 표시",
        "usage_hint": "[provider] [page] [limit=<n>|size=<n>|all]"
      },
      {
        "command": "/help",
        "description": "짧은 도움말 요약 표시"
      },
      {
        "command": "/commands",
        "description": "생성된 명령 카탈로그 표시"
      },
      {
        "command": "/tools",
        "description": "현재 에이전트가 지금 사용할 수 있는 항목 표시",
        "usage_hint": "[compact|verbose]"
      },
      {
        "command": "/agentstatus",
        "description": "가능한 경우 provider 사용량/할당량을 포함한 런타임 상태 표시"
      },
      {
        "command": "/tasks",
        "description": "현재 세션의 활성/최근 백그라운드 작업 목록 표시"
      },
      {
        "command": "/context",
        "description": "컨텍스트가 어떻게 구성되는지 설명",
        "usage_hint": "[list|detail|json]"
      },
      {
        "command": "/whoami",
        "description": "내 발신자 ID 표시"
      },
      {
        "command": "/skill",
        "description": "이름으로 skill 실행",
        "usage_hint": "<name> [input]"
      },
      {
        "command": "/btw",
        "description": "세션 컨텍스트를 변경하지 않고 부가 질문하기",
        "usage_hint": "<question>"
      },
      {
        "command": "/usage",
        "description": "사용량 푸터 제어 또는 비용 요약 표시",
        "usage_hint": "off|tokens|full|cost"
      }
    ]

    "slash_commands": [
      {
        "command": "/new",
        "description": "새 세션 시작",
        "usage_hint": "[model]",
        "url": "https://gateway-host.example.com/slack/events"
      },
      {
        "command": "/reset",
        "description": "현재 세션 재설정",
        "url": "https://gateway-host.example.com/slack/events"
      },
      {
        "command": "/compact",
        "description": "세션 컨텍스트 Compact",
        "usage_hint": "[instructions]",
        "url": "https://gateway-host.example.com/slack/events"
      },
      {
        "command": "/stop",
        "description": "현재 실행 중지",
        "url": "https://gateway-host.example.com/slack/events"
      },
      {
        "command": "/session",
        "description": "스레드 바인딩 만료 관리",
        "usage_hint": "idle <duration|off> 또는 max-age <duration|off>",
        "url": "https://gateway-host.example.com/slack/events"
      },
      {
        "command": "/think",
        "description": "사고 수준 설정",
        "usage_hint": "<level>",
        "url": "https://gateway-host.example.com/slack/events"
      },
      {
        "command": "/verbose",
        "description": "상세 출력 전환",
        "usage_hint": "on|off|full",
        "url": "https://gateway-host.example.com/slack/events"
      },
      {
        "command": "/fast",
        "description": "빠른 모드 표시 또는 설정",
        "usage_hint": "[status|on|off]",
        "url": "https://gateway-host.example.com/slack/events"
      },
      {
        "command": "/reasoning",
        "description": "reasoning 표시 여부 전환",
        "usage_hint": "[on|off|stream]",
        "url": "https://gateway-host.example.com/slack/events"
      },
      {
        "command": "/elevated",
        "description": "elevated 모드 전환",
        "usage_hint": "[on|off|ask|full]",
        "url": "https://gateway-host.example.com/slack/events"
      },
      {
        "command": "/exec",
        "description": "exec 기본값 표시 또는 설정",
        "usage_hint": "host=<auto|sandbox|gateway|node> security=<deny|allowlist|full> ask=<off|on-miss|always> node=<id>",
        "url": "https://gateway-host.example.com/slack/events"
      },
      {
        "command": "/model",
        "description": "모델 표시 또는 설정",
        "usage_hint": "[name|#|status]",
        "url": "https://gateway-host.example.com/slack/events"
      },
      {
        "command": "/models",
        "description": "provider 또는 provider의 모델 목록 표시",
        "usage_hint": "[provider] [page] [limit=<n>|size=<n>|all]",
        "url": "https://gateway-host.example.com/slack/events"
      },
      {
        "command": "/help",
        "description": "짧은 도움말 요약 표시",
        "url": "https://gateway-host.example.com/slack/events"
      },
      {
        "command": "/commands",
        "description": "생성된 명령 카탈로그 표시",
        "url": "https://gateway-host.example.com/slack/events"
      },
      {
        "command": "/tools",
        "description": "현재 에이전트가 지금 사용할 수 있는 항목 표시",
        "usage_hint": "[compact|verbose]",
        "url": "https://gateway-host.example.com/slack/events"
      },
      {
        "command": "/agentstatus",
        "description": "가능한 경우 provider 사용량/할당량을 포함한 런타임 상태 표시",
        "url": "https://gateway-host.example.com/slack/events"
      },
      {
        "command": "/tasks",
        "description": "현재 세션의 활성/최근 백그라운드 작업 목록 표시",
        "url": "https://gateway-host.example.com/slack/events"
      },
      {
        "command": "/context",
        "description": "컨텍스트가 어떻게 구성되는지 설명",
        "usage_hint": "[list|detail|json]",
        "url": "https://gateway-host.example.com/slack/events"
      },
      {
        "command": "/whoami",
        "description": "내 발신자 ID 표시",
        "url": "https://gateway-host.example.com/slack/events"
      },
      {
        "command": "/skill",
        "description": "이름으로 skill 실행",
        "usage_hint": "<name> [input]",
        "url": "https://gateway-host.example.com/slack/events"
      },
      {
        "command": "/btw",
        "description": "세션 컨텍스트를 변경하지 않고 부가 질문하기",
        "usage_hint": "<question>",
        "url": "https://gateway-host.example.com/slack/events"
      },
      {
        "command": "/usage",
        "description": "사용량 푸터 제어 또는 비용 요약 표시",
        "usage_hint": "off|tokens|full|cost",
        "url": "https://gateway-host.example.com/slack/events"
      }
    ]

​

토큰 모델

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

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

​

작업 및 게이트

​

접근 제어 및 라우팅

​

스레딩, 세션 및 답장 태그

• DM은 direct, 채널은 channel, MPIM은 group으로 라우팅됩니다.
• 기본 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별 설정
• direct 채팅용 레거시 폴백: channels.slack.dm.replyToMode

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

​

Ack 반응

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

• Slack은 shortcode를 기대합니다(예: "eyes").
• Slack 계정별 또는 전역적으로 반응을 비활성화하려면 ""를 사용하세요.

​

텍스트 스트리밍

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

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

{
  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로 자동 마이그레이션됩니다.

​

Typing 반응 폴백

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

• Slack은 shortcode를 기대합니다(예: "hourglass_flowing_sand").
• 이 반응은 best-effort 방식이며, 답장 또는 실패 경로가 완료된 후 자동으로 정리를 시도합니다.

​

미디어, 청킹 및 전달

​

명령 및 슬래시 동작

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

/openclaw /help

• Slack의 기본 명령 자동 모드는 off이므로 commands.native: "auto"는 Slack 기본 명령을 활성화하지 않습니다.

/help

• 최대 5개 옵션: 버튼 블록
• 6-100개 옵션: 정적 선택 메뉴
• 100개 초과 옵션: interactivity 옵션 핸들러를 사용할 수 있을 때 비동기 옵션 필터링을 사용하는 외부 선택
• 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]]

• 이는 Slack 전용 UI입니다. 다른 채널은 Slack Block Kit 지시문을 자체 버튼 시스템으로 변환하지 않습니다.
• 인터랙티브 콜백 값은 원시 에이전트 작성 값이 아니라 OpenClaw가 생성한 불투명 토큰입니다.
• 생성된 인터랙티브 블록이 Slack Block Kit 제한을 초과하면 OpenClaw는 잘못된 블록 페이로드를 보내는 대신 원래 텍스트 답장으로 폴백합니다.

​

Slack의 Exec 승인

• Exec 승인은 기본 DM/채널 라우팅에 channels.slack.execApprovals.*를 사용합니다.
• Plugin 승인은 요청이 이미 Slack에 도착했고 승인 ID 종류가 plugin:일 때 동일한 Slack 기본 버튼 표면을 통해 계속 확인될 수 있습니다.
• 승인자 권한 부여는 여전히 강제됩니다. 승인자로 식별된 사용자만 Slack을 통해 요청을 승인하거나 거부할 수 있습니다.

• 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",
      },
    },
  },
}

​

이벤트 및 운영 동작

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

​

구성 참조 포인터

• 구성 참조 - Slack 주요 Slack 필드:
  • 모드/인증: mode, botToken, appToken, signingSecret, webhookPath, accounts.*
  • DM 접근: dm.enabled, dmPolicy, allowFrom (레거시: dm.policy, dm.allowFrom), dm.groupEnabled, dm.groupChannels
  • 호환성 토글: dangerouslyAllowNameMatching (최후 수단, 필요하지 않으면 끄기)
  • 채널 접근: groupPolicy, channels.*, channels.*.users, channels.*.requireMention
  • 스레딩/히스토리: replyToMode, replyToModeByChatType, thread.*, historyLimit, dmHistoryLimit, dms.*.historyLimit
  • 전달: textChunkLimit, chunkMode, mediaMaxMb, streaming, streaming.nativeTransport, streaming.preview.toolProgress
  • 운영/기능: configWrites, commands.native, slashCommand.*, actions.*, userToken, userTokenReadOnly

​

문제 해결

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

openclaw pairing list slack

​

관련 항목

• 페어링
• 그룹
• 보안
• 채널 라우팅
• 문제 해결
• 구성
• 슬래시 명령