Slack

Slack-Unterstützung umfasst Direktnachrichten und Kanäle über Slack-App-Integrationen. Der Standardtransport ist Socket Mode; HTTP Request URLs werden ebenfalls unterstützt. Der Relay-Modus ist für verwaltete Bereitstellungen vorgesehen, bei denen ein vertrauenswürdiger Router den Slack-Eingang verwaltet.

Transport auswählen

Socket Mode und HTTP Request URLs bieten Funktionsparität für Nachrichten, Slash-Befehle, App Home und Interaktionen. Treffen Sie die Wahl anhand der Bereitstellungsarchitektur, nicht anhand der Funktionen.

Relay-Modus

Der Relay-Modus trennt den Slack-Eingang vom OpenClaw-Gateway. Ein vertrauenswürdiger Router verwaltet die einzelne Slack-Socket-Mode-Verbindung, wählt ein Ziel-Gateway aus und leitet ein typisiertes Ereignis über einen authentifizierten WebSocket weiter. Das Gateway verwendet weiterhin sein eigenes Bot-Token für ausgehende Aufrufe der Slack Web API.

{  channels: {    slack: {      mode: "relay",      botToken: { source: "env", provider: "default", id: "SLACK_BOT_TOKEN" },      relay: {        url: "wss://router.example.com/gateway/ws",        authToken: { source: "env", provider: "default", id: "SLACK_RELAY_AUTH_TOKEN" },        gatewayId: "team-gateway",      },    },  },}

Die Relay-URL muss wss:// verwenden, sofern sie nicht auf localhost verweist. Behandeln Sie das Bearer-Token und die Routentabelle des Routers als Teil der Slack-Autorisierungsgrenze: Weitergeleitete Ereignisse gelangen als autorisierte Aktivierungen in den normalen Slack-Nachrichtenhandler. Ein vom Router bereitgestellter slack_identity im WebSocket-Frame hello kann den standardmäßigen ausgehenden Benutzernamen und das Symbol festlegen; eine explizit vom Aufrufer angegebene Identität hat weiterhin Vorrang. Die Relay-Verbindung wird mit demselben begrenzten Backoff-Timing wie Socket Mode erneut hergestellt und löscht die vom Router bereitgestellte Identität bei jeder Trennung.

Organisationsweite Enterprise-Grid-Installationen

Ein Slack-Konto kann Nachrichten aus jedem Workspace empfangen, der von einer organisationsweiten Enterprise-Grid-Installation abgedeckt wird. Wählen Sie den direkten Socket Mode oder HTTP Request URLs; der Relay-Modus wird für Enterprise-Konten nicht unterstützt. Beide nachstehenden Manifeste mit minimalen Berechtigungen aktivieren nur den V1-Ereignispfad message und app_mention, sofortige Antworten und vom Listener verwaltete Statusreaktionen.

Socket Mode

{  "display_information": {    "name": "OpenClaw",    "description": "Slack-Konnektor für OpenClaw"  },  "features": {    "bot_user": { "display_name": "OpenClaw", "always_online": true }  },  "oauth_config": {    "scopes": {      "bot": [        "app_mentions:read",        "channels:history",        "channels:read",        "chat:write",        "files:read",        "files:write",        "groups:history",        "groups:read",        "im:history",        "im:read",        "mpim:history",        "mpim:read",        "reactions:write",        "users:read"      ]    }  },  "settings": {    "org_deploy_enabled": true,    "socket_mode_enabled": true,    "event_subscriptions": {      "bot_events": [        "app_mention",        "message.channels",        "message.groups",        "message.im",        "message.mpim"      ]    }  }}

Lassen Sie die App von einem Enterprise Grid Org Admin oder Org Owner genehmigen, installieren Sie sie auf Organisationsebene und wählen Sie die Workspaces aus, die von der Installation abgedeckt werden. Vergewissern Sie sich vor dem Start von OpenClaw, dass die App in jedem vorgesehenen Workspace verfügbar ist. Generieren Sie für Socket Mode ein App-Level Token mit connections:write und kopieren Sie anschließend das Bot-Token aus der Organisationsinstallation. Konfigurieren Sie das Konto, das das organisationsweit installierte Bot-Token verwendet:

{  channels: {    slack: {      enabled: true,      mode: "socket",      enterpriseOrgInstall: true,      appToken: { source: "env", provider: "default", id: "SLACK_APP_TOKEN" },      botToken: { source: "env", provider: "default", id: "SLACK_BOT_TOKEN" },      dmPolicy: "open",      allowFrom: ["*"],      groupPolicy: "allowlist",      channels: {        C0123456789: { requireMention: true },      },    },  },}

HTTP Request URLs

Verwenden Sie den HTTP-Modus, wenn das Gateway über einen öffentlichen HTTPS-Endpunkt verfügt und keine Socket-Mode-Verbindung öffnet. Ersetzen Sie die Beispiel-URL durch die öffentliche webhookPath-URL des Gateways (Standard /slack/events):

{  "display_information": {    "name": "OpenClaw",    "description": "Slack-Konnektor für OpenClaw"  },  "features": {    "bot_user": { "display_name": "OpenClaw", "always_online": true }  },  "oauth_config": {    "scopes": {      "bot": [        "app_mentions:read",        "channels:history",        "channels:read",        "chat:write",        "files:read",        "files:write",        "groups:history",        "groups:read",        "im:history",        "im:read",        "mpim:history",        "mpim:read",        "reactions:write",        "users:read"      ]    }  },  "settings": {    "org_deploy_enabled": true,    "event_subscriptions": {      "request_url": "https://gateway-host.example.com/slack/events",      "bot_events": [        "app_mention",        "message.channels",        "message.groups",        "message.im",        "message.mpim"      ]    }  }}

Lassen Sie die App von einem Enterprise Grid Org Admin oder Org Owner genehmigen, installieren Sie sie auf Organisationsebene und wählen Sie die Workspaces aus, die von der Installation abgedeckt werden. Nachdem Slack die Request URL verifiziert hat, kopieren Sie das Bot-Token der Organisationsinstallation und das Basic Information -> App Credentials -> Signing Secret der App. Konfigurieren Sie das Enterprise-Konto mit demselben Request-URL-Pfad:

{  channels: {    slack: {      enabled: true,      mode: "http",      enterpriseOrgInstall: true,      botToken: { source: "env", provider: "default", id: "SLACK_BOT_TOKEN" },      signingSecret: {        source: "env",        provider: "default",        id: "SLACK_SIGNING_SECRET",      },      webhookPath: "/slack/events",      dmPolicy: "open",      allowFrom: ["*"],      groupPolicy: "allowlist",      channels: {        C0123456789: { requireMention: true },      },    },  },}

Beim Start verifiziert OpenClaw enterpriseOrgInstall mit Slack auth.test. Ein organisationsweit installiertes Token ohne das Flag oder ein Workspace-Token mit dem Flag führt zu einem fehlgeschlagenen Start. Slack bleibt die maßgebliche Quelle dafür, welche Workspaces die Installation genehmigt haben; OpenClaw wendet anschließend die konfigurierten Kanal-, Benutzer-, Direktnachrichten- und Erwähnungsrichtlinien auf jedes zugestellte Ereignis an. Enterprise V1 weist alle von Bots erzeugten Ereignisse message und app_mention vor der Weiterleitung zurück, unabhängig von allowBots, da organisationsweite Installationen keine stabile, Workspace-qualifizierte Bot-Identität zur Vermeidung von Schleifen bereitstellen.

Die Enterprise-Unterstützung ist bewusst auf direkten Socket Mode oder HTTP, die Ereignisse message und app_mention sowie deren sofortige Antworten beschränkt. Relay-Modus, Slash-Befehle, Interaktionen, App Home, Listener für Reaktionsereignisse, angeheftete Elemente, Slack-Aktionswerkzeuge, Slack-native Genehmigungen, Bindungen, Zustellung per Warteschlange oder Zeitplan und proaktives Senden sind für ein Enterprise-Konto nicht verfügbar. Ausgehende Bestätigungs-, Eingabe- und Statusreaktionen werden über den vom Listener verwalteten Slack-Client unterstützt und erfordern reactions:write; eingehende Reaktionsbenachrichtigungen und Reaktionsaktionswerkzeuge bleiben nicht verfügbar.

Sofortige Antworten verwenden das standardmäßige Slack-Zustellungsverhalten für Abschnitte, Medien, Metadaten, Identitäts-Fallback, Link-Vorschauen und Empfangsbestätigungen wieder, jedoch nur, solange der validierte, dem Listener zugeordnete Client im aktiven Ereignisdurchlauf verbleibt. Die In-Memory-Sendewarteschlange und die Datensätze zur Thread-Teilnahme werden nach dem Workspace dieses Ereignisses partitioniert; der Client selbst wird niemals serialisiert oder persistiert.

