Slack

Productiegereed voor privéberichten en kanalen via Slack-appintegraties. De standaardmodus is Socket Mode; HTTP Request URLs worden ook ondersteund.

# Socket Mode of HTTP Request URLs kiezen

Beide transporten zijn productiegereed en bieden functiepariteit voor berichten, slash-opdrachten, App Home en interactiviteit. Kies op basis van de implementatievorm, niet op basis van functies.

# Snelle installatie

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

# Afstemming van Socket Mode-transport

OpenClaw stelt de pong-time-out van de Slack SDK-client standaard in op 15 seconden voor Socket Mode. Overschrijf de transportinstellingen alleen wanneer je werkruimte- of hostspecifieke afstemming nodig hebt:

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

Gebruik dit alleen voor Socket Mode-werkruimten die Slack websocket pong-/server-pingtime-outs loggen of draaien op hosts met bekende event-loop-verstopping. clientPingTimeout is de wachttijd op pong nadat de SDK een client-ping verstuurt; serverPingTimeout is de wachttijd op server-pings van Slack. Appberichten en events blijven applicatiestatus, geen signalen voor transport-liveness.

# Manifest- en scopechecklist

Het basismanifest van de Slack-app is hetzelfde voor Socket Mode en HTTP Request URLs. Alleen het blok settings (en de slash command-url) verschilt.

Basismanifest (standaard 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"
      ]
    }
  }
}

Voor de modus HTTP Request URLs vervang je settings door de HTTP-variant en voeg je url toe aan elke slash command. Openbare URL vereist:

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

# Aanvullende manifestinstellingen

Toon verschillende functies die de bovenstaande standaardwaarden uitbreiden.

Het standaardmanifest schakelt het tabblad Home van Slack App Home in en abonneert zich op app_home_opened. Wanneer een lid van een werkruimte het tabblad Home opent, publiceert OpenClaw een veilige standaardweergave voor Home met views.publish; er wordt geen gesprekspayload of privéconfiguratie opgenomen. Het tabblad Messages blijft ingeschakeld voor Slack-DM's.

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

# Tokenmodel

• botToken + appToken zijn vereist voor Socket Mode.
• HTTP-modus vereist botToken + signingSecret.
• botToken, appToken, signingSecret en userToken accepteren plattetekststrings of SecretRef-objecten.
• Configuratietokens overschrijven de env-terugval.
• SLACK_BOT_TOKEN / SLACK_APP_TOKEN env-terugval is alleen van toepassing op het standaardaccount.
• userToken (xoxp-...) is alleen configureerbaar via config (geen env-terugval) en gebruikt standaard alleen-lezen gedrag (userTokenReadOnly: true).

Gedrag van statussnapshot:

• Slack-accountinspectie houdt per credential *Source- en *Status-velden bij (botToken, appToken, signingSecret, userToken).
• Status is available, configured_unavailable of missing.
• configured_unavailable betekent dat het account is geconfigureerd via SecretRef of een andere niet-inline geheime bron, maar dat het huidige commando/runtime-pad de daadwerkelijke waarde niet kon oplossen.
• In HTTP-modus wordt signingSecretStatus opgenomen; in Socket Mode is het vereiste paar botTokenStatus + appTokenStatus.

# Acties en gates

Slack-acties worden beheerd door channels.slack.actions.*.

Beschikbare actiegroepen in de huidige Slack-tooling:

Huidige Slack-berichtacties zijn onder andere send, upload-file, download-file, read, edit, delete, pin, unpin, list-pins, member-info en emoji-list. download-file accepteert Slack-bestands-ID's die worden getoond in inkomende bestandsplaceholders en retourneert afbeeldingsvoorbeelden voor afbeeldingen of lokale bestandsmetadata voor andere bestandstypen.

# Toegangscontrole en routering

# Threads, sessies en antwoordtags

• DM's routeren als direct; kanalen als channel; MPIM's als group.
• Slack-routebindingen accepteren ruwe peer-ID's plus Slack-doelformen zoals channel:C12345678, user:U12345678 en <@U12345678>.
• Met de standaard session.dmScope=main worden Slack-DM's samengevoegd tot de hoofdsessie van de agent.
• Kanaalsessies: agent:<agentId>:slack:channel:<channelId>.
• Threadantwoorden kunnen thread-sessieachtervoegsels (:thread:<threadTs>) aanmaken wanneer van toepassing.
• Standaard voor channels.slack.thread.historyScope is thread; standaard voor thread.inheritParent is false.
• channels.slack.thread.initialHistoryLimit bepaalt hoeveel bestaande threadberichten worden opgehaald wanneer een nieuwe threadsessie start (standaard 20; stel in op 0 om uit te schakelen).
• channels.slack.thread.requireExplicitMention (standaard false): wanneer true, worden impliciete threadvermeldingen onderdrukt zodat de bot alleen reageert op expliciete @bot-vermeldingen in threads, zelfs wanneer de bot al aan de thread heeft deelgenomen. Zonder dit omzeilen antwoorden in een thread waaraan de bot heeft deelgenomen de requireMention-gate.

