​

Slack

​

Snabbstart

{
  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-...

openclaw gateway

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

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

​

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:.

​

Åtkomstkontroll och routing

- `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>`.

- `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

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.

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

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

​

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).

• 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

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

​

Inte behövda idag (men sannolikt i framtiden)

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

- `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

​

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

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

• 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

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

- `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

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

Användbara kommandon:

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

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

openclaw pairing list slack

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

- 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

• 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