Kanalrichtlinienschlüssel und dm.groupChannels-Einträge müssen unverarbeitete, stabile Slack-Kanal-IDs oder die Form channel:<id> verwenden. OpenClaw normalisiert beide Formen für den Laufzeitabgleich zur unverarbeiteten Kanal-ID; die Präfixe slack:, group: und mpim: verhindern den Start. Benutzerrichtlinieneinträge müssen stabile Slack-Benutzer-IDs verwenden; Namen, Slugs, Anzeigenamen und E-Mail-Adressen verhindern den Start. IDs müssen das kanonische Slack-Präfix in Großbuchstaben und den kanonischen Hauptteil verwenden (zum Beispiel C0123456789 oder U0123456789); kleingeschriebene und verkürzte, ähnlich aussehende Varianten verhindern den Start. Enterprise-Konten können dangerouslyAllowNameMatching nicht aktivieren. Enterprise-Konten können das globale mentionPatterns.mode festlegen, aber mentionPatterns.allowIn und mentionPatterns.denyIn verhindern den Start, da einfache Slack-Kanal-IDs nicht durch einen Workspace qualifiziert sind und in mehreren Workspaces wiederverwendet werden können. Workspace-Installationen behalten das bestehende bereichsbezogene Verhalten für Erwähnungsmuster bei. Jeder akzeptierte Workspace erhält eine separate Identität für Routing, Sitzung, Transkript, Deduplizierung, Verlauf und Cache, selbst wenn sich Slack-IDs überschneiden. Innerhalb des message-Streams werden gewöhnliche Benutzernachrichten und von Benutzern verfasste file_share-Ereignisse unterstützt; andere Nachrichtenuntertypen werden vor der Autorisierung oder der Verarbeitung von Systemereignissen abgelehnt.

Enterprise-Direktnachrichten müssen entweder deaktiviert sein (dm.enabled=false oder dmPolicy="disabled") oder mit dmPolicy="open" ausdrücklich geöffnet werden und eine wirksame Konto-allowFrom enthalten, die das Literal "*" umfasst. Eine leere Zulassungsliste oder benutzerspezifische IDs ohne "*" verhindern den Start. Kopplung und benutzerspezifische Zulassungslisten für Direktnachrichten werden abgelehnt, da Slack-Benutzer-IDs in diesen Autorisierungsspeichern nicht durch einen Workspace qualifiziert sind. Die Richtlinien für Kanäle und Absender gelten weiterhin für Kanalnachrichten.

Installation

openclaw plugins install @openclaw/slack

plugins install registriert und aktiviert das Plugin. Es bewirkt nichts, bis Sie die Slack-App und die nachfolgenden Kanaleinstellungen konfigurieren. Allgemeine Regeln zur Plugin-Installation finden Sie unter Plugins.

Schnelleinrichtung

Die Manifeste in diesem Abschnitt erstellen eine Workspace-bezogene Installation. Verwenden Sie für eine organisationsweite Installation in einer Enterprise-Grid-Organisation stattdessen das dedizierte organisationsweite Manifest und den entsprechenden Ablauf.

{"display_information": {"name": "OpenClaw","description": "Slack-Konnektor für 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},"agent_view": {"agent_description": "OpenClaw verbindet Unterhaltungen in der Slack-Agentenansicht mit OpenClaw-Agenten.","suggested_prompts": [{ "title": "Was können Sie tun?", "message": "Wobei können Sie mir helfen?" },{"title": "Diesen Kanal zusammenfassen","message": "Fassen Sie die jüngsten Aktivitäten in diesem Kanal zusammen."},{ "title": "Antwort entwerfen", "message": "Helfen Sie mir, eine Antwort zu entwerfen." }]},"slash_commands": [{"command": "/openclaw","description": "Eine Nachricht an OpenClaw senden","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","app_context_changed","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-Konnektor für 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},"agent_view": {"agent_description": "OpenClaw verbindet Unterhaltungen in der Slack-Agentenansicht mit OpenClaw-Agenten.","suggested_prompts": [{ "title": "Was können Sie tun?", "message": "Wobei können Sie mir helfen?" },{"title": "Diesen Kanal zusammenfassen","message": "Fassen Sie die jüngsten Aktivitäten in diesem Kanal zusammen."},{ "title": "Antwort entwerfen", "message": "Helfen Sie mir, eine Antwort zu entwerfen." }]},"slash_commands": [{"command": "/openclaw","description": "Eine Nachricht an OpenClaw senden","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","app_context_changed","message.channels","message.groups","message.im"]}}}

export SLACK_APP_TOKEN=slack-app-token-exampleexport SLACK_BOT_TOKEN=slack-bot-token-examplecat > 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" },},},}JSON5openclaw config patch --file ./slack.socket.patch.json5 --dry-runopenclaw config patch --file ./slack.socket.patch.json5

SLACK_APP_TOKEN=slack-app-token-exampleSLACK_BOT_TOKEN=slack-bot-token-example

openclaw gateway

{"display_information": {"name": "OpenClaw","description": "Slack-Konnektor für 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},"agent_view": {"agent_description": "OpenClaw verbindet Unterhaltungen in der Slack-Agentenansicht mit OpenClaw-Agenten.","suggested_prompts": [{ "title": "Was können Sie tun?", "message": "Wobei können Sie mir helfen?" },{"title": "Diesen Kanal zusammenfassen","message": "Fassen Sie die jüngsten Aktivitäten in diesem Kanal zusammen."},{ "title": "Antwort entwerfen", "message": "Helfen Sie mir, eine Antwort zu entwerfen." }]},"slash_commands": [{"command": "/openclaw","description": "Eine Nachricht an OpenClaw senden","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","app_context_changed","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 für 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},"agent_view": {"agent_description": "OpenClaw verbindet Unterhaltungen in der Slack Agent View mit OpenClaw-Agenten.","suggested_prompts": [{ "title": "Was können Sie tun?", "message": "Wobei können Sie mir helfen?" },{"title": "Diesen Channel zusammenfassen","message": "Fassen Sie die letzten Aktivitäten in diesem Channel zusammen."},{ "title": "Antwort entwerfen", "message": "Helfen Sie mir, eine Antwort zu entwerfen." }]},"slash_commands": [{"command": "/openclaw","description": "Eine Nachricht an OpenClaw senden","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","app_context_changed","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=slack-bot-token-exampleexport 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",},},}JSON5openclaw config patch --file ./slack.http.patch.json5 --dry-runopenclaw config patch --file ./slack.http.patch.json5

openclaw gateway

Benutzeridentität (als reale Person posten)

Mit der Benutzeridentität kann OpenClaw als die Person lesen und posten, die die Slack-App autorisiert. userToken ist die handelnde Identität; eine zugehörige Slack-App überträgt den Datenverkehr der Events API über Socket Mode oder eine HTTP Request URL. Die zugehörige App benötigt weder einen Bot-Benutzer noch ein Bot-Token.

Richten Sie die zugehörige App wie folgt ein:

1. Fügen Sie unter OAuth & Permissions -> User Token Scopes diese benutzerbezogenen Berechtigungen hinzu:

   • Verlauf: channels:history, groups:history, im:history, mpim:history
   • Unterhaltungssuche: channels:read, groups:read, im:read, mpim:read
   • Personen: users:read
   • Posten: chat:write (Nachrichten werden als der autorisierende Benutzer gepostet)
   • DMs öffnen: im:write, mpim:write

2. Fügen Sie unter Event Subscriptions -> Subscribe to events on behalf of users diese Benutzerereignisse hinzu. Fügen Sie sie nicht ausschließlich der Liste der Bot-Ereignisse hinzu:

   • message.channels
   • message.groups
   • message.im
   • message.mpim

3. Wählen Sie eine Ereignisübertragung:

   • Socket Mode: Aktivieren Sie Socket Mode und erstellen Sie ein Token auf App-Ebene mit connections:write. Konfigurieren Sie es als appToken.
   • HTTP Request URL: Richten Sie Event Subscriptions auf den öffentlichen Slack-Endpunkt von OpenClaw und kopieren Sie Basic Information -> App Credentials -> Signing Secret. Konfigurieren Sie es als signingSecret.

4. Installieren oder installieren Sie die App erneut, autorisieren Sie sie als die vorgesehene Person und kopieren Sie das resultierende Benutzer-OAuth-Token nach userToken.

