Slack

Status: produktionsklar för DM + kanaler via Slack-appintegrationer. Standardläget är Socket Mode; HTTP Events API-läge stöds också.

Pairing

Slack-DM använder parkopplingsläge som standard.

Slash commands

Inbyggt kommandobeteende och kommandokatalog.

Channel troubleshooting

Diagnostik över flera kanaler och reparationsguider.

Snabbstart

Socket Mode (default)
HTTP Events API mode

Create Slack app and tokens

I Slack-appens inställningar:

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

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

    Miljövariabel som reserv (endast standardkonto):

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

Prenumerera på apphändelser

Prenumerera på bothändelser för:

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

Aktivera även App Home Messages Tab för DM.

Starta gateway

openclaw gateway

Configure Slack app for HTTP

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

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

Använd unika webhook-sökvägar för multi-account HTTP

HTTP-läge per konto stöds.Ge varje konto en unik webhookPath så att registreringar inte kolliderar.

Tokenmodell

botToken + appToken krävs för Socket Mode.
HTTP-läge kräver botToken + signingSecret.
Konfigurationstokens åsidosätter miljövariabler som reserv.
Miljövariablerna SLACK_BOT_TOKEN / SLACK_APP_TOKEN gäller endast för standardkontot.
userToken (xoxp-...) är endast konfigurationsbaserad (ingen reserv via miljövariabel) och använder som standard skrivskyddat läge (userTokenReadOnly: true).
Valfritt: lägg till chat:write.customize om du vill att utgående meddelanden ska använda den aktiva agentidentiteten (anpassat username och ikon). icon_emoji använder syntaxen :emoji_name:.

För åtgärder/katalogläsningar kan user-token prioriteras när den är konfigurerad. För skrivningar är bot-token fortsatt prioriterad; skrivningar med user-token tillåts endast när userTokenReadOnly: false och bot-token saknas.

Åtkomstkontroll och routing

DM policy
Channel policy
Mentions and channel users

channels.slack.dmPolicy styr DM-åtkomst (äldre: channels.slack.dm.policy):

- `pairing` (standard)
- `allowlist`
- `open` (kräver att `channels.slack.allowFrom` innehåller `"*"`; äldre: `channels.slack.dm.allowFrom`)
- `disabled`

DM-flaggor:

- `dm.enabled` (standard true)
- `channels.slack.allowFrom` (rekommenderas)
- `dm.allowFrom` (äldre)
- `dm.groupEnabled` (grupp-DM är som standard false)
- `dm.groupChannels` (valfri MPIM-tillåtslista)

Parkoppling i DM använder `openclaw pairing approve slack <code>`.

channels.slack.groupPolicy styr kanalhantering:

- `open`
- `allowlist`
- `disabled`

Kanalens tillåtslista finns under `channels.slack.channels`.

Körningsanteckning: om `channels.slack` helt saknas (endast miljövariabler) och `channels.defaults.groupPolicy` inte är satt, faller körningen tillbaka till `groupPolicy="open"` och loggar en varning.

Namn-/ID-upplösning:

- poster i kanalens och DM:ens tillåtslistor löses vid uppstart när token-åtkomst tillåter
- olösta poster behålls som konfigurerade

Kanalmeddelanden kräver omnämnande som standard.

Källor för omnämnande:

- explicit app-omnämnande (`<@botId>`)
- regex-mönster för omnämnande (`agents.list[].groupChat.mentionPatterns`, reserv `messages.groupChat.mentionPatterns`)
- implicit svar-i-tråd-beteende till bot

Kontroller per kanal (`channels.slack.channels.<id|name>`):

- `requireMention`
- `users` (tillåtslista)
- `allowBots`
- `skills`
- `systemPrompt`
- `tools`, `toolsBySender`

OpenClaw-konfig (minimal)

Inbyggt kommando auto-läge är av för Slack (commands.native: "auto" aktiverar inte Slack-inbyggda kommandon).
Aktivera inbyggda Slack-kommandohanterare med channels.slack.commands.native: true (eller globalt commands.native: true).
När inbyggda kommandon är aktiverade, registrera motsvarande slash-kommandon i Slack (/<command>-namn).
Om inbyggda kommandon inte är aktiverade kan du köra ett enskilt konfigurerat slash-kommando via channels.slack.slashCommand.

Standardinställningar för slash-kommando:

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

Snedstreckssessioner använder isolerade nycklar:

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

och dirigerar fortfarande kommandokörning mot målkonversationssessionen (CommandTargetSessionKey).

Scopes (aktuella vs valfria)

DMs dirigeras som direct; kanaler som channel; MPIMs som group.
Med standardinställningen session.dmScope=main slås Slack-DMs ihop till agentens huvudsession.
Kanalsessioner: agent:<agentId>:slack:channel:<channelId>.
Trådsvar kan skapa trådsessionssuffix (:thread:<threadTs>) när det är tillämpligt.
channels.slack.thread.historyScope är som standard thread; thread.inheritParent är som standard false.
channels.slack.thread.initialHistoryLimit styr hur många befintliga trådmeddelanden som hämtas när en ny trådsession startar (standard 20; sätt 0 för att inaktivera).

Inställningar för svarstrådning:

chat:write (skicka/uppdatera/ta bort meddelanden via chat.postMessage) https://docs.slack.dev/reference/methods/chat.postMessage
im:write (öppna DM via conversations.open för användar-DM) https://docs.slack.dev/reference/methods/conversations.open
channels:history, groups:history, im:history, mpim:history https://docs.slack.dev/reference/methods/conversations.history

Manuella svarstaggar stöds:

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

Obs: replyToMode="off" inaktiverar implicit svarstrådning. Explicita [[reply_to_*]]-taggar respekteras fortfarande.

Inte behövda idag (men sannolikt i framtiden)

Inbound attachments

Slack-filbilagor laddas ner från Slack-hostade privata URL:er (tokenautentiserat begärdeflöde) och skrivs till medielagret när hämtningen lyckas och storleksgränser tillåter.

Gränsen för inkommande storlek vid körning är som standard `20MB` om den inte åsidosätts av `channels.slack.mediaMaxMb`.

Outbound text and files

textblock använder channels.slack.textChunkLimit (standard 4000)
channels.slack.chunkMode="newline" aktiverar styckevis uppdelning först
filsändningar använder Slack upload APIs och kan inkludera trådsvar (thread_ts)
utgående mediagräns följer channels.slack.mediaMaxMb när den är konfigurerad; annars använder kanalsändningar MIME-typsstandarder från mediapipelinen

Delivery targets

Föredragna explicita mål:

- `user:<id>` för DMs
- `channel:<id>` för kanaler

Slack-DMs öppnas via Slack conversation APIs när meddelanden skickas till användarmål.

Begränsningar

Slack-åtgärder styrs av channels.slack.actions.*. Tillgängliga åtgärdsgrupper i nuvarande Slack-verktyg:

Grupp	Standard
messages	enabled
reactions	enabled
pins	enabled
memberInfo	enabled
emojiList	enabled

Händelser och operativt beteende

Redigeringar/raderingar av meddelanden och trådsändningar mappas till systemhändelser.
Händelser för att lägga till/ta bort reaktioner mappas till systemhändelser.
Händelser för medlem som går med/lämnar, kanal som skapas/byter namn samt nålning som läggs till/tas bort mappas till systemhändelser.
channel_id_changed kan migrera kanalens konfigurationsnycklar när configWrites är aktiverat.
Kanalens ämnes-/syftesmetadata behandlas som opålitlig kontext och kan injiceras i routningskontexten.

Trådning per chatttyp

Du kan konfigurera olika trådningsbeteenden per chatttyp genom att sätta channels.slack.replyToModeByChatType: Upplösningsordning:

channels.slack.accounts.<accountId>.ackReaction
channels.slack.ackReaction
messages.ackReaction
reserv-emoji för agentidentitet (agents.list[].identity.emoji, annars ”👀”)

Obs:

Slack förväntar sig shortcodes (till exempel "eyes").
Använd "" för att inaktivera reaktionen för en kanal eller ett konto.

Manifest och omfattningschecklista

Slack app manifest example

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

Optional user-token scopes (read operations)

Om du konfigurerar channels.slack.userToken är typiska läsbehörigheter:

- `channels:history`, `groups:history`, `im:history`, `mpim:history`
- `channels:read`, `groups:read`, `im:read`, `mpim:read`
- `users:read`
- `reactions:read`
- `pins:read`
- `emoji:read`
- `search:read` (om du är beroende av Slack-sökning för läsning)

Felsökning

No replies in channels

Kontrollera, i ordning:

- `groupPolicy`
- kanalens allowlist (`channels.slack.channels`)
- `requireMention`
- per-kanal `users` allowlist

Användbara kommandon:

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

DM messages ignored

Kontrollera:

- `channels.slack.dm.enabled`
- `channels.slack.dmPolicy` (eller äldre `channels.slack.dm.policy`)
- parkopplingsgodkännanden / allowlist-poster

openclaw pairing list slack

Socket mode not connecting

Verifiera bot- och app-token samt att Socket Mode är aktiverat i Slack-appens inställningar.

HTTP mode not receiving events

Verifiera:

- signing secret
- webhook-sökväg
- Slack Request URLs (Events + Interactivity + Slash Commands)
- unik `webhookPath` per HTTP-konto

Native/slash commands not firing

Verifiera om du avsåg:

- inbyggt kommandoläge (`channels.slack.commands.native: true`) med matchande slash commands registrerade i Slack
- eller läge med ett enda slash-kommando (`channels.slack.slashCommand.enabled: true`)

Kontrollera även `commands.useAccessGroups` och kanal-/användar-allowlists.

Verktygsåtgärder

Slack-verktygsåtgärder kan spärras med channels.slack.actions.*:

Configuration reference - Slack Viktiga Slack-fält:
- läge/autentisering: mode, botToken, appToken, signingSecret, webhookPath, accounts.*
- DM-åtkomst: dm.enabled, dmPolicy, allowFrom (äldre: dm.policy, dm.allowFrom), dm.groupEnabled, dm.groupChannels
- kanalåtkomst: groupPolicy, channels.*, channels.*.users, channels.*.requireMention
- trådar/historik: replyToMode, replyToModeByChatType, thread.*, historyLimit, dmHistoryLimit, dms.*.historyLimit
- leverans: textChunkLimit, chunkMode, mediaMaxMb
- drift/funktioner: configWrites, commands.native, slashCommand.*, actions.*, userToken, userTokenReadOnly

Säkerhetsnoteringar

Skrivningar använder som standard bot-token så att tillståndsändrande åtgärder hålls inom appens botbehörigheter och identitet.
Channel routing
Om du aktiverar skrivningar med användartoken, säkerställ att användartoken inkluderar de skriv- scopes du förväntar dig (chat:write, reactions:write, pins:write, files:write) annars kommer dessa operationer att misslyckas.
Configuration
Slash commands

Översikt

Meddelandeplattformar

Konfiguration

Slack

Slack

Pairing

Slash commands

Channel troubleshooting

Snabbstart

Tokenmodell

Åtkomstkontroll och routing

OpenClaw-konfig (minimal)

Scopes (aktuella vs valfria)

Inte behövda idag (men sannolikt i framtiden)

Begränsningar

Händelser och operativt beteende

Trådning per chatttyp

Manifest och omfattningschecklista

Felsökning

Verktygsåtgärder

Säkerhetsnoteringar

​Slack

Pairing

Slash commands

Channel troubleshooting

​Snabbstart

​Tokenmodell

​Åtkomstkontroll och routing

​OpenClaw-konfig (minimal)

​Scopes (aktuella vs valfria)

​Inte behövda idag (men sannolikt i framtiden)

​Begränsningar

​Händelser och operativt beteende

​Trådning per chatttyp

​Manifest och omfattningschecklista

​Felsökning

​Verktygsåtgärder

​Säkerhetsnoteringar

Slack

Snabbstart

Tokenmodell

Åtkomstkontroll och routing

OpenClaw-konfig (minimal)

Scopes (aktuella vs valfria)

Inte behövda idag (men sannolikt i framtiden)

Begränsningar

Händelser och operativt beteende

Trådning per chatttyp

Manifest och omfattningschecklista

Felsökning

Verktygsåtgärder

Säkerhetsnoteringar