Productiegereed voor DM’s en kanalen via Slack-appintegraties. De standaardmodus is Socket Mode; HTTP Request URL’s worden ook ondersteund.Documentation Index
Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt
Use this file to discover all available pages before exploring further.
Koppelen
Slack-DM’s gebruiken standaard de koppelingsmodus.
Slash-opdrachten
Native opdrachtgedrag en opdrachtcatalogus.
Kanaalprobleemoplossing
Kanaaloverstijgende diagnostiek en herstelhandleidingen.
Socket Mode of HTTP Request URL’s kiezen
Beide transports zijn productiegereed en bieden featurepariteit voor berichten, slash-opdrachten, App Home en interactiviteit. Kies op basis van de implementatievorm, niet op basis van functies.| Aandachtspunt | Socket Mode (standaard) | HTTP Request URL’s |
|---|---|---|
| Publieke Gateway-URL | Niet vereist | Vereist (DNS, TLS, reverse proxy of tunnel) |
| Uitgaand netwerk | Uitgaande WSS naar wss-primary.slack.com moet bereikbaar zijn | Geen uitgaande WS; alleen inkomende HTTPS |
| Benodigde tokens | Bot-token (xoxb-...) + App-Level Token (xapp-...) met connections:write | Bot-token (xoxb-...) + Signing Secret |
| Dev-laptop / achter firewall | Werkt zonder extra stappen | Vereist een publieke tunnel (ngrok, Cloudflare Tunnel, Tailscale Funnel) of staging-Gateway |
| Horizontaal schalen | Eén Socket Mode-sessie per app per host; meerdere Gateways hebben aparte Slack-apps nodig | Stateless POST-handler; meerdere Gateway-replica’s kunnen één app delen achter een load balancer |
| Meerdere accounts op één Gateway | Ondersteund; elk account opent zijn eigen WS | Ondersteund; elk account heeft een unieke webhookPath nodig (standaard /slack/events) zodat registraties niet botsen |
| Transport voor slash-opdrachten | Geleverd via de WS-verbinding; slash_commands[].url wordt genegeerd | Slack POST naar slash_commands[].url; het veld is vereist om de opdracht te verzenden |
| Ondertekening van requests | Niet gebruikt (authenticatie is de App-Level Token) | Slack ondertekent elke request; OpenClaw verifieert met signingSecret |
| Herstel bij verbindingsuitval | Slack SDK maakt automatisch opnieuw verbinding; de pong-timeouttransportafstemming van de Gateway is van toepassing | Geen permanente verbinding die kan wegvallen; retries zijn per request vanuit Slack |
Kies Socket Mode voor hosts met één Gateway, dev-laptops en on-prem-netwerken die
*.slack.com uitgaand kunnen bereiken maar geen inkomende HTTPS kunnen accepteren.Kies HTTP Request URL’s wanneer je meerdere Gateway-replica’s achter een load balancer draait, wanneer uitgaande WSS is geblokkeerd maar inkomende HTTPS is toegestaan, of wanneer je Slack-webhooks al op een reverse proxy termineert.Snelle installatie
- Socket Mode (standaard)
- HTTP Request URL's
Maak een nieuwe Slack-app
Open api.slack.com/apps → Create New App → From a manifest → selecteer je workspace → plak een van de onderstaande manifests → Next → Create.Nadat Slack de app heeft gemaakt:
Aanbevolen komt overeen met de volledige functieset van de meegeleverde Slack-Plugin: App Home, slash-opdrachten, bestanden, reacties, pins, groeps-DM’s en emoji-/gebruikersgroeplezingen. Kies Minimaal wanneer workspacebeleid scopes beperkt — dit dekt DM’s, kanaal-/groepsgeschiedenis, vermeldingen en slash-opdrachten, maar laat bestanden, reacties, pins, groeps-DM (
mpim:*), emoji:read en usergroups:read weg. Zie Manifest- en scopechecklist voor de onderbouwing per scope en additieve opties zoals extra slash-opdrachten.- Basic Information → App-Level Tokens → Generate Token and Scopes: voeg
connections:writetoe, sla op en kopieer de waardexapp-.... - Install App → Install to Workspace: kopieer de
xoxb-...Bot User OAuth Token.
Transportafstemming voor Socket Mode
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:clientPingTimeout is de wachttijd voor pong nadat de SDK een clientping verzendt; serverPingTimeout is de wachttijd voor Slack-serverpings. Appberichten en events blijven applicatiestatus, geen signalen voor transportlevendigheid.
Manifest- en scopechecklist
Het basismanifest van de Slack-app is hetzelfde voor Socket Mode en HTTP Request URLs. Alleen hetsettings-blok (en de slash-command-url) verschilt.
Basemanifest (standaard Socket Mode):
settings door de HTTP-variant en voeg url toe aan elk slash-commando. Publieke URL vereist:
Aanvullende manifestinstellingen
Toon verschillende functies die de bovenstaande standaardinstellingen uitbreiden. Het standaardmanifest schakelt het Slack App Home-tabblad Home in en abonneert zich opapp_home_opened. Wanneer een werkruimtelid het tabblad Home opent, publiceert OpenClaw een veilige standaard-Home-weergave met views.publish; er wordt geen gesprekspayload of privéconfiguratie opgenomen. Het tabblad Messages blijft ingeschakeld voor Slack-DM’s.
Optional native slash commands
Optional native slash commands
Meerdere native slash-commando’s kunnen worden gebruikt in plaats van één geconfigureerd commando, met nuances:
- Gebruik
/agentstatusin plaats van/status, omdat het commando/statusgereserveerd is. - Er kunnen niet meer dan 25 slash-commando’s tegelijk beschikbaar worden gemaakt.
features.slash_commands door een subset van beschikbare commando’s:- Socket Mode (default)
- HTTP Request URLs
Optionele auteurschapsscopes (schrijfbewerkingen)
Optionele auteurschapsscopes (schrijfbewerkingen)
Voeg de botscope
chat:write.customize toe als je wilt dat uitgaande berichten de actieve agentidentiteit gebruiken (aangepaste gebruikersnaam en pictogram) in plaats van de standaard Slack-appidentiteit.Als je een emoji-pictogram gebruikt, verwacht Slack de syntaxis :emoji_name:.Optionele gebruikerstoken-scopes (leesbewerkingen)
Optionele gebruikerstoken-scopes (leesbewerkingen)
Als je
channels.slack.userToken configureert, zijn typische leesscopes:channels:history,groups:history,im:history,mpim:historychannels:read,groups:read,im:read,mpim:readusers:readreactions:readpins:reademoji:readsearch:read(als je afhankelijk bent van leesbewerkingen via Slack-zoekopdrachten)
Tokenmodel
botToken+appTokenzijn vereist voor Socket Mode.- HTTP-modus vereist
botToken+signingSecret. botToken,appToken,signingSecretenuserTokenaccepteren platte-tekststrings of SecretRef-objecten.- Configuratietokens overschrijven de env-terugval.
- De env-terugval
SLACK_BOT_TOKEN/SLACK_APP_TOKENgeldt alleen voor het standaardaccount. userToken(xoxp-...) is alleen via configuratie beschikbaar (geen env-terugval) en gebruikt standaard alleen-lezen-gedrag (userTokenReadOnly: true).
- Slack-accountinspectie volgt per inloggegeven
*Source- en*Status- velden (botToken,appToken,signingSecret,userToken). - Status is
available,configured_unavailableofmissing. configured_unavailablebetekent 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
signingSecretStatusopgenomen; in Socket Mode is het vereiste paarbotTokenStatus+appTokenStatus.
Acties en gates
Slack-acties worden beheerd doorchannels.slack.actions.*.
Beschikbare actiegroepen in de huidige Slack-tooling:
| Groep | Standaard |
|---|---|
| messages | ingeschakeld |
| reactions | ingeschakeld |
| pins | ingeschakeld |
| memberInfo | ingeschakeld |
| emojiList | ingeschakeld |
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 placeholders voor inkomende bestanden en retourneert afbeeldingsvoorbeelden voor afbeeldingen of lokale bestandsmetadata voor andere bestandstypen.
Toegangsbeheer en routering
- DM-beleid
- Kanaalbeleid
- Vermeldingen en kanaalgebruikers
channels.slack.dmPolicy beheert DM-toegang. channels.slack.allowFrom is de canonieke DM-allowlist.pairing(standaard)allowlistopen(vereist datchannels.slack.allowFrom"*"bevat)disabled
dm.enabled(standaard true)channels.slack.allowFromdm.allowFrom(legacy)dm.groupEnabled(groeps-DM’s standaard false)dm.groupChannels(optionele MPIM-allowlist)
channels.slack.accounts.default.allowFromgeldt alleen voor hetdefault-account.- Benoemde accounts erven
channels.slack.allowFromwanneer hun eigenallowFromniet is ingesteld. - Benoemde accounts erven
channels.slack.accounts.default.allowFromniet.
channels.slack.dm.policy en channels.slack.dm.allowFrom worden nog steeds gelezen voor compatibiliteit. openclaw doctor --fix migreert ze naar dmPolicy en allowFrom wanneer dat kan zonder toegang te wijzigen.Koppelen in DM’s gebruikt openclaw pairing approve slack <code>.Threads, sessies en antwoordtags
- DM’s routeren als
direct; kanalen alschannel; MPIM’s alsgroup. - Slack-routebindingen accepteren ruwe peer-ID’s plus Slack-doelformulieren zoals
channel:C12345678,user:U12345678en<@U12345678>. - Met standaard
session.dmScope=mainworden Slack-DM’s samengevoegd tot de hoofdsessie van de agent. - Kanaalsessies:
agent:<agentId>:slack:channel:<channelId>. - Threadantwoorden kunnen waar van toepassing threadsessie-achtervoegsels maken (
:thread:<threadTs>). - In kanalen waar OpenClaw top-level berichten afhandelt zonder een expliciete vermelding te vereisen, routeert een niet-
offreplyToModeelke afgehandelde root naaragent:<agentId>:slack:channel:<channelId>:thread:<rootTs>, zodat de zichtbare Slack-thread vanaf de eerste beurt naar één OpenClaw-sessie wordt gemapt. - De standaard voor
channels.slack.thread.historyScopeisthread; de standaard voorthread.inheritParentisfalse. channels.slack.thread.initialHistoryLimitbepaalt hoeveel bestaande threadberichten worden opgehaald wanneer een nieuwe threadsessie start (standaard20; stel in op0om uit te schakelen).channels.slack.thread.requireExplicitMention(standaardfalse): wanneertrue, onderdrukt impliciete threadvermeldingen zodat de bot alleen reageert op expliciete@bot-vermeldingen binnen threads, zelfs wanneer de bot al aan de thread heeft deelgenomen. Zonder dit omzeilen antwoorden in een thread waaraan de bot heeft deelgenomen derequireMention-gate.
channels.slack.replyToMode:off|first|all|batched(standaardoff)channels.slack.replyToModeByChatType: perdirect|group|channel- legacy terugval voor directe chats:
channels.slack.dm.replyToMode
[[reply_to_current]][[reply_to:<id>]]
message-tool stel je replyBroadcast: true in met action: "send" en threadId of replyTo om Slack te vragen het threadantwoord ook naar het bovenliggende kanaal uit te zenden. Dit mappt naar de reply_broadcast-vlag van Slack chat.postMessage en wordt alleen ondersteund voor tekst- of Block Kit-verzendingen, niet voor media-uploads.
Wanneer een message-toolaanroep binnen een Slack-thread draait en hetzelfde kanaal target, erft OpenClaw normaal gesproken de huidige Slack-thread volgens replyToMode. Stel topLevel: true in op action: "send" of action: "upload-file" om in plaats daarvan een nieuw bericht in het bovenliggende kanaal af te dwingen. threadId: null wordt geaccepteerd als dezelfde top-level opt-out.
replyToMode="off" schakelt alle antwoordthreading in Slack uit, inclusief expliciete [[reply_to_*]]-tags. Dit verschilt van Telegram, waar expliciete tags nog steeds worden gehonoreerd in "off"-modus. Slack-threads verbergen berichten uit het kanaal, terwijl Telegram-antwoorden inline zichtbaar blijven.Ack-reacties
ackReaction stuurt een bevestigingsemoji terwijl OpenClaw een inkomend bericht verwerkt.
Resolutievolgorde:
channels.slack.accounts.<accountId>.ackReactionchannels.slack.ackReactionmessages.ackReaction- emoji-terugval voor agentidentiteit (
agents.list[].identity.emoji, anders ”👀”)
- Slack verwacht shortcodes (bijvoorbeeld
"eyes"). - Gebruik
""om de reactie voor het Slack-account of globaal uit te schakelen.
Tekststreaming
channels.slack.streaming beheert livevoorbeeldgedrag:
off: schakel livevoorbeeldstreaming uit.partial(standaard): vervang voorbeeldtekst door de nieuwste gedeeltelijke uitvoer.block: voeg preview-updates in chunks toe.progress: toon voortgangsstatustekst tijdens het genereren en stuur daarna de definitieve tekst.streaming.preview.toolProgress: wanneer conceptvoorbeeld actief is, routeer tool-/voortgangsupdates naar hetzelfde bewerkte voorbeeldbericht (standaard:true). Stel in opfalseom afzonderlijke tool-/voortgangsberichten te behouden.streaming.preview.commandText/streaming.progress.commandText: stel in opstatusom compacte toolvoortgangsregels te behouden terwijl ruwe command-/exec-tekst wordt verborgen (standaard:raw).
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 de Slack-assistentthreadstatus kunnen verschijnen. Threadselectie volgt nog steeds
replyToMode. - Kanaal-, groepschat- en DM-roots op topniveau kunnen nog steeds de normale conceptpreview gebruiken wanneer native streaming niet beschikbaar is of er geen antwoordthread bestaat.
- Slack-DM’s op topniveau blijven standaard buiten threads, dus ze tonen geen Slack-native stream-/statuspreview in threadstijl; OpenClaw plaatst en bewerkt in plaats daarvan een conceptpreview in de DM.
- Media en niet-tekstpayloads vallen terug op normale levering.
- Media-/foutfinals annuleren wachtende previewbewerkingen; geschikte tekst-/blokfinals worden alleen geflusht wanneer ze de preview op dezelfde plek kunnen bewerken.
- Als streaming halverwege een antwoord mislukt, valt OpenClaw terug op normale levering voor resterende payloads.
channels.slack.streamMode(replace | status_final | append) is een verouderde runtime-alias voorchannels.slack.streaming.mode.- boolean
channels.slack.streamingis een verouderde runtime-alias voorchannels.slack.streaming.modeenchannels.slack.streaming.nativeTransport. - verouderde
channels.slack.nativeStreamingis een runtime-alias voorchannels.slack.streaming.nativeTransport. - Voer
openclaw doctor --fixuit om opgeslagen Slack-streamingconfiguratie naar de canonieke sleutels te herschrijven.
Fallback voor typreactie
typingReaction voegt een tijdelijke reactie toe aan het inkomende Slack-bericht terwijl OpenClaw een antwoord verwerkt, en verwijdert die wanneer de uitvoering klaar is. Dit is vooral nuttig buiten threadantwoorden, die een standaardstatusindicator “is typing…” gebruiken.
Oplossingsvolgorde:
channels.slack.accounts.<accountId>.typingReactionchannels.slack.typingReaction
- Slack verwacht shortcodes (bijvoorbeeld
"hourglass_flowing_sand"). - De reactie is best-effort en opruimen wordt automatisch geprobeerd nadat het antwoord of het foutpad is voltooid.
Media, chunking en levering
Inkomende bijlagen
Inkomende bijlagen
Slack-bestandsbijlagen worden gedownload vanaf door Slack gehoste privé-URL’s (token-geauthenticeerde aanvraagflow) en naar de mediaopslag geschreven wanneer ophalen slaagt en groottelimieten dit toestaan. Bestandsplaceholders bevatten de Slack-
fileId, zodat agents het oorspronkelijke bestand kunnen ophalen met download-file.Downloads gebruiken begrensde idle- en totale time-outs. Als het ophalen van Slack-bestanden vastloopt of mislukt, blijft OpenClaw het bericht verwerken en valt het terug op de bestandsplaceholder.De runtimegroottelimiet voor inkomende bestanden is standaard 20MB, tenzij overschreven door channels.slack.mediaMaxMb.Uitgaande tekst en bestanden
Uitgaande tekst en bestanden
- tekstchunks gebruiken
channels.slack.textChunkLimit(standaard 4000) channels.slack.chunkMode="newline"schakelt paragraaf-eerst splitsen in- bestandsverzendingen gebruiken Slack-upload-API’s en kunnen threadantwoorden bevatten (
thread_ts) - de limiet voor uitgaande media volgt
channels.slack.mediaMaxMbwanneer geconfigureerd; anders gebruiken kanaalverzendingen MIME-soortstandaarden uit de mediapijplijn
Leveringsdoelen
Leveringsdoelen
Expliciete voorkeursdoelen:
user:<id>voor DM’schannel:<id>voor kanalen
Commands en slashgedrag
Slash-commands verschijnen in Slack als één geconfigureerde command of als meerdere native commands. Configureerchannels.slack.slashCommand om commandstandaarden te wijzigen:
enabled: falsename: "openclaw"sessionPrefix: "slack:slash"ephemeral: true
channels.slack.commands.native: true of commands.native: true in globale configuraties.
- Native command automodus is uit voor Slack, dus
commands.native: "auto"schakelt Slack-native commands niet in.
- tot 5 opties: knopblokken
- 6-100 opties: statisch selectiemenu
- meer dan 100 opties: externe selectie met asynchrone optiefiltering wanneer interactiviteitsoptiehandlers beschikbaar zijn
- overschreden Slack-limieten: gecodeerde optiewaarden vallen terug op knoppen
agent:<agentId>:slack:slash:<userId> en routeren commanduitvoeringen 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:[[slack_buttons: Approve:approve, Reject:reject]][[slack_select: Choose a target | Canary:canary, Production:production]]
- Dit is Slack-specifieke UI. Andere kanalen vertalen Slack Block Kit-richtlijnen niet naar hun eigen knoppensystemen.
- De interactieve callbackwaarden zijn door OpenClaw gegenereerde ondoorzichtige tokens, geen ruwe waarden die door agenten zijn geschreven.
- Als gegenereerde interactieve blokken de limieten van Slack Block Kit zouden overschrijden, valt OpenClaw terug op het oorspronkelijke tekstantwoord in plaats van een ongeldige blokkenpayload te verzenden.
Exec-goedkeuringen in Slack
Slack kan optreden 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 routering naar DM/kanaal. - Plugin-goedkeuringen kunnen nog steeds via hetzelfde Slack-native knopoppervlak worden afgehandeld wanneer het verzoek al in Slack terechtkomt 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.
interactivity is ingeschakeld in je Slack-appinstellingen, worden goedkeuringsprompts direct in het gesprek weergegeven als Block Kit-knoppen.
Wanneer die knoppen aanwezig zijn, vormen ze de primaire goedkeurings-UX; OpenClaw
mag alleen een handmatige /approve-opdracht opnemen wanneer het toolresultaat aangeeft dat chatgoedkeuringen
niet beschikbaar zijn of handmatige goedkeuring het enige pad is.
Configuratiepad:
channels.slack.execApprovals.enabledchannels.slack.execApprovals.approvers(optioneel; valt waar mogelijk terug opcommands.ownerAllowFrom)channels.slack.execApprovals.target(dm|channel|both, standaard:dm)agentFilter,sessionFilter
enabled niet is ingesteld of "auto" is en ten minste één
goedkeurder wordt opgelost. Stel enabled: false in om Slack expliciet uit te schakelen als native goedkeuringsclient.
Stel enabled: true in om native goedkeuringen af te dwingen wanneer goedkeurders worden opgelost.
Standaardgedrag zonder expliciete configuratie voor Slack-exec-goedkeuringen:
approvals.exec-doorsturing staat hier los van. Gebruik dit alleen wanneer prompts voor exec-goedkeuringen ook
naar andere chats of expliciete out-of-band doelen moeten worden gerouteerd. Gedeelde approvals.plugin-doorsturing staat hier ook
los van; Slack-native knoppen kunnen nog steeds Plugin-goedkeuringen afhandelen wanneer die verzoeken al
in Slack terechtkomen.
/approve in dezelfde chat 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
- Berichtenbewerkingen/-verwijderingen worden toegewezen aan systeemgebeurtenissen.
- Thread-uitzendingen (“Ook naar kanaal verzenden” bij thread-antwoorden) worden verwerkt als normale gebruikersberichten.
- Gebeurtenissen voor het toevoegen/verwijderen van reacties worden toegewezen aan systeemgebeurtenissen.
- Gebeurtenissen voor lid toetreden/verlaten, kanaal aangemaakt/hernoemd en pin toevoegen/verwijderen worden toegewezen aan systeemgebeurtenissen.
channel_id_changedkan kanaalconfiguratiesleutels migreren wanneerconfigWritesis ingeschakeld.- Metadata voor kanaalonderwerp/-doel wordt behandeld als niet-vertrouwde context en kan in routeringscontext worden geïnjecteerd.
- Threadstarter en initiële contextvulling voor threadgeschiedenis worden, waar van toepassing, gefilterd op basis van geconfigureerde afzender-allowlists.
- Blokacties en modale interacties geven gestructureerde systeemgebeurtenissen
Slack interaction: ...uit met rijke payloadvelden:- blokacties: geselecteerde waarden, labels, pickerwaarden en
workflow_*-metadata - modale
view_submission- enview_closed-gebeurtenissen met gerouteerde kanaalmetadata en formulierinvoer
- blokacties: geselecteerde waarden, labels, pickerwaarden en
Configuratiereferentie
Primaire referentie: Configuratiereferentie - Slack.Signaalrijke Slack-velden
Signaalrijke Slack-velden
- modus/auth:
mode,botToken,appToken,signingSecret,webhookPath,accounts.* - DM-toegang:
dm.enabled,dmPolicy,allowFrom(verouderd:dm.policy,dm.allowFrom),dm.groupEnabled,dm.groupChannels - compatibiliteitsschakelaar:
dangerouslyAllowNameMatching(noodschakelaar; laat uit tenzij nodig) - kanaaltoegang:
groupPolicy,channels.*,channels.*.users,channels.*.requireMention - threads/geschiedenis:
replyToMode,replyToModeByChatType,thread.*,historyLimit,dmHistoryLimit,dms.*.historyLimit - levering:
textChunkLimit,chunkMode,mediaMaxMb,streaming,streaming.nativeTransport,streaming.preview.toolProgress - ontvouwingen:
unfurlLinks,unfurlMediavoor beheer van link-/mediavoorbeelden vanchat.postMessage - ops/functies:
configWrites,commands.native,slashCommand.*,actions.*,userToken,userTokenReadOnly
Problemen oplossen
Geen antwoorden in kanalen
Geen antwoorden in kanalen
Controleer, in volgorde:
groupPolicy- kanaal-allowlist (
channels.slack.channels) — sleutels moeten kanaal-id’s zijn (C12345678), geen namen (#channel-name). Op naam gebaseerde sleutels falen stil ondergroupPolicy: "allowlist"omdat kanaalroutering standaard eerst op id gebeurt. Een id vinden: klik met de rechtermuisknop op het kanaal in Slack → Link kopiëren — deC...-waarde aan het einde van de URL is het kanaal-id. requireMention- allowlist voor
usersper kanaal
DM-berichten genegeerd
DM-berichten genegeerd
Controleer:
channels.slack.dm.enabledchannels.slack.dmPolicy(of verouderdchannels.slack.dm.policy)- koppelingsgoedkeuringen / allowlist-vermeldingen
- Slack Assistant-DM-gebeurtenissen: uitgebreide logs met
drop message_changedbetekenen meestal dat Slack een bewerkte Assistant-threadgebeurtenis heeft verzonden zonder een herstelbare menselijke afzender in berichtmetadata
Socket mode maakt geen verbinding
Socket mode maakt geen verbinding
Valideer bot- en app-tokens en inschakeling van Socket Mode in Slack-appinstellingen.Als
openclaw channels status --probe --json botTokenStatus of
appTokenStatus: "configured_unavailable" toont, is het Slack-account
geconfigureerd, maar kon de huidige runtime de door SecretRef ondersteunde
waarde niet oplossen.HTTP-modus ontvangt geen events
HTTP-modus ontvangt geen events
Valideer:
- ondertekeningsgeheim
- webhookpad
- Slack-aanvraag-URL’s (Events + Interactivity + Slash Commands)
- unieke
webhookPathper HTTP-account
signingSecretStatus: "configured_unavailable" verschijnt in account-
snapshots, is het HTTP-account geconfigureerd, maar kon de huidige runtime het
door SecretRef ondersteunde ondertekeningsgeheim niet vinden.Native/slash-commando's worden niet geactiveerd
Native/slash-commando's worden niet geactiveerd
Controleer of je het volgende bedoelde:
- native command-modus (
channels.slack.commands.native: true) met overeenkomende slash-commando’s geregistreerd in Slack - of single slash command-modus (
channels.slack.slashCommand.enabled: true)
commands.useAccessGroups en kanaal-/gebruikersallowlists.Referentie voor bijlagevision
Slack kan gedownloade media aan de agent-turn toevoegen wanneer Slack-bestandsdownloads slagen en de groottelimieten dit toestaan. Afbeeldingsbestanden kunnen via het pad voor mediabegrip worden doorgegeven of rechtstreeks aan een vision-capabel antwoordmodel; andere bestanden worden behouden als downloadbare bestandscontext in plaats van als afbeeldingsinvoer te worden behandeld.Ondersteunde mediatypen
| Mediatype | Bron | Huidig gedrag | Opmerkingen |
|---|---|---|---|
| JPEG / PNG / GIF / WebP-afbeeldingen | Slack-bestands-URL | Gedownload en aan de turn toegevoegd voor vision-capabele verwerking | Limiet per bestand: channels.slack.mediaMaxMb (standaard 20 MB) |
| PDF-bestanden | Slack-bestands-URL | Gedownload en beschikbaar gemaakt als bestandscontext voor tools zoals download-file of pdf | Inkomend Slack converteert PDF’s niet automatisch naar invoer voor afbeelding-vision |
| Andere bestanden | Slack-bestands-URL | Waar mogelijk gedownload en beschikbaar gemaakt als bestandscontext | Binaire bestanden worden niet als afbeeldingsinvoer behandeld |
| Thread-antwoorden | Bestanden van threadstarter | Bestanden van het rootbericht kunnen als context worden geladen wanneer het antwoord geen directe media heeft | Starters met alleen bestanden gebruiken een tijdelijke bijlageaanduiding |
| Berichten met meerdere afbeeldingen | Meerdere Slack-bestanden | Elk bestand wordt onafhankelijk beoordeeld | Slack-verwerking is beperkt tot acht bestanden per bericht |
Inkomende pipeline
Wanneer een Slack-bericht met bestandsbijlagen binnenkomt:- OpenClaw downloadt het bestand vanaf de privé-URL van Slack met de bot-token (
xoxb-...). - Bij succes wordt het bestand naar de mediaopslag geschreven.
- Gedownloade mediapaden en contenttypen worden aan de inkomende context toegevoegd.
- Model-/toolpaden die afbeeldingen ondersteunen, kunnen afbeeldingsbijlagen uit die context gebruiken.
- Niet-afbeeldingsbestanden blijven beschikbaar als bestandsmetadata of mediareferenties voor tools die ermee kunnen omgaan.
Overerving van bijlagen van thread-root
Wanneer een bericht binnenkomt in een thread (heeft eenthread_ts-ouder):
- Als het antwoord zelf geen directe media heeft en het opgenomen rootbericht bestanden heeft, kan Slack de rootbestanden als threadstarter-context laden.
- Directe antwoordbijlagen hebben voorrang op bijlagen van het rootbericht.
- Een rootbericht dat alleen bestanden en geen tekst heeft, wordt weergegeven met een tijdelijke bijlageaanduiding, zodat de fallback de bestanden nog steeds kan opnemen.
Verwerking 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 event-payload.
- Een fout bij het downloaden van één bijlage blokkeert 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 te worden gerapporteerd als niet-ondersteunde indelingen.
- Vision-model: afbeeldingsanalyse gebruikt het actieve antwoordmodel wanneer dit vision ondersteunt, of het afbeeldingsmodel dat is geconfigureerd op
agents.defaults.imageModel.
Bekende limieten
| Scenario | Huidig gedrag | Workaround |
|---|---|---|
| Verlopen Slack-bestands-URL | Bestand overgeslagen; geen fout weergegeven | Upload het bestand opnieuw in Slack |
| Vision-model niet geconfigureerd | Afbeeldingsbijlagen worden opgeslagen als mediareferenties, maar niet als afbeeldingen geanalyseerd | Configureer agents.defaults.imageModel of gebruik een vision-capabel antwoordmodel |
| Zeer grote afbeeldingen (> 20 MB standaard) | Overgeslagen volgens de groottelimiet | Verhoog channels.slack.mediaMaxMb als Slack dit toestaat |
| Doorgestuurde/gedeelde bijlagen | Tekst en door Slack gehoste afbeeldings-/bestandsmedia worden naar beste vermogen verwerkt | Deel opnieuw rechtstreeks in de OpenClaw-thread |
| PDF-bijlagen | Opgeslagen als bestands-/mediacontext, niet automatisch via afbeelding-vision gerouteerd | Gebruik download-file voor bestandsmetadata of de pdf-tool voor PDF-analyse |
Gerelateerde documentatie
- Pipeline voor mediabegrip
- PDF-tool
- Epic: #51349 — inschakeling van Slack-bijlagevision
- Regressietests: #51353
- Live-verificatie: #51354
Gerelateerd
Koppelen
Koppel een Slack-gebruiker aan de Gateway.
Groepen
Gedrag van kanalen en groeps-DM’s.
Kanaalroutering
Routeer inkomende berichten naar agents.
Beveiliging
Dreigingsmodel en verharding.
Configuratie
Config-indeling en prioriteit.
Slash-commando's
Commandocatalogus en gedrag.