Socket-Mode-Konfiguration:

{  channels: {    slack: {      identity: "user",      userToken: "<xoxp>",      appToken: "<xapp>",    },  },}

Konfiguration der HTTP Request URL:

{  channels: {    slack: {      identity: "user",      mode: "http",      userToken: "<xoxp>",      signingSecret: "<signing-secret>",      webhookPath: "/slack/events",    },  },}

OpenClaw verwirft automatisch benutzerbezogene Nachrichtenereignisse, die von der ermittelten menschlichen Identität stammen, sodass gesendete Nachrichten keine Antworten an sich selbst auslösen.

Transportoptimierung für Socket Mode

OpenClaw setzt das Pong-Timeout des Slack-SDK-Clients für Socket Mode standardmäßig auf 15 Sekunden. Überschreiben Sie die Transporteinstellungen nur, wenn eine Workspace- oder hostspezifische Optimierung erforderlich ist:

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

Verwenden Sie dies nur für Socket-Mode-Workspaces, die Zeitüberschreitungen bei Slack-WebSocket-Pongs oder Server-Pings protokollieren, oder auf Hosts mit bekannter Überlastung der Ereignisschleife ausgeführt werden. clientPingTimeout ist die Wartezeit auf das Pong, nachdem das SDK einen Client-Ping gesendet hat; serverPingTimeout ist die Wartezeit auf Server-Pings von Slack. App-Nachrichten und Ereignisse bleiben Anwendungszustand und sind keine Signale für die Funktionsfähigkeit des Transports.

Hinweise:

• socketMode wird im HTTP-Request-URL-Modus ignoriert.
• Die grundlegenden channels.slack.socketMode-Einstellungen gelten für alle Slack-Konten, sofern sie nicht überschrieben werden. Kontospezifische Überschreibungen verwenden channels.slack.accounts.<accountId>.socketMode; da es sich um eine Objektüberschreibung handelt, müssen Sie alle Socket-Optimierungsfelder angeben, die für dieses Konto gelten sollen.
• Nur clientPingTimeout besitzt einen OpenClaw-Standardwert (15000). serverPingTimeout und pingPongLoggingEnabled werden nur dann an das Slack-SDK übergeben, wenn sie konfiguriert sind.
• Die Wiederholungsverzögerung beim Neustart von Socket Mode beginnt bei etwa 2 Sekunden und ist auf etwa 30 Sekunden begrenzt. Behebbare Fehler beim Start, beim Warten auf den Start und bei Verbindungsabbrüchen werden wiederholt, bis der Channel beendet wird. Dauerhafte Konto- und Anmeldedatenfehler wie ungültige Authentifizierung, widerrufene Tokens oder fehlende Berechtigungsbereiche schlagen schnell fehl, statt unbegrenzt erneut versucht zu werden.

Checkliste für Manifest und Berechtigungsbereiche

Das grundlegende Slack-App-Manifest ist für Socket Mode und HTTP Request URLs identisch. Nur der settings-Block (und der url des Slash-Befehls) unterscheidet sich.

Grundlegendes Manifest (Standard für Socket Mode):

{  "display_information": {    "name": "OpenClaw",    "description": "Slack-Connector für 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    },    "agent_view": {      "agent_description": "OpenClaw verbindet Unterhaltungen in der Slack Agent View mit OpenClaw-Agenten.",      "suggested_prompts": [        { "title": "Was können Sie tun?", "message": "Wobei können Sie mir helfen?" },        {          "title": "Diesen Channel zusammenfassen",          "message": "Fassen Sie die letzten Aktivitäten in diesem Channel zusammen."        },        { "title": "Antwort entwerfen", "message": "Helfen Sie mir, eine Antwort zu entwerfen." }      ]    },    "slash_commands": [      {        "command": "/openclaw",        "description": "Eine Nachricht an OpenClaw senden",        "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",        "app_context_changed",        "channel_rename",        "member_joined_channel",        "member_left_channel",        "message.channels",        "message.groups",        "message.im",        "message.mpim",        "pin_added",        "pin_removed",        "reaction_added",        "reaction_removed"      ]    }  }}

Ersetzen Sie für den HTTP-Request-URL-Modus settings durch die HTTP-Variante und fügen Sie jedem Slash-Befehl url hinzu. Eine öffentliche URL ist erforderlich:

{  "features": {    "slash_commands": [      {        "command": "/openclaw",        "description": "Eine Nachricht an OpenClaw senden",        "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",        "app_context_changed",        "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"    }  }}

Zusätzliche Manifest-Einstellungen

Stellen Sie verschiedene Funktionen bereit, die die obigen Standardeinstellungen erweitern.

Das Standardmanifest aktiviert den Tab Home in der Slack App Home und abonniert app_home_opened. Wenn ein Workspace-Mitglied den Tab Home öffnet, veröffentlicht OpenClaw eine sichere Standardansicht für Home mit views.publish; sie enthält weder Konversationsdaten noch private Konfiguration. Wenn der Modus für einen einzelnen Slash-Befehl aktiviert ist, verwendet der Befehlshinweis channels.slack.slashCommand.name; Installationen mit nativen Befehlen oder ohne Slash-Befehle lassen diesen Hinweis weg. Der Tab Messages bleibt für Slack-DMs aktiviert. Neue Apps verwenden Slack Agent View über features.agent_view, assistant:write und app_context_changed. Jeder sichtbare Agent-View-Stamm wird an eine eigene OpenClaw-Thread-Sitzung weitergeleitet, und die geordneten aktiven Ansichts-Entitäten von Slack erreichen den Agenten ausschließlich als nicht vertrauenswürdiger Kontext.

Bestehende Apps, die bereits features.assistant_view verwenden, können ihr aktuelles Manifest beibehalten. OpenClaw verarbeitet für diese Installationen weiterhin assistant_thread_started und assistant_thread_context_changed. Slack macht die Migration von Assistant View zu Agent View unumkehrbar und verlangt anschließend eine vollständige Aktualisierung durch die Benutzer. Ersetzen Sie daher assistant_view in einer bestehenden App erst, wenn Sie den gesamten Workspace migrieren möchten.

{"slash_commands": [{"command": "/new","description": "Neue Sitzung starten","usage_hint": "[model]"},{"command": "/reset","description": "Aktuelle Sitzung zurücksetzen"},{"command": "/compact","description": "Sitzungskontext komprimieren","usage_hint": "[instructions]"},{"command": "/stop","description": "Aktuellen Lauf stoppen"},{"command": "/session","description": "Ablauf der Thread-Bindung verwalten","usage_hint": "inaktiv <duration|off> oder maximales Alter <duration|off>"},{"command": "/think","description": "Denkstufe festlegen","usage_hint": "<level>"},{"command": "/verbose","description": "Ausführliche Ausgabe umschalten","usage_hint": "on|off|full"},{"command": "/fast","description": "Schnellmodus anzeigen oder festlegen","usage_hint": "[status|on|off]"},{"command": "/reasoning","description": "Sichtbarkeit der Schlussfolgerungen umschalten","usage_hint": "[on|off|stream]"},{"command": "/elevated","description": "Erweiterten Modus umschalten","usage_hint": "[on|off|ask|full]"},{"command": "/exec","description": "Exec-Standardwerte anzeigen oder festlegen","usage_hint": "host=<auto|sandbox|gateway|node> security=<deny|allowlist|full> ask=<off|on-miss|always> node=<id>"},{"command": "/approve","description": "Ausstehende Genehmigungsanfragen genehmigen oder ablehnen","usage_hint": "<id> <decision>"},{"command": "/model","description": "Modell anzeigen oder festlegen","usage_hint": "[name|#|status]"},{"command": "/models","description": "Provider/Modelle auflisten","usage_hint": "[provider] [page] [limit=<n>|size=<n>|all]"},{"command": "/help","description": "Kurze Hilfeübersicht anzeigen"},{"command": "/commands","description": "Generierten Befehlskatalog anzeigen"},{"command": "/tools","description": "Anzeigen, was der aktuelle Agent derzeit verwenden kann","usage_hint": "[compact|verbose]"},{"command": "/agentstatus","description": "Laufzeitstatus einschließlich Provider-Nutzung/Kontingent anzeigen, sofern verfügbar"},{"command": "/tasks","description": "Aktive/kürzlich ausgeführte Hintergrundaufgaben der aktuellen Sitzung auflisten"},{"command": "/context","description": "Erläutern, wie der Kontext zusammengestellt wird","usage_hint": "[list|detail|json]"},{"command": "/whoami","description": "Ihre Absenderidentität anzeigen"},{"command": "/skill","description": "Skill anhand des Namens ausführen","usage_hint": "<name> [input]"},{"command": "/btw","description": "Nebenfrage stellen, ohne den Sitzungskontext zu ändern","usage_hint": "<question>"},{"command": "/login","description": "Codex-Anmeldung koppeln","usage_hint": "[codex|openai]"},{"command": "/usage","description": "Nutzungsfußzeile steuern oder Kostenzusammenfassung anzeigen","usage_hint": "off|tokens|full|cost"}]}

{"slash_commands": [{"command": "/new","description": "Neue Sitzung starten","usage_hint": "[model]","url": "https://gateway-host.example.com/slack/events"},{"command": "/help","description": "Kurze Hilfeübersicht anzeigen","url": "https://gateway-host.example.com/slack/events"}]}

Token-Modell

• Die Bot-Identität (Standard) erfordert botToken + appToken für Socket Mode oder botToken + signingSecret für den HTTP-Modus.
• Die Benutzeridentität erfordert userToken + appToken für Socket Mode oder userToken + signingSecret für den HTTP-Modus. Sie verwendet kein Bot-Token.
• Der Relay-Modus erfordert botToken sowie relay.url, relay.authToken und relay.gatewayId; er verwendet weder ein App-Token noch ein Signaturgeheimnis.
• botToken, appToken, signingSecret, relay.authToken und userToken akzeptieren Klartext- Zeichenfolgen oder SecretRef-Objekte.
• Konfigurations-Token überschreiben den Fallback auf Umgebungsvariablen.
• Der Fallback über die Umgebungsvariablen SLACK_BOT_TOKEN, SLACK_APP_TOKEN und SLACK_USER_TOKEN gilt jeweils nur für das Standardkonto.
• userToken verwendet standardmäßig schreibgeschütztes Verhalten (userTokenReadOnly: true).

Verhalten der Statusmomentaufnahme:

• Die Slack-Kontoprüfung verfolgt für jede Anmeldeinformation die Felder *Source und *Status (botToken, appToken, signingSecret, userToken).
• Der Status lautet available, configured_unavailable oder missing.
• configured_unavailable bedeutet, dass das Konto über SecretRef oder eine andere nicht eingebettete Quelle für Geheimnisse konfiguriert ist, der aktuelle Befehls-/Laufzeitpfad den tatsächlichen Wert jedoch nicht auflösen konnte.
• Im HTTP-Modus ist signingSecretStatus enthalten. Socket Mode verwendet botTokenStatus + appTokenStatus für die Bot-Identität und userTokenStatus + appTokenStatus für die Benutzeridentität.

Aktionen und Sperren

Slack-Aktionen werden durch channels.slack.actions.* gesteuert.

Verfügbare Aktionsgruppen in den aktuellen Slack-Werkzeugen:

Die aktuellen Slack-Nachrichtenaktionen umfassen send, upload-file, download-file, read, edit, delete, pin, unpin, list-pins, member-info und emoji-list. download-file akzeptiert Slack-Datei-IDs, die in Platzhaltern für eingehende Dateien angezeigt werden, und gibt für Bilder eine Bildvorschau oder für andere Dateitypen lokale Dateimetadaten zurück.

Zugriffssteuerung und Routing

Threads, Sitzungen und Antwort-Tags

• DMs werden als direct, Kanäle als channel und MPIMs als group weitergeleitet.
• Slack-Routenbindungen akzeptieren unverarbeitete Peer-IDs sowie Slack-Zielformen wie channel:C12345678, user:U12345678 und <@U12345678>.
• Mit dem Standardwert session.dmScope=main werden gewöhnliche Slack-DMs in der Hauptsitzung des Agenten zusammengeführt. Wurzeln der Agent View und vorhandene Threads der Assistant View bleiben als :thread:<threadTs>-Sitzungen isoliert.
• Kanalsitzungen: agent:<agentId>:slack:channel:<channelId>.
• Gewöhnliche Kanalnachrichten auf oberster Ebene verbleiben in der kanalspezifischen Sitzung, auch wenn replyToMode nicht off ist.
• Antworten in Threads von Slack-Kanälen, MPIMs, Agent View und Assistant View verwenden die übergeordnete Slack-thread_ts für Sitzungssuffixe (:thread:<threadTs>). Gewöhnliche DM-Antwort-Threads bleiben eine UI-Funktion der zugrunde liegenden DM-Sitzung.
• OpenClaw übernimmt eine geeignete Kanalwurzel auf oberster Ebene in agent:<agentId>:slack:channel:<channelId>:thread:<rootTs>, wenn von dieser Wurzel erwartet wird, dass sie einen sichtbaren Slack-Thread beginnt, sodass die Wurzel und spätere Thread-Antworten dieselbe OpenClaw-Sitzung verwenden. Dies gilt für app_mention-Ereignisse, Übereinstimmungen mit expliziten Bot-Erwähnungen oder konfigurierten Erwähnungsmustern sowie für requireMention: false-Kanäle mit einem replyToMode, das nicht off ist.
• Der Standardwert von channels.slack.thread.historyScope ist thread; der Standardwert von thread.inheritParent ist false.
• channels.slack.thread.initialHistoryLimit steuert, wie viele vorhandene Thread-Nachrichten beim Start einer neuen Thread-Sitzung abgerufen werden (Standardwert 20; zum Deaktivieren auf 0 setzen).
• channels.slack.implicitMentions.replyToBot steuert, ob eine Antwort auf die eigene Nachricht des Bots die Erwähnungsanforderung umgeht (Standardwert true).
• channels.slack.implicitMentions.threadParticipation steuert, ob Folgenachrichten in einem Thread, in dem der Bot geantwortet hat, die Erwähnungsanforderung umgehen (Standardwert true). Setzen Sie den Wert auf false, um in diesen Folgenachrichten eine neue explizite Erwähnung zu verlangen. openclaw doctor --fix migriert den früheren Schlüssel channels.slack.thread.requireExplicitMention zu diesem positiven kanonischen Flag.
• Kontospezifische Überschreibungen befinden sich unter channels.slack.accounts.<id>.implicitMentions; gemeinsame Standardwerte unter channels.defaults.implicitMentions.

Steuerelemente für Antwort-Threads:

• channels.slack.channels.<id>.replyToMode: kanalspezifische Überschreibung für Nachrichten in Slack-Kanälen und privaten Kanälen
• channels.slack.replyToMode: off|first|all|batched (Standardwert off)
• channels.slack.replyToModeByChatType: pro direct|group|channel
• alte Ausweichoption für direkte Chats: channels.slack.dm.replyToMode

Manuelle Antwort-Tags werden unterstützt:

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

Für explizite Slack-Thread-Antworten aus dem Tool message setzen Sie replyBroadcast: true zusammen mit action: "send" und threadId oder replyTo, damit Slack die Thread-Antwort zusätzlich im übergeordneten Kanal veröffentlicht. Dies entspricht Slacks Flag reply_broadcast von chat.postMessage und wird nur für Text- oder Block-Kit-Sendungen unterstützt, nicht für Medien-Uploads.

Wenn ein Aufruf des Tools message innerhalb eines Slack-Threads ausgeführt wird und denselben Kanal als Ziel hat, übernimmt OpenClaw normalerweise den aktuellen Slack-Thread gemäß dem effektiven replyToMode des Kontos, Chat-Typs oder Kanals. Automatische Antworten und Aufrufe von send oder upload-file im selben Kanal verwenden dieselbe kanalspezifische Überschreibung. Setzen Sie topLevel: true für action: "send" oder action: "upload-file", um stattdessen eine neue Nachricht im übergeordneten Kanal zu erzwingen. threadId: null wird als gleichwertige Deaktivierung auf oberster Ebene akzeptiert.

Bestätigungsreaktionen

ackReaction sendet ein Bestätigungs-Emoji, während OpenClaw eine eingehende Nachricht verarbeitet. ackReactionScope bestimmt, wann dieses Emoji tatsächlich gesendet wird.

Standardmäßig bleibt die Bestätigung unverändert, während der native Agenten-/Assistenten-Thread-Status von Slack den Fortschritt mit wechselnden Lademeldungen anzeigt. Setzen Sie messages.statusReactions.enabled: true, um stattdessen den Reaktionslebenszyklus für Warteschlange/Denken/Tool/Abschluss/Fehler zu aktivieren.

Emoji (ackReaction)

Auflösungsreihenfolge:

• channels.slack.accounts.<accountId>.ackReaction
• channels.slack.ackReaction
• messages.ackReaction
• ersatzweise das Emoji der Agentenidentität (agents.entries.*.identity.emoji, andernfalls "eyes" / 👀)

Hinweise:

• Slack erwartet Kurzcodes (beispielsweise "eyes").
• Verwenden Sie "", um die Reaktion für das Slack-Konto oder global zu deaktivieren.

Geltungsbereich (messages.ackReactionScope)

Der Slack-Provider liest den Geltungsbereich aus messages.ackReactionScope (Standardwert "group-mentions"). Derzeit gibt es keine Überschreibung auf Slack-Konto- oder Slack-Kanalebene; der Wert gilt global für das Gateway.

Werte:

• "all": in DMs und Gruppen reagieren, einschließlich beiläufiger Raumereignisse.
• "direct": nur in DMs reagieren.
• "group-all": auf jede Gruppennachricht außer beiläufigen Raumereignissen reagieren (keine DMs).
• "group-mentions" (Standardwert): in Gruppen reagieren, jedoch nur, wenn der Bot erwähnt wird (oder bei erwähnbaren Gruppen, für die dies aktiviert wurde). DMs sind ausgeschlossen.
• "off" / "none": niemals reagieren.

{  messages: {    ackReaction: "eyes",    ackReactionScope: "all", // in DMs und Gruppen reagieren  },}

Text-Streaming

channels.slack.streaming steuert das Verhalten der Live-Vorschau:

• off: Streaming der Live-Vorschau deaktivieren.
• partial (Standardwert): Vorschautext durch die neueste Teilausgabe ersetzen.
• block: gestückelte Vorschauaktualisierungen anhängen.
• progress: während der Generierung einen Fortschrittsstatustext anzeigen und anschließend den endgültigen Text senden.
• streaming.preview.toolProgress: Bei aktiver Entwurfsvorschau werden Tool- und Fortschrittsaktualisierungen in dieselbe bearbeitete Vorschaunachricht geleitet (Standardwert: true). Setzen Sie false, um separate Tool- und Fortschrittsnachrichten beizubehalten.
• streaming.preview.commandText / streaming.progress.commandText: auf status setzen, um kompakte Tool-Fortschrittszeilen beizubehalten und gleichzeitig unverarbeiteten Befehls-/Ausführungstext auszublenden (Standardwert: raw).

Unverarbeiteten Befehls-/Ausführungstext ausblenden und kompakte Fortschrittszeilen beibehalten:

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

channels.slack.streaming.nativeTransport steuert das native Slack-Text-Streaming, wenn channels.slack.streaming.mode den Wert partial hat (Standardwert: true).

Native Slack-Fortschrittsaufgabenkarten müssen für den Fortschrittsmodus ausdrücklich aktiviert werden. Setzen Sie channels.slack.streaming.progress.nativeTaskCards zusammen mit channels.slack.streaming.mode="progress" auf true, um während der Ausführung eine native Slack-Plan-/Aufgabenkarte zu senden und dieselbe Aufgabenkarte nach Abschluss zu aktualisieren. Ohne dieses Flag behält der Fortschrittsmodus das portable Verhalten der Entwurfsvorschau bei.

• Ein Antwort-Thread muss verfügbar sein, damit natives Text-Streaming und der Slack-Assistenten-Thread-Status angezeigt werden können. Die Thread-Auswahl folgt weiterhin replyToMode.
• Kanal-, Gruppenchat- und übergeordnete DM-Stammnachrichten können weiterhin die normale Entwurfsvorschau verwenden, wenn natives Streaming nicht verfügbar ist oder kein Antwort-Thread vorhanden ist.
• Übergeordnete Slack-DMs bleiben standardmäßig außerhalb von Threads und zeigen daher nicht die Thread-artige native Streaming-/Statusvorschau von Slack an; OpenClaw veröffentlicht und bearbeitet stattdessen eine Entwurfsvorschau in der DM.
• Medien und Nicht-Text-Nutzdaten greifen auf die normale Zustellung zurück.
• Abschließende Medien-/Fehlerausgaben brechen ausstehende Vorschauänderungen ab; geeignete abschließende Text-/Blockausgaben werden nur übertragen, wenn sie die Vorschau direkt bearbeiten können.
• Wenn das Streaming während einer Antwort fehlschlägt, greift OpenClaw für die verbleibenden Nutzdaten auf die normale Zustellung zurück.

Entwurfsvorschau anstelle des nativen Slack-Text-Streamings verwenden:

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

Native Slack-Fortschrittsaufgabenkarten aktivieren:

{  channels: {    slack: {      streaming: {        mode: "progress",        progress: {          nativeTaskCards: true,          render: "rich",        },      },    },  },}

Veraltete Schlüssel:

• channels.slack.streamMode (replace | status_final | append) ist ein veralteter Alias für channels.slack.streaming.mode.
• Der boolesche Wert channels.slack.streaming ist ein veralteter Alias für channels.slack.streaming.mode und channels.slack.streaming.nativeTransport.
• Die übergeordneten Werte channels.slack.chunkMode und channels.slack.nativeStreaming sind veraltete Aliasse für channels.slack.streaming.chunkMode und channels.slack.streaming.nativeTransport.
• Veraltete Aliasse werden zur Laufzeit nicht gelesen; führen Sie openclaw doctor --fix aus, um die persistierte Slack-Streaming-Konfiguration mit den kanonischen Schlüsseln neu zu schreiben.

Ausweichlösung mit Eingabe-Reaktion

typingReaction fügt der eingehenden Slack-Nachricht vorübergehend eine Reaktion hinzu, während OpenClaw eine Antwort verarbeitet, und entfernt sie nach Abschluss des Laufs. Dies ist vor allem außerhalb von Thread-Antworten nützlich, die standardmäßig eine Statusanzeige „tippt gerade ...“ verwenden.

Auflösungsreihenfolge:

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

Hinweise:

• Slack erwartet Shortcodes (zum Beispiel "hourglass_flowing_sand").
• Die Reaktion erfolgt nach Möglichkeit, und nach Abschluss des Antwort- oder Fehlerpfads wird automatisch versucht, sie zu entfernen.

Spracheingabe

Um derzeit in Slack mit OpenClaw zu sprechen, senden Sie einen Slack-Audioclip an die OpenClaw-App. Das Diktiermikrofon von Slackbot ist eine separate, Slack-eigene Funktion und keine App-API.

• Slackbot-Sprachdiktat befindet sich in der privaten Slackbot-Unterhaltung der Person. Slack wandelt die Aufnahme in einen Slackbot-Prompt um, stellt Drittanbieter-Slack-Apps jedoch über die Events API weder eine Audiodatei noch ein Diktatereignis, einen Prompt oder eine Markierung der Eingabequelle bereit. Das OpenClaw-Slack-Plugin kann diese Funktion weder aktivieren noch empfangen.
• Slack-Audio-Clips sind gespeicherte Slack-Dateien, die in einer OpenClaw-DM, einem Kanal oder einem Thread veröffentlicht werden können. OpenClaw lädt einen zugänglichen Clip mit dem Bot-Token herunter, normalisiert die MIME-Metadaten des Slack-Clips und leitet ihn durch die gemeinsame Audiotranskriptions-Pipeline. Das empfohlene App-Manifest enthält den erforderlichen Bereich files:read.

Audioclips und Slackbot-Diktate haben unterschiedliche Datenschutzmerkmale: Clips unterliegen der Slack-Richtlinie zur Dateiaufbewahrung und werden von OpenClaw zur Transkription heruntergeladen, während Slack angibt, dass Diktataudio nicht gespeichert wird.

In einem Kanal mit requireMention: true kann ein Audioclip ohne Beschriftung die Bedingung erfüllen, indem ein konfiguriertes Erwähnungsmuster ausgesprochen wird (agents.entries.*.groupChat.mentionPatterns, mit Rückgriff auf messages.groupChat.mentionPatterns). OpenClaw autorisiert den Absender, bevor der Clip heruntergeladen oder transkribiert wird, und lässt ihn nur zu, wenn das Transkript übereinstimmt. Ein fehlgeschlagenes oder nicht übereinstimmendes spekulatives Transkript wird zusammen mit dem heruntergeladenen Clip verworfen; es wird nicht im Kanalverlauf aufbewahrt. Die native Slack-Identität @bot kann nicht aus Sprache abgeleitet werden. Konfigurieren Sie daher ein gesprochenes Namensmuster oder fügen Sie eine eingegebene Erwähnung hinzu. Wenn die Transkriptwiedergabe aktiviert ist, wird sie erst nach der Zulassung gesendet.

Medien, Aufteilung und Zustellung

Befehle und Slash-Verhalten

Slash-Befehle werden in Slack entweder als einzelner konfigurierter Befehl oder als mehrere native Befehle angezeigt. Konfigurieren Sie channels.slack.slashCommand, um die Befehlsstandardwerte zu ändern:

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

/openclaw /help

Native Befehle erfordern zusätzliche Manifest-Einstellungen in Ihrer Slack-App und werden stattdessen mit channels.slack.commands.native: true oder commands.native: true in globalen Konfigurationen aktiviert.

• Der automatische Modus für native Befehle ist für Slack deaktiviert, sodass commands.native: "auto" keine nativen Slack-Befehle aktiviert.

/help

Native Argumentmenüs werden in der folgenden Prioritätsreihenfolge dargestellt:

• 3-5 ausreichend kurze Optionen: ein Überlaufmenü („...“)
• mehr als 100 Optionen bei verfügbarer asynchroner Optionsfilterung: externe Auswahl
• 1-2 Optionen oder eine Option, deren codierter Wert für eine Auswahl zu lang ist: Schaltflächenblöcke
• andernfalls (6-100 Optionen oder mehr als 100 ohne asynchrone Filterung): statisches Auswahlmenü, aufgeteilt in jeweils 100 Optionen pro Menü

/think

Slash-Sitzungen verwenden isolierte Schlüssel wie agent:<agentId>:slack:slash:<userId> und leiten Befehlsausführungen über CommandTargetSessionKey weiterhin an die Sitzung der Zielunterhaltung weiter.

Native Diagramme

Der öffentliche data_visualization-Block von Block Kit von Slack stellt Linien-, Balken-, Flächen- und Kreisdiagramme in Nachrichten dar. OpenClaw ordnet den portablen presentation-Block chart dieser nativen Form zu; zusätzlich zum normalen Nachrichtenzugriff chat:write sind weder ein zusätzlicher OAuth-Bereich noch ein Datei-Upload, Bildrenderer oder eine Slack-Konfiguration erforderlich.

{  "blocks": [    {      "type": "chart",      "chartType": "bar",      "title": "Quartalsumsatz",      "categories": ["Q1", "Q2"],      "series": [{ "name": "Umsatz", "values": [120, 145] }],      "xLabel": "Quartal"    }  ]}

Die Slack-Beschränkungen werden vor der nativen Darstellung durchgesetzt:

• Titel und optionale Achsenbeschriftungen: 50 Zeichen
• Kreisdiagramm: 1-12 positive Segmente
• Linien-/Balken-/Flächendiagramm: 1-12 eindeutig benannte Datenreihen und 1-20 gemeinsame Kategorien
• Segment-, Kategorie- und Datenreihenbeschriftungen: 20 Zeichen
• Jede Datenreihe muss für jede Kategorie einen endlichen Wert enthalten; Werte außerhalb von Kreisdiagrammen dürfen negativ sein

Jedes native Diagramm enthält außerdem eine übergeordnete Textdarstellung für Screenreader, Benachrichtigungen, die Sitzungsspiegelung und Clients, die den Block nicht darstellen können. Bei standardmäßigen Präsentationsübertragungen an andere OpenClaw-Kanäle werden dieselben deterministischen Diagrammdaten als Text gesendet, sofern diese keine native Diagrammunterstützung ausweisen. Wenn Slack das Diagramm während einer schrittweisen Einführung mit invalid_blocks ablehnt, entfernt OpenClaw die abgelehnten nativen Datenblöcke, behält vorhandene gleichgeordnete Steuerelemente bei und sendet die vollständige Diagrammdarstellung als sichtbaren Text.

Slack akzeptiert derzeit bis zu zwei data_visualization-Blöcke pro Nachricht. Wenn eine Präsentation mehr als zwei gültige Diagramme enthält, behält OpenClaw deren Reihenfolge bei und setzt die native Darstellung in Folgenachrichten mit jeweils höchstens zwei Diagrammen fort.

Die Entwicklerveröffentlichung von Slack dokumentiert den Block als App-seitige Block-Kit-Funktion und nennt keine Einschränkung auf kostenpflichtige Tarife. Die Angaben zur Berechtigung für Business+/Enterprise gelten für die automatische KI-Diagrammerstellung von Slackbot, die davon getrennt ist, dass eine App ein bereits strukturiertes Block-Kit-Diagramm sendet. Diagramme sind reine Nachrichtenblöcke und keine Inhalte für App Home, Modalfenster oder Canvas.

Native Tabellen

Der aktuelle data_table-Block von Block Kit von Slack stellt strukturierte Zeilen und Spalten in Nachrichten dar. OpenClaw ordnet einen expliziten portablen presentation-Block table dem Wert data_table zu; der veraltete table-Block von Slack wird nicht verwendet. Zusätzlich zum normalen Nachrichtenzugriff chat:write sind weder ein zusätzlicher OAuth-Bereich noch eine Slack-Konfiguration erforderlich.

{  "blocks": [    {      "type": "table",      "caption": "Offene Pipeline",      "headers": ["Konto", "Phase", "ARR"],      "rows": [        ["Acme", "Gewonnen", 125000],        ["Globex", "Prüfung", 82000]      ],      "rowHeaderColumnIndex": 0    }  ]}

OpenClaw ordnet Kopfzeilen- und Zeichenfolgenzellen Slack-Zellen vom Typ raw_text zu. Numerische Zellen werden raw_number zugeordnet, wobei der endliche numerische Wert für natives Sortieren und Filtern erhalten bleibt. rowHeaderColumnIndex kennzeichnet, sofern vorhanden, diese nullbasierte Spalte als Slack-Zeilenüberschriften.

Die veröffentlichten data_table-Beschränkungen von Slack werden vor der nativen Darstellung durchgesetzt:

• 1-20 Spalten
• 1-100 Datenzeilen zuzüglich der Kopfzeile
• dieselbe Anzahl von Zellen in jeder Zeile
• höchstens insgesamt 10.000 Zeichen in allen Tabellenzellen einer Nachricht

Mehrere gültige Tabellenblöcke können nativ dargestellt werden, solange die Nachricht innerhalb der Gesamtzeichenbegrenzung bleibt. Eine Tabelle, die nicht innerhalb der nativen Beschränkungen dargestellt werden kann, wird stattdessen als vollständiger deterministischer Text ausgegeben, ohne Zeilen oder Zellen zu verlieren. Wenn dieser Text die Länge einer Slack-Nachricht überschreitet, verwenden Übertragungen und Slash-Antworten geordnete Textabschnitte. Tabellenänderungen schlagen mit einem ausdrücklichen Größenfehler fehl, statt Zeilen einer vorhandenen Nachricht unbemerkt abzuschneiden.

Jede native Tabelle, die aus einer portablen Darstellung erzeugt wird, enthält außerdem eine übergeordnete Textdarstellung für Screenreader, Benachrichtigungen, Sitzungsspiegelung und Clients, die den Block nicht darstellen können. Unverarbeitete Diagramm- und Tabellenwerte bleiben im Fallback unverändert, sodass Zelldaten wie <@U123> nicht zu einer Slack-Erwähnung werden. Wenn Slack native Diagramm- oder Tabellenblöcke mit invalid_blocks ablehnt, entfernt OpenClaw alle nativen Datenblöcke in einem einzigen begrenzten Wiederherstellungsschritt, behält gültige benachbarte Blöcke wie Schaltflächen und Auswahlfelder bei und sendet den vollständigen sichtbaren Diagramm- und Tabellentext mit deaktivierter Slack-Formatierung. Die Zustellung von Slash-Befehlen verfolgt Slacks Budget von fünf Aufrufen für response_url über den gesamten Befehl hinweg. Vor jedem Antwortstapel wählt sie einen vollständigen Plan aus, der in die verbleibenden Aufrufe passt, oder schlägt fehl, bevor dieser Stapel veröffentlicht wird.

Nur explizite presentation-Tabellenblöcke werden zu nativen Tabellen hochgestuft. Markdown-Pipe-Tabellen bleiben verfasster Text; OpenClaw versucht nicht, die Tabellenstruktur oder Zelltypen zu erraten. Bestehende vertrauenswürdige Slack-native Erzeuger können weiterhin unverarbeitete Blöcke über channelData.slack.blocks durchreichen; OpenClaw leitet Fallback- Text aus gültigen unverarbeiteten data_table-Zellen ab, während fehlerhafte benutzerdefinierte Blöcke auf ihre Beschriftung oder den allgemeinen Block-Kit-Fallback zurückfallen können. Portable Ausgaben von Agenten, CLI und Plugins sollten presentation verwenden.

Interaktive Antworten

Slack kann von Agenten erstellte interaktive Antwortsteuerelemente darstellen, diese Funktion ist jedoch standardmäßig deaktiviert. Für neue Ausgaben von Agenten, CLI und Plugins sind die gemeinsamen presentation-Schaltflächen oder Auswahlblöcke vorzuziehen. Sie verwenden denselben Slack-Interaktionspfad und können zugleich auf anderen Kanälen auf eine einfachere Darstellung zurückfallen.

Global aktivieren:

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

Oder nur für ein Slack-Konto aktivieren:

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

Wenn die Funktion aktiviert ist, können Agenten weiterhin veraltete, ausschließlich für Slack bestimmte Antwortdirektiven ausgeben:

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

Diese Direktiven werden in Slack Block Kit kompiliert und leiten Klicks oder Auswahlen über den bestehenden Ereignispfad für Slack-Interaktionen zurück. Behalten Sie sie für alte Prompts und Slack-spezifische Ausweichmöglichkeiten bei; verwenden Sie für neue portable Steuerelemente die gemeinsame Darstellung.

Die APIs des Direktiven-Compilers sind für neuen Erzeugercode ebenfalls veraltet:

• compileSlackInteractiveReplies(...)
• parseSlackOptionsLine(...)
• isSlackInteractiveRepliesEnabled(...)
• buildSlackInteractiveBlocks(...)

Verwenden Sie presentation-Payloads und buildSlackPresentationBlocks(...) für neue in Slack dargestellte Steuerelemente.

Hinweise:

• Dies ist eine Slack-spezifische Legacy-Benutzeroberfläche. Andere Kanäle übersetzen Slack-Block- Kit-Direktiven nicht in ihre eigenen Schaltflächensysteme.
• Die interaktiven Callback-Werte sind von OpenClaw erzeugte undurchsichtige Token, keine unverarbeiteten, vom Agenten erstellten Werte.
• Wenn erzeugte interaktive Blöcke die Slack-Block-Kit-Grenzwerte überschreiten würden, greift OpenClaw auf die ursprüngliche Textantwort zurück, statt einen ungültigen Block-Payload zu senden.

Plugin-eigene Modal-Übermittlungen

Slack-Plugins, die einen interaktiven Handler registrieren, können außerdem modale view_submission- und view_closed-Lebenszyklusereignisse empfangen, bevor OpenClaw den Payload für das für den Agenten sichtbare Systemereignis komprimiert. Verwenden Sie beim Öffnen eines Slack-Modals eines dieser Routing-Muster:

• Setzen Sie callback_id auf openclaw:<namespace>:<payload>.
• Oder behalten Sie ein vorhandenes callback_id bei und fügen Sie pluginInteractiveData: "<namespace>:<payload>" in das modale private_metadata ein.

Der Handler empfängt ctx.interaction.kind als view_submission oder view_closed, normalisiertes inputs und das vollständige unverarbeitete stateValues-Objekt von Slack. Ein ausschließlich auf der Callback-ID basierendes Routing genügt, um den Plugin-Handler aufzurufen; schließen Sie die vorhandenen Benutzer-/Sitzungs-Routingfelder des Modals private_metadata ein, wenn das Modal zusätzlich ein für den Agenten sichtbares Systemereignis erzeugen soll. Der Agent empfängt ein kompaktes, geschwärztes Slack interaction: ...-Systemereignis. Wenn der Handler systemEvent.summary, systemEvent.reference oder systemEvent.data zurückgibt, werden diese Felder in dieses kompakte Ereignis aufgenommen, sodass der Agent auf Plugin-eigenen Speicher verweisen kann, ohne den vollständigen Formular-Payload zu sehen.

Native Genehmigungen in Slack

Slack kann mit interaktiven Schaltflächen und Interaktionen als nativer Genehmigungsclient fungieren, statt auf die Web-Benutzeroberfläche oder das Terminal zurückzugreifen.

• Exec- und Plugin-Genehmigungen können als Slack-native Block-Kit-Aufforderungen dargestellt werden.
• channels.slack.execApprovals.* bleibt die Konfiguration zur Aktivierung des nativen Clients für Exec-Genehmigungen sowie für das DM-/Kanal-Routing.
• DMs für Exec-Genehmigungen verwenden channels.slack.execApprovals.approvers oder commands.ownerAllowFrom.
• Plugin-Genehmigungen verwenden Slack-native Schaltflächen, wenn Slack für die Ursprungssitzung als nativer Genehmigungsclient aktiviert ist oder wenn approvals.plugin zur ursprünglichen Slack-Sitzung oder zu einem Slack-Ziel routet.
• DMs für Plugin-Genehmigungen verwenden Slack-Plugin-Genehmiger aus channels.slack.allowFrom, das benannte Konto allowFrom oder die Standardroute des Kontos.
• Die Autorisierung der Genehmiger wird weiterhin durchgesetzt: Genehmiger, die ausschließlich für Exec zuständig sind, können Plugin-Anfragen nur genehmigen, wenn sie auch Plugin-Genehmiger sind.

Hierbei wird dieselbe gemeinsame Oberfläche für Genehmigungsschaltflächen wie bei anderen Kanälen verwendet. Wenn interactivity in den Einstellungen Ihrer Slack-App aktiviert ist, werden Genehmigungsaufforderungen direkt in der Unterhaltung als Block-Kit-Schaltflächen dargestellt. Wenn diese Schaltflächen vorhanden sind, bilden sie die primäre Genehmigungsoberfläche; OpenClaw sollte einen manuellen /approve-Befehl nur einschließen, wenn das Werkzeugergebnis angibt, dass Chat- Genehmigungen nicht verfügbar sind oder die manuelle Genehmigung der einzige Weg ist.

Konfigurationspfad:

• channels.slack.execApprovals.enabled
• channels.slack.execApprovals.approvers (optional; greift nach Möglichkeit auf commands.ownerAllowFrom zurück)
• channels.slack.execApprovals.target (dm | channel | both, Standard: dm)
• agentFilter, sessionFilter

Slack aktiviert native Exec-Genehmigungen automatisch, wenn enabled nicht gesetzt oder "auto" ist und mindestens ein Exec-Genehmiger aufgelöst wird. Slack kann über diesen nativen Clientpfad auch native Plugin-Genehmigungen verarbeiten, wenn Slack-Plugin-Genehmiger aufgelöst werden und die Anfrage den Filtern des nativen Clients entspricht. Setzen Sie enabled: false, um Slack ausdrücklich als nativen Genehmigungsclient zu deaktivieren. Setzen Sie enabled: true, um native Genehmigungen zu erzwingen, wenn Genehmiger aufgelöst werden. Das Deaktivieren von Slack-Exec-Genehmigungen deaktiviert nicht die native Zustellung von Slack-Plugin-Genehmigungen, die über approvals.plugin aktiviert ist; für die Zustellung von Plugin-Genehmigungen werden stattdessen Slack-Plugin-Genehmiger verwendet.

Standardverhalten ohne explizite Konfiguration für Slack-Exec-Genehmigungen:

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

Eine explizite Slack-native Konfiguration ist nur erforderlich, wenn Sie Genehmiger überschreiben, Filter hinzufügen oder die Zustellung im Ursprungs-Chat aktivieren möchten:

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

Die gemeinsame approvals.exec-Weiterleitung ist davon getrennt. Verwenden Sie sie nur, wenn Aufforderungen zur Exec-Genehmigung zusätzlich an andere Chats oder explizite Out-of-Band-Ziele weitergeleitet werden müssen. Die gemeinsame approvals.plugin-Weiterleitung ist ebenfalls getrennt; die native Slack-Zustellung unterdrückt diesen Fallback nur, wenn Slack die Plugin- Genehmigungsanfrage nativ verarbeiten kann.

/approve im selben Chat funktioniert ebenfalls in Slack-Kanälen und DMs, die bereits Befehle unterstützen. Das vollständige Weiterleitungsmodell für Genehmigungen finden Sie unter Exec-Genehmigungen.

Ereignisse und Betriebsverhalten

• Bearbeitungen und Löschungen von Nachrichten werden auf Systemereignisse abgebildet.
• Thread-Übertragungen (Thread-Antworten mit „Also send to channel“) werden als normale Benutzernachrichten verarbeitet.
• Ereignisse zum Hinzufügen und Entfernen von Reaktionen werden auf Systemereignisse abgebildet.
• Beitritte und Austritte von Mitgliedern, erstellte und umbenannte Kanäle sowie Ereignisse zum Hinzufügen und Entfernen von Pins werden auf Systemereignisse abgebildet.
• Optionales Präsenz-Polling kann den beobachteten Übergang eines menschlichen Teilnehmers von away zu active der zuletzt aktiven, geeigneten Slack-Sitzung dieses Teilnehmers zuordnen. Standardmäßig ist es deaktiviert.
• channel_id_changed kann Kanalkonfigurationsschlüssel migrieren, wenn configWrites aktiviert ist.
• Metadaten zu Kanalthema und -zweck werden als nicht vertrauenswürdiger Kontext behandelt und können in den Routing-Kontext eingefügt werden.
• Agent-View-Entitäten app_context werden in der Slack-Relevanzreihenfolge validiert und ausschließlich als strukturierter, nicht vertrauenswürdiger Kontext offengelegt; ein ausgelassener Kontext löscht die Daten für den aktuellen Turn, statt veraltete Entitäten wiederzuverwenden.
• Der Thread-Starter und die anfängliche Kontextübernahme aus dem Thread-Verlauf werden gegebenenfalls anhand konfigurierter Absender-Zulassungslisten gefiltert.
• Blockaktionen, Kurzbefehle und modale Interaktionen erzeugen strukturierte Slack interaction: ...-Systemereignisse mit umfangreichen Payload-Feldern:
  • Blockaktionen: ausgewählte Werte, Beschriftungen, Auswahlwerte und workflow_*-Metadaten
  • globale Kurzbefehle: Callback- und Akteursmetadaten, geroutet an die direkte Sitzung des Akteurs
  • Nachrichtenkurzbefehle: Callback-, Akteurs-, Kanal-, Thread- und Kontextdaten der ausgewählten Nachricht
  • modale view_submission- und view_closed-Ereignisse mit gerouteten Kanalmetadaten und Formulareingaben

Definieren Sie globale oder Nachrichtenkurzbefehle in der Konfiguration Ihrer Slack-App und verwenden Sie eine beliebige nicht leere Callback-ID. OpenClaw bestätigt passende Kurzbefehl-Payloads, wendet dieselben Absenderrichtlinien für DMs und Kanäle wie bei anderen Slack-Interaktionen an und stellt das bereinigte Ereignis für die geroutete Agentensitzung in die Warteschlange. Trigger-IDs und Antwort-URLs werden im Agentenkontext geschwärzt.

Präsenzereignisse

Slack sendet Präsenzänderungen weder über die Events API noch über Socket Mode. OpenClaw kann stattdessen users.getPresence für menschliche Teilnehmer abfragen, deren Nachrichten die normalen Slack-Zugriffs- und Routing-Prüfungen bestanden haben.

{  channels: {    slack: {      presenceEvents: { mode: "auto" },      channels: {        C0123456789: { presenceEvents: { mode: "on" } },        C0987654321: { presenceEvents: { mode: "off" } },      },    },  },}

• off (Standard): kein Präsenz-Timer und keine Slack-API-Aufrufe.
• auto: überwacht DMs, MPIMs und Slack-Threads, die in den letzten 24 Stunden aktiv waren, mit höchstens 8 beobachteten menschlichen Teilnehmern. Kanalsitzungen auf oberster Ebene sind ausgeschlossen.
• on: überwacht dieselben Unterhaltungen ohne Teilnehmerbegrenzung und schließt Kanalsitzungen auf oberster Ebene ein. Verwenden Sie eine kanalspezifische Überschreibung, um einen Kanal zu erzwingen oder zu unterdrücken.

OpenClaw fragt pro Slack-Konto höchstens 45 eindeutige Benutzer pro Minute ab, übernimmt das erste Ergebnis, ohne den Agenten zu aktivieren, und aktiviert ihn nur bei einem beobachteten Übergang von away zu active. Pro Slack-Konto und Benutzer gilt eine dauerhafte Abklingzeit von 8 Stunden, selbst wenn diese Person an mehreren Threads teilnimmt. Das Ereignis wird ausschließlich an die zuletzt aktive, geeignete Unterhaltung dieser Person geroutet und weist den Agenten an, den Speicher/das Wiki und den bekannten Zeitzonenkontext zu konsultieren, bevor er entscheidet, ob er eine kurze Begrüßung sendet. Der Agent kann stumm bleiben.

Das Bot-Token benötigt users:read, das bereits im empfohlenen Manifest enthalten ist. Präsenzereignisse sind für organisationsweite Enterprise-Grid-Installationen nicht verfügbar.

Konfigurationsreferenz

Primäre Referenz: Konfigurationsreferenz – Slack.

Fehlerbehebung

{messages: {groupChat: {  visibleReplies: "automatic",},},}

openclaw channels status --probeopenclaw logs --followopenclaw doctor

openclaw pairing list slack

Referenz für Anhangsmedien

Slack kann heruntergeladene Medien an den Agentendurchlauf anhängen, wenn das Herunterladen von Slack-Dateien erfolgreich ist und die Größenbeschränkungen eingehalten werden. Audioclips können transkribiert werden, Bilddateien können den Pfad zur Medienerkennung durchlaufen oder direkt an ein für Bildverarbeitung geeignetes Antwortmodell übergeben werden, und andere Dateien bleiben als herunterladbarer Dateikontext verfügbar.

Unterstützte Medientypen

Eingehende Verarbeitungspipeline

Wenn eine Slack-Nachricht mit Dateianhängen eingeht:

1. OpenClaw lädt die Datei mit dem Bot-Token von der privaten Slack-URL herunter.
2. Nach erfolgreichem Herunterladen wird die Datei in den Medienspeicher geschrieben.
3. Die Pfade und Inhaltstypen der heruntergeladenen Medien werden dem eingehenden Kontext hinzugefügt.
4. Audioclips werden an die gemeinsame Transkriptionspipeline weitergeleitet; bildfähige Modell-/Tool-Pfade können Bildanhänge aus demselben Kontext verwenden.
5. Andere Dateien bleiben für Tools, die sie verarbeiten können, als Dateimetadaten oder Medienreferenzen verfügbar.

Vererbung von Anhängen der Thread-Ausgangsnachricht

Wenn eine Nachricht in einem Thread eingeht (also ein übergeordnetes Element thread_ts besitzt):

• Wenn die Antwort selbst keine direkten Medien enthält und die eingebundene Ausgangsnachricht Dateien besitzt, kann Slack die Ausgangsdateien als Kontext der Thread-Ausgangsnachricht laden.
• Ausgangsdateien werden nur beim Initialisieren einer neuen oder zurückgesetzten Thread-Sitzung geladen. Spätere Antworten, die nur Text enthalten, verwenden den vorhandenen Sitzungskontext erneut und hängen die Ausgangsdateien nicht erneut als neue Medien an.
• Direkte Antwortanhänge haben Vorrang vor Anhängen der Ausgangsnachricht.
• Eine Ausgangsnachricht, die nur Dateien und keinen Text enthält, wird durch einen Anhangsplatzhalter dargestellt, damit der Rückfallpfad ihre Dateien weiterhin einbeziehen kann.

Verarbeitung mehrerer Anhänge

Wenn eine einzelne Slack-Nachricht mehrere Dateianhänge enthält:

• Jeder Anhang wird unabhängig durch die Medienpipeline verarbeitet.
• Referenzen auf heruntergeladene Medien werden im Nachrichtenkontext zusammengeführt.
• Die Verarbeitungsreihenfolge entspricht der Dateireihenfolge von Slack in den Ereignisnutzdaten.
• Ein Fehler beim Herunterladen eines Anhangs blockiert die anderen Anhänge nicht.

Größen-, Download- und Modellbeschränkungen

• Größenbeschränkung: Standardmäßig 20 MB pro Datei. Konfigurierbar über channels.slack.mediaMaxMb.
• Höchstgrenze für die Audiotranskription: Der Wert maxBytes des ausgewählten audiofähigen Eintrags tools.media.models[] gilt ebenfalls, wenn die heruntergeladene Datei an einen Transkriptions-Provider oder eine CLI gesendet wird.
• Downloadfehler: Dateien, die Slack nicht bereitstellen kann, abgelaufene URLs, nicht zugängliche Dateien, zu große Dateien sowie HTML-Antworten für Slack-Authentifizierung/-Anmeldung werden übersprungen, statt als nicht unterstützte Formate gemeldet zu werden.
• Bildverarbeitungsmodell: Die Bildanalyse verwendet das aktive Antwortmodell, wenn es Bildverarbeitung unterstützt, oder das unter agents.defaults.imageModel konfigurierte Bildmodell.

Bekannte Einschränkungen

Zugehörige Dokumentation

• Pipeline zum Medienverständnis
• Audio- und Sprachnotizen
• PDF-Tool

Verwandte Themen