Besturing voor antwoordthreads:

• channels.slack.replyToMode: off|first|all|batched (standaard off)
• channels.slack.replyToModeByChatType: per direct|group|channel
• legacy fallback voor directe chats: channels.slack.dm.replyToMode

Handmatige antwoordtags worden ondersteund:

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

# Ack-reacties

ackReaction verzendt een bevestigingsemoji terwijl OpenClaw een inkomend bericht verwerkt.

Resolutievolgorde:

• channels.slack.accounts.<accountId>.ackReaction
• channels.slack.ackReaction
• messages.ackReaction
• terugval op emoji van agentidentiteit (agents.list[].identity.emoji, anders "👀")

Opmerkingen:

• Slack verwacht shortcodes (bijvoorbeeld "eyes").
• Gebruik "" om de reactie voor het Slack-account of globaal uit te schakelen.

# Tekststreaming

channels.slack.streaming beheert live preview-gedrag:

• off: schakel live preview-streaming uit.
• partial (standaard): vervang previewtekst door de nieuwste gedeeltelijke uitvoer.
• block: voeg preview-updates in chunks toe.
• progress: toon voortgangsstatustekst tijdens het genereren en verzend daarna de definitieve tekst.
• streaming.preview.toolProgress: wanneer draft preview actief is, routeer tool-/voortgangsupdates naar hetzelfde bewerkte previewbericht (standaard: true). Stel in op false om afzonderlijke tool-/voortgangsberichten te behouden.
• streaming.preview.commandText / streaming.progress.commandText: stel in op status om compacte voortgangsregels voor tools te behouden terwijl ruwe command-/exec-tekst wordt verborgen (standaard: raw).

Verberg ruwe command-/exec-tekst terwijl compacte voortgangsregels behouden blijven:

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

channels.slack.streaming.nativeTransport beheert Slack-native tekststreaming wanneer channels.slack.streaming.mode partial is (standaard: true).

• Er moet een antwoordthread beschikbaar zijn voordat native tekststreaming en Slack-assistent-threadstatus kunnen verschijnen. Threadselectie volgt nog steeds replyToMode.
• Kanaal-, groepschat- en top-level DM-roots kunnen nog steeds de normale draft preview gebruiken wanneer native streaming niet beschikbaar is of er geen antwoordthread bestaat.
• Top-level Slack-DM's blijven standaard buiten threads, dus ze tonen geen Slack-threadachtige native stream-/statuspreview; OpenClaw plaatst en bewerkt in plaats daarvan een draft preview in de DM.
• Media en niet-tekstpayloads vallen terug op normale levering.
• Definitieve media-/foutberichten annuleren openstaande previewbewerkingen; in aanmerking komende definitieve tekst-/blockberichten worden alleen geflusht wanneer ze de preview op zijn plaats kunnen bewerken.
• Als streaming halverwege een antwoord mislukt, valt OpenClaw terug op normale levering voor resterende payloads.

Gebruik draft preview in plaats van Slack-native tekststreaming:

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

Legacy sleutels:

• channels.slack.streamMode (replace | status_final | append) is een verouderde runtime-alias voor channels.slack.streaming.mode.
• boolean channels.slack.streaming is een verouderde runtime-alias voor channels.slack.streaming.mode en channels.slack.streaming.nativeTransport.
• verouderde channels.slack.nativeStreaming is een runtime-alias voor channels.slack.streaming.nativeTransport.
• Voer openclaw doctor --fix uit om opgeslagen Slack-streamingconfiguratie naar de canonieke sleutels te herschrijven.

# Terugval voor typreactie

typingReaction voegt een tijdelijke reactie toe aan het inkomende Slack-bericht terwijl OpenClaw een antwoord verwerkt, en verwijdert die wanneer de run is voltooid. Dit is vooral nuttig buiten threadantwoorden, die een standaardstatusindicator "is typing..." gebruiken.

Volgorde van oplossing:

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

Opmerkingen:

• Slack verwacht shortcodes (bijvoorbeeld "hourglass_flowing_sand").
• De reactie is best-effort en opschoning wordt automatisch geprobeerd nadat het antwoord of het foutpad is voltooid.

# Media, chunking en aflevering

# Opdrachten en slash-gedrag

Slash-opdrachten verschijnen in Slack als één geconfigureerde opdracht of als meerdere native opdrachten. Configureer channels.slack.slashCommand om opdrachtstandaarden te wijzigen:

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

/openclaw /help

Native opdrachten vereisen aanvullende manifestinstellingen in je Slack-app en worden in plaats daarvan ingeschakeld met channels.slack.commands.native: true of commands.native: true in globale configuraties.

• Native opdracht-automodus staat uit voor Slack, dus commands.native: "auto" schakelt native Slack-opdrachten niet in.

/help

Native argumentmenu's gebruiken een adaptieve renderingstrategie die een bevestigingsmodal toont voordat een geselecteerde optiewaarde wordt verzonden:

• tot 5 opties: knopblokken
• 6-100 opties: statisch selectiemenu
• meer dan 100 opties: externe selectie met asynchrone optiefiltering wanneer handlers voor interactiviteitsopties beschikbaar zijn
• overschreden Slack-limieten: gecodeerde optiewaarden vallen terug op knoppen

/think

Slash-sessies gebruiken geïsoleerde sleutels zoals agent:<agentId>:slack:slash:<userId> en routeren opdrachtuitvoeringen nog steeds naar de doelconversatiesessie met CommandTargetSessionKey.

# Interactieve antwoorden

Slack kan door agents geschreven interactieve antwoordbedieningselementen renderen, maar deze functie is standaard uitgeschakeld.

Schakel dit globaal in:

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

Of schakel dit alleen in voor één Slack-account:

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

Wanneer ingeschakeld kunnen agents Slack-specifieke antwoorddirectieven uitsturen:

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

Deze directieven compileren naar Slack Block Kit en routeren klikken of selecties terug via het bestaande Slack-interactiegebeurtenispad.

Opmerkingen:

• Dit is Slack-specifieke UI. Andere kanalen vertalen Slack Block Kit-directieven niet naar hun eigen knoppensystemen.
• De interactieve callbackwaarden zijn door OpenClaw gegenereerde opaque tokens, geen ruwe door agents geschreven waarden.
• Als gegenereerde interactieve blokken Slack Block Kit-limieten zouden overschrijden, valt OpenClaw terug op het oorspronkelijke tekstantwoord in plaats van een ongeldige blocks-payload te verzenden.

# Exec-goedkeuringen in Slack

Slack kan fungeren als native goedkeuringsclient met interactieve knoppen en interacties, in plaats van terug te vallen op de web-UI of terminal.

• Exec-goedkeuringen gebruiken channels.slack.execApprovals.* voor native DM-/kanaalroutering.
• Plugin-goedkeuringen kunnen nog steeds via hetzelfde Slack-native knopoppervlak worden opgelost wanneer het verzoek al in Slack belandt en het soort goedkeurings-id plugin: is.
• Autorisatie van goedkeurders wordt nog steeds afgedwongen: alleen gebruikers die als goedkeurders zijn geïdentificeerd, kunnen verzoeken via Slack goedkeuren of weigeren.

Dit gebruikt hetzelfde gedeelde goedkeuringsknopoppervlak als andere kanalen. Wanneer interactivity is ingeschakeld in je Slack-appinstellingen, worden goedkeuringsprompts rechtstreeks in de conversatie als Block Kit-knoppen weergegeven. Wanneer die knoppen aanwezig zijn, zijn ze de primaire goedkeurings-UX; OpenClaw mag alleen een handmatige /approve-opdracht opnemen wanneer het toolresultaat zegt dat chatgoedkeuringen niet beschikbaar zijn of handmatige goedkeuring het enige pad is.

Configuratiepad:

• channels.slack.execApprovals.enabled
• channels.slack.execApprovals.approvers (optioneel; valt waar mogelijk terug op commands.ownerAllowFrom)
• channels.slack.execApprovals.target (dm | channel | both, standaard: dm)
• agentFilter, sessionFilter

Slack schakelt native exec-goedkeuringen automatisch in wanneer enabled niet is ingesteld of "auto" is en ten minste één goedkeurder wordt opgelost. Stel enabled: false in om Slack expliciet als native goedkeuringsclient uit te schakelen. Stel enabled: true in om native goedkeuringen geforceerd in te schakelen wanneer goedkeurders worden opgelost.

Standaardgedrag zonder expliciete Slack exec-goedkeuringsconfiguratie:

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

Expliciete Slack-native configuratie is alleen nodig wanneer je goedkeurders wilt overschrijven, filters wilt toevoegen of wilt kiezen voor aflevering naar de oorsprongschat:

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

Gedeelde approvals.exec-doorsturing staat los hiervan. Gebruik dit alleen wanneer exec-goedkeuringsprompts ook naar andere chats of expliciete out-of-band-doelen moeten routeren. Gedeelde approvals.plugin-doorsturing staat ook los hiervan; Slack-native knoppen kunnen nog steeds Plugin-goedkeuringen oplossen wanneer die verzoeken al in Slack belanden.

Zelfde-chat /approve werkt ook in Slack-kanalen en DM's die al opdrachten ondersteunen. Zie Exec-goedkeuringen voor het volledige model voor goedkeuringsdoorsturing.

# Gebeurtenissen en operationeel gedrag

• Berichtbewerkingen/verwijderingen worden naar systeemgebeurtenissen gemapt.
• Threaduitzendingen ("Also send to channel"-threadantwoorden) worden verwerkt als normale gebruikersberichten.
• Gebeurtenissen voor reactie toevoegen/verwijderen worden naar systeemgebeurtenissen gemapt.
• Lid toetreden/verlaten, kanaal gemaakt/hernoemd en pin toevoegen/verwijderen worden naar systeemgebeurtenissen gemapt.
• channel_id_changed kan kanaalconfiguratiesleutels migreren wanneer configWrites is ingeschakeld.
• Metadata voor kanaalonderwerp/doel wordt behandeld als niet-vertrouwde context en kan in routeringscontext worden geïnjecteerd.
• Threadstarter en initiële threadgeschiedenis-contextseeding worden waar van toepassing gefilterd door geconfigureerde afzender-allowlists.
• Blokacties en modalinteracties sturen gestructureerde Slack interaction: ...-systeemgebeurtenissen uit met rijke payloadvelden:
  • blokacties: geselecteerde waarden, labels, pickerwaarden en workflow_*-metadata
  • modal-view_submission- en view_closed-gebeurtenissen met gerouteerde kanaalmetadata en formulierinvoer

# Configuratiereferentie

Primaire referentie: Configuratiereferentie - Slack.

# Probleemoplossing

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

openclaw pairing list slack

# Referentie voor bijlagevisie

Slack kan gedownloade media aan de agentbeurt toevoegen wanneer Slack-bestandsdownloads slagen en de groottelimieten dit toestaan. Afbeeldingsbestanden kunnen worden doorgegeven via het pad voor mediabegrip of rechtstreeks aan een antwoordmodel met vision-ondersteuning; andere bestanden worden bewaard als downloadbare bestandscontext in plaats van als afbeeldingsinvoer te worden behandeld.

# Ondersteunde mediatypen

# Inbound-pipeline

Wanneer een Slack-bericht met bestandsbijlagen binnenkomt:

1. OpenClaw downloadt het bestand vanaf de privé-URL van Slack met het bot-token (xoxb-...).
2. Het bestand wordt bij succes naar de mediaopslag geschreven.
3. Gedownloade mediapaden en contenttypes worden toegevoegd aan de inbound-context.
4. Model- en toolpaden met afbeeldingsondersteuning kunnen afbeeldingsbijlagen uit die context gebruiken.
5. Niet-afbeeldingsbestanden blijven beschikbaar als bestandsmetadata of mediareferenties voor tools die ze kunnen verwerken.

# Overerving van thread-rootbijlagen

Wanneer een bericht in een thread binnenkomt (met een thread_ts-bovenliggend item):

• Als het antwoord zelf geen directe media heeft en het meegeleverde rootbericht bestanden bevat, kan Slack de rootbestanden hydrateren als thread-startercontext.
• Directe antwoordbijlagen hebben voorrang op rootberichtbijlagen.
• Een rootbericht dat alleen bestanden en geen tekst bevat, wordt weergegeven met een bijlageplaceholder zodat de fallback de bestanden nog steeds kan opnemen.

# Afhandeling van meerdere bijlagen

Wanneer een enkel Slack-bericht meerdere bestandsbijlagen bevat:

• Elke bijlage wordt onafhankelijk via de mediapipeline verwerkt.
• Gedownloade mediareferenties worden samengevoegd in de berichtcontext.
• De verwerkingsvolgorde volgt de bestandsvolgorde van Slack in de eventpayload.
• Een fout bij het downloaden van één bijlage blokkeert de andere niet.

# Grootte-, download- en modellimieten

• Groottelimiet: standaard 20 MB per bestand. Configureerbaar via channels.slack.mediaMaxMb.
• Downloadfouten: bestanden die Slack niet kan leveren, verlopen URL's, ontoegankelijke bestanden, te grote bestanden en Slack-auth/login-HTML-antwoorden worden overgeslagen in plaats van als niet-ondersteunde indelingen te worden gerapporteerd.
• Vision-model: afbeeldingsanalyse gebruikt het actieve antwoordmodel wanneer dit vision ondersteunt, of het afbeeldingsmodel dat is geconfigureerd op agents.defaults.imageModel.

# Bekende beperkingen

# Gerelateerde documentatie

• Pipeline voor mediabegrip
• PDF-tool
• Epic: #51349 — Slack-bijlagevision inschakelen
• Regressietests: #51353
• Live-verificatie: #51354

# Gerelateerd