Slack

Status: produktionsreif für DMs + Channels über Slack-App-Integrationen. Der Standardmodus ist Socket Mode; HTTP-Request-URLs werden ebenfalls unterstützt.

Kopplung

Slack-DMs verwenden standardmäßig den Kopplungsmodus.

Slash-Befehle

Natives Befehlsverhalten und Befehlskatalog.

Fehlerbehebung für Channels

Kanalübergreifende Diagnose- und Reparaturleitfäden.

Schnelleinrichtung

Socket Mode (Standard)
HTTP-Request-URLs

Eine neue Slack-App erstellen

Klicken Sie in den Slack-App-Einstellungen auf die Schaltfläche Create New App:

wählen Sie from a manifest und wählen Sie einen Workspace für Ihre App aus
fügen Sie das Beispielmanifest von unten ein und fahren Sie mit dem Erstellen fort
generieren Sie ein App-Level-Token (xapp-...) mit connections:write
installieren Sie die App und kopieren Sie das angezeigte Bot-Token (xoxb-...)

OpenClaw konfigurieren

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

Env-Fallback (nur Standardkonto):

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

Gateway starten

openclaw gateway

Eine neue Slack-App erstellen

Klicken Sie in den Slack-App-Einstellungen auf die Schaltfläche Create New App:

wählen Sie from a manifest und wählen Sie einen Workspace für Ihre App aus
fügen Sie das Beispielmanifest ein und aktualisieren Sie die URLs vor dem Erstellen
speichern Sie das Signing Secret für die Anfrageverifizierung
installieren Sie die App und kopieren Sie das angezeigte Bot-Token (xoxb-...)

OpenClaw konfigurieren

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

Verwenden Sie eindeutige Webhook-Pfade für HTTP mit mehreren KontenGeben Sie jedem Konto einen eigenen webhookPath (Standard /slack/events), damit Registrierungen nicht kollidieren.

Gateway starten

openclaw gateway

Manifest- und Scope-Checkliste

Socket Mode (Standard)
HTTP-Request-URLs

{
  "display_information": {
    "name": "OpenClaw",
    "description": "Slack-Konnektor für OpenClaw"
  },
  "features": {
    "bot_user": {
      "display_name": "OpenClaw",
      "always_online": true
    },
    "app_home": {
      "messages_tab_enabled": true,
      "messages_tab_read_only_enabled": false
    },
    "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",
        "users:read"
      ]
    }
  },
  "settings": {
    "socket_mode_enabled": true,
    "event_subscriptions": {
      "bot_events": [
        "app_mention",
        "channel_rename",
        "member_joined_channel",
        "member_left_channel",
        "message.channels",
        "message.groups",
        "message.im",
        "message.mpim",
        "pin_added",
        "pin_removed",
        "reaction_added",
        "reaction_removed"
      ]
    }
  }
}

{
  "display_information": {
    "name": "OpenClaw",
    "description": "Slack-Konnektor für OpenClaw"
  },
  "features": {
    "bot_user": {
      "display_name": "OpenClaw",
      "always_online": true
    },
    "app_home": {
      "messages_tab_enabled": true,
      "messages_tab_read_only_enabled": false
    },
    "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",
        "users:read"
      ]
    }
  },
  "settings": {
    "event_subscriptions": {
      "request_url": "https://gateway-host.example.com/slack/events",
      "bot_events": [
        "app_mention",
        "channel_rename",
        "member_joined_channel",
        "member_left_channel",
        "message.channels",
        "message.groups",
        "message.im",
        "message.mpim",
        "pin_added",
        "pin_removed",
        "reaction_added",
        "reaction_removed"
      ]
    },
    "interactivity": {
      "is_enabled": true,
      "request_url": "https://gateway-host.example.com/slack/events",
      "message_menu_options_url": "https://gateway-host.example.com/slack/events"
    }
  }
}

Zusätzliche Manifesteinstellungen

Machen Sie verschiedene Funktionen sichtbar, die die obigen Standardeinstellungen erweitern.

Optionale native Slash-Befehle

Mehrere native Slash-Befehle können mit Nuancen anstelle eines einzelnen konfigurierten Befehls verwendet werden:

Verwenden Sie /agentstatus anstelle von /status, weil der Befehl /status reserviert ist.
Es können nicht mehr als 25 Slash-Befehle gleichzeitig verfügbar gemacht werden.

Ersetzen Sie Ihren vorhandenen Abschnitt features.slash_commands durch eine Teilmenge der verfügbaren Befehle:

Socket Mode (Standard)
HTTP-Request-URLs

    "slash_commands": [
      {
        "command": "/new",
        "description": "Eine neue Sitzung starten",
        "usage_hint": "[model]"
      },
      {
        "command": "/reset",
        "description": "Die aktuelle Sitzung zurücksetzen"
      },
      {
        "command": "/compact",
        "description": "Den Sitzungskontext komprimieren",
        "usage_hint": "[instructions]"
      },
      {
        "command": "/stop",
        "description": "Den aktuellen Lauf stoppen"
      },
      {
        "command": "/session",
        "description": "Ablauf der Thread-Bindung verwalten",
        "usage_hint": "idle <duration|off> oder max-age <duration|off>"
      },
      {
        "command": "/think",
        "description": "Die Denkstufe festlegen",
        "usage_hint": "<off|minimal|low|medium|high|xhigh>"
      },
      {
        "command": "/verbose",
        "description": "Ausführliche Ausgabe umschalten",
        "usage_hint": "on|off|full"
      },
      {
        "command": "/fast",
        "description": "Fast-Modus anzeigen oder festlegen",
        "usage_hint": "[status|on|off]"
      },
      {
        "command": "/reasoning",
        "description": "Sichtbarkeit von Begründungen umschalten",
        "usage_hint": "[on|off|stream]"
      },
      {
        "command": "/elevated",
        "description": "Erweiterten Modus umschalten",
        "usage_hint": "[on|off|ask|full]"
      },
      {
        "command": "/exec",
        "description": "Exec-Standardeinstellungen anzeigen oder festlegen",
        "usage_hint": "host=<auto|sandbox|gateway|node> security=<deny|allowlist|full> ask=<off|on-miss|always> node=<id>"
      },
      {
        "command": "/model",
        "description": "Das Modell anzeigen oder festlegen",
        "usage_hint": "[name|#|status]"
      },
      {
        "command": "/models",
        "description": "Anbieter oder Modelle für einen Anbieter auflisten",
        "usage_hint": "[provider] [page] [limit=<n>|size=<n>|all]"
      },
      {
        "command": "/help",
        "description": "Die kurze Hilfezusammenfassung anzeigen"
      },
      {
        "command": "/commands",
        "description": "Den generierten Befehlskatalog anzeigen"
      },
      {
        "command": "/tools",
        "description": "Anzeigen, was der aktuelle Agent gerade verwenden kann",
        "usage_hint": "[compact|verbose]"
      },
      {
        "command": "/agentstatus",
        "description": "Laufzeitstatus anzeigen, einschließlich Anbieternutzung/Kontingent, wenn verfügbar"
      },
      {
        "command": "/tasks",
        "description": "Aktive/aktuelle Hintergrundaufgaben für die aktuelle Sitzung auflisten"
      },
      {
        "command": "/context",
        "description": "Erklären, wie der Kontext zusammengestellt wird",
        "usage_hint": "[list|detail|json]"
      },
      {
        "command": "/whoami",
        "description": "Ihre Absenderidentität anzeigen"
      },
      {
        "command": "/skill",
        "description": "Eine Skill anhand des Namens ausführen",
        "usage_hint": "<name> [input]"
      },
      {
        "command": "/btw",
        "description": "Eine Nebenfrage stellen, ohne den Sitzungskontext zu ändern",
        "usage_hint": "<question>"
      },
      {
        "command": "/usage",
        "description": "Die Nutzungsfußzeile steuern oder Kostenzusammenfassung anzeigen",
        "usage_hint": "off|tokens|full|cost"
      }
    ]

    "slash_commands": [
      {
        "command": "/new",
        "description": "Eine neue Sitzung starten",
        "usage_hint": "[model]",
        "url": "https://gateway-host.example.com/slack/events"
      },
      {
        "command": "/reset",
        "description": "Die aktuelle Sitzung zurücksetzen",
        "url": "https://gateway-host.example.com/slack/events"
      },
      {
        "command": "/compact",
        "description": "Den Sitzungskontext komprimieren",
        "usage_hint": "[instructions]",
        "url": "https://gateway-host.example.com/slack/events"
      },
      {
        "command": "/stop",
        "description": "Den aktuellen Lauf stoppen",
        "url": "https://gateway-host.example.com/slack/events"
      },
      {
        "command": "/session",
        "description": "Ablauf der Thread-Bindung verwalten",
        "usage_hint": "idle <duration|off> oder max-age <duration|off>",
        "url": "https://gateway-host.example.com/slack/events"
      },
      {
        "command": "/think",
        "description": "Die Denkstufe festlegen",
        "usage_hint": "<off|minimal|low|medium|high|xhigh>",
        "url": "https://gateway-host.example.com/slack/events"
      },
      {
        "command": "/verbose",
        "description": "Ausführliche Ausgabe umschalten",
        "usage_hint": "on|off|full",
        "url": "https://gateway-host.example.com/slack/events"
      },
      {
        "command": "/fast",
        "description": "Fast-Modus anzeigen oder festlegen",
        "usage_hint": "[status|on|off]",
        "url": "https://gateway-host.example.com/slack/events"
      },
      {
        "command": "/reasoning",
        "description": "Sichtbarkeit von Begründungen umschalten",
        "usage_hint": "[on|off|stream]",
        "url": "https://gateway-host.example.com/slack/events"
      },
      {
        "command": "/elevated",
        "description": "Erweiterten Modus umschalten",
        "usage_hint": "[on|off|ask|full]",
        "url": "https://gateway-host.example.com/slack/events"
      },
      {
        "command": "/exec",
        "description": "Exec-Standardeinstellungen anzeigen oder festlegen",
        "usage_hint": "host=<auto|sandbox|gateway|node> security=<deny|allowlist|full> ask=<off|on-miss|always> node=<id>",
        "url": "https://gateway-host.example.com/slack/events"
      },
      {
        "command": "/model",
        "description": "Das Modell anzeigen oder festlegen",
        "usage_hint": "[name|#|status]",
        "url": "https://gateway-host.example.com/slack/events"
      },
      {
        "command": "/models",
        "description": "Anbieter oder Modelle für einen Anbieter auflisten",
        "usage_hint": "[provider] [page] [limit=<n>|size=<n>|all]",
        "url": "https://gateway-host.example.com/slack/events"
      },
      {
        "command": "/help",
        "description": "Die kurze Hilfezusammenfassung anzeigen",
        "url": "https://gateway-host.example.com/slack/events"
      },
      {
        "command": "/commands",
        "description": "Den generierten Befehlskatalog anzeigen",
        "url": "https://gateway-host.example.com/slack/events"
      },
      {
        "command": "/tools",
        "description": "Anzeigen, was der aktuelle Agent gerade verwenden kann",
        "usage_hint": "[compact|verbose]",
        "url": "https://gateway-host.example.com/slack/events"
      },
      {
        "command": "/agentstatus",
        "description": "Laufzeitstatus anzeigen, einschließlich Anbieternutzung/Kontingent, wenn verfügbar",
        "url": "https://gateway-host.example.com/slack/events"
      },
      {
        "command": "/tasks",
        "description": "Aktive/aktuelle Hintergrundaufgaben für die aktuelle Sitzung auflisten",
        "url": "https://gateway-host.example.com/slack/events"
      },
      {
        "command": "/context",
        "description": "Erklären, wie der Kontext zusammengestellt wird",
        "usage_hint": "[list|detail|json]",
        "url": "https://gateway-host.example.com/slack/events"
      },
      {
        "command": "/whoami",
        "description": "Ihre Absenderidentität anzeigen",
        "url": "https://gateway-host.example.com/slack/events"
      },
      {
        "command": "/skill",
        "description": "Eine Skill anhand des Namens ausführen",
        "usage_hint": "<name> [input]",
        "url": "https://gateway-host.example.com/slack/events"
      },
      {
        "command": "/btw",
        "description": "Eine Nebenfrage stellen, ohne den Sitzungskontext zu ändern",
        "usage_hint": "<question>",
        "url": "https://gateway-host.example.com/slack/events"
      },
      {
        "command": "/usage",
        "description": "Die Nutzungsfußzeile steuern oder Kostenzusammenfassung anzeigen",
        "usage_hint": "off|tokens|full|cost",
        "url": "https://gateway-host.example.com/slack/events"
      }
    ]

Optionale Scope-Berechtigungen für Verfasserschaft (Schreibvorgänge)

Fügen Sie den Bot-Scope chat:write.customize hinzu, wenn ausgehende Nachrichten die aktive Agent-Identität (benutzerdefinierter Benutzername und Icon) statt der Standardidentität der Slack-App verwenden sollen.Wenn Sie ein Emoji-Icon verwenden, erwartet Slack die Syntax :emoji_name:.

Optionale User-Token-Scopes (Lesevorgänge)

Wenn Sie channels.slack.userToken konfigurieren, sind typische Lesescopes:

channels:history, groups:history, im:history, mpim:history
channels:read, groups:read, im:read, mpim:read
users:read
reactions:read
pins:read
emoji:read
search:read (wenn Sie von Slack-Suchlesevorgängen abhängig sind)

Token-Modell

botToken + appToken sind für Socket Mode erforderlich.
Der HTTP-Modus erfordert botToken + signingSecret.
botToken, appToken, signingSecret und userToken akzeptieren Klartextzeichenfolgen oder SecretRef-Objekte.
Konfigurations-Token überschreiben den Env-Fallback.
Der Env-Fallback SLACK_BOT_TOKEN / SLACK_APP_TOKEN gilt nur für das Standardkonto.
userToken (xoxp-...) ist nur per Konfiguration verfügbar (kein Env-Fallback) und verwendet standardmäßig schreibgeschütztes Verhalten (userTokenReadOnly: true).

Verhalten des Status-Snapshots:

Die Slack-Kontoinspektion verfolgt pro Zugangsdaten *Source- und *Status-Felder (botToken, appToken, signingSecret, userToken).
Der Status ist available, configured_unavailable oder missing.
configured_unavailable bedeutet, dass das Konto über SecretRef oder eine andere nicht-inline Geheimnisquelle konfiguriert ist, der aktuelle Befehls-/Laufzeitpfad den tatsächlichen Wert aber nicht auflösen konnte.
Im HTTP-Modus wird signingSecretStatus eingeschlossen; im Socket Mode ist das erforderliche Paar botTokenStatus + appTokenStatus.

Für Aktions-/Verzeichnislesevorgänge kann das User-Token bevorzugt werden, wenn es konfiguriert ist. Für Schreibvorgänge bleibt das Bot-Token bevorzugt; Schreibvorgänge mit User-Token sind nur zulässig, wenn userTokenReadOnly: false gesetzt ist und kein Bot-Token verfügbar ist.

Aktionen und Gates

Slack-Aktionen werden durch channels.slack.actions.* gesteuert. Verfügbare Aktionsgruppen im aktuellen Slack-Tooling:

Gruppe	Standard
messages	aktiviert
reactions	aktiviert
pins	aktiviert
memberInfo	aktiviert
emojiList	aktiviert

Zu den aktuellen Slack-Nachrichtenaktionen gehören send, upload-file, download-file, read, edit, delete, pin, unpin, list-pins, member-info und emoji-list.

Zugriffskontrolle und Routing

DM-Richtlinie
Channel-Richtlinie
Erwähnungen und Channel-Benutzer

channels.slack.dmPolicy steuert den DM-Zugriff (Legacy: channels.slack.dm.policy):

pairing (Standard)
allowlist
open (erfordert, dass channels.slack.allowFrom "*" enthält; Legacy: channels.slack.dm.allowFrom)
disabled

DM-Flags:

dm.enabled (standardmäßig true)
channels.slack.allowFrom (bevorzugt)
dm.allowFrom (Legacy)
dm.groupEnabled (Gruppen-DMs standardmäßig false)
dm.groupChannels (optionale MPIM-Allowlist)

Vorrang bei mehreren Konten:

channels.slack.accounts.default.allowFrom gilt nur für das Konto default.
Benannte Konten übernehmen channels.slack.allowFrom, wenn ihr eigenes allowFrom nicht gesetzt ist.
Benannte Konten übernehmen nicht channels.slack.accounts.default.allowFrom.

Das Pairing in DMs verwendet openclaw pairing approve slack <code>.

channels.slack.groupPolicy steuert die Channel-Behandlung:

open
allowlist
disabled

Die Channel-Allowlist liegt unter channels.slack.channels und sollte stabile Channel-IDs verwenden.Laufzeithinweis: Wenn channels.slack vollständig fehlt (nur Env-Setup), fällt die Laufzeit auf groupPolicy="allowlist" zurück und protokolliert eine Warnung (selbst wenn channels.defaults.groupPolicy gesetzt ist).Namens-/ID-Auflösung:

Channel-Allowlist-Einträge und DM-Allowlist-Einträge werden beim Start aufgelöst, wenn der Token-Zugriff dies erlaubt
nicht aufgelöste Channel-Namenseinträge bleiben wie konfiguriert erhalten, werden für das Routing standardmäßig aber ignoriert
eingehende Autorisierung und Channel-Routing sind standardmäßig ID-first; direktes Abgleichen von Benutzernamen/Slugs erfordert channels.slack.dangerouslyAllowNameMatching: true

Channel-Nachrichten sind standardmäßig durch Erwähnungen gated.Erwähnungsquellen:

explizite App-Erwähnung (<@botId>)
Erwähnungs-Regex-Muster (agents.list[].groupChat.mentionPatterns, Fallback messages.groupChat.mentionPatterns)
implizites Reply-to-Bot-Thread-Verhalten (deaktiviert, wenn thread.requireExplicitMention true ist)

Steuerelemente pro Channel (channels.slack.channels.<id>; Namen nur über Startauflösung oder dangerouslyAllowNameMatching):

requireMention
users (Allowlist)
allowBots
skills
systemPrompt
tools, toolsBySender
Schlüsselformat für toolsBySender: id:, e164:, username:, name: oder Platzhalter "*" (Legacy-Schlüssel ohne Präfix werden weiterhin nur id: zugeordnet)

Threads, Sitzungen und Antwort-Tags

DMs werden als direct geroutet; Channels als channel; MPIMs als group.
Mit dem Standard session.dmScope=main werden Slack-DMs in die Hauptsitzung des Agenten zusammengeführt.
Channel-Sitzungen: agent:<agentId>:slack:channel:<channelId>.
Thread-Antworten können bei Bedarf Thread-Sitzungssuffixe (:thread:<threadTs>) erzeugen.
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 abgerufen werden, wenn eine neue Thread-Sitzung beginnt (Standard 20; setzen Sie 0, um dies zu deaktivieren).
channels.slack.thread.requireExplicitMention (Standard false): Wenn true, werden implizite Thread-Erwähnungen unterdrückt, sodass der Bot in Threads nur auf explizite @bot-Erwähnungen antwortet, selbst wenn der Bot bereits am Thread teilgenommen hat. Ohne dies umgehen Antworten in einem Thread mit Bot-Beteiligung das requireMention-Gating.

Steuerelemente für Antwort-Threading:

channels.slack.replyToMode: off|first|all|batched (Standard off)
channels.slack.replyToModeByChatType: pro direct|group|channel
Legacy-Fallback für direkte Chats: channels.slack.dm.replyToMode

Manuelle Antwort-Tags werden unterstützt:

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

Hinweis: replyToMode="off" deaktiviert in Slack jegliches Antwort-Threading, einschließlich expliziter [[reply_to_*]]-Tags. Dies unterscheidet sich von Telegram, wo explizite Tags im Modus "off" weiterhin beachtet werden. Der Unterschied spiegelt die Threading-Modelle der Plattformen wider: Slack-Threads blenden Nachrichten aus dem Channel aus, während Telegram-Antworten im Haupt-Chatverlauf sichtbar bleiben.

Bestätigungsreaktionen

ackReaction sendet ein Bestätigungs-Emoji, während OpenClaw eine eingehende Nachricht verarbeitet. Auflösungsreihenfolge:

channels.slack.accounts.<accountId>.ackReaction
channels.slack.ackReaction
messages.ackReaction
Emoji-Fallback der Agent-Identität (agents.list[].identity.emoji, sonst "👀")

Hinweise:

Slack erwartet Shortcodes (zum Beispiel "eyes").
Verwenden Sie "", um die Reaktion für das Slack-Konto oder global zu deaktivieren.

Text-Streaming

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

off: Live-Vorschau-Streaming deaktivieren.
partial (Standard): Vorschautext durch die neueste partielle Ausgabe ersetzen.
block: Vorschauaktualisierungen in Blöcken anhängen.
progress: Fortschrittsstatustext während der Generierung anzeigen und dann den endgültigen Text senden.

channels.slack.streaming.nativeTransport steuert natives Slack-Text-Streaming, wenn channels.slack.streaming.mode auf partial gesetzt ist (Standard: true).

Für natives Text-Streaming und die Anzeige des Slack-Assistant-Thread-Status muss ein Antwort-Thread verfügbar sein. Die Thread-Auswahl folgt weiterhin replyToMode.
Channel- und Gruppenchat-Wurzeln können weiterhin die normale Entwurfsvorschau verwenden, wenn natives Streaming nicht verfügbar ist.
Slack-DMs der obersten Ebene bleiben standardmäßig ohne Thread, daher zeigen sie keine Vorschau im Thread-Stil an; verwenden Sie Thread-Antworten oder typingReaction, wenn Sie dort sichtbaren Fortschritt wünschen.
Medien und Nicht-Text-Payloads fallen auf die normale Zustellung zurück.
Wenn das Streaming mitten in einer Antwort fehlschlägt, fällt OpenClaw für die verbleibenden Payloads auf die normale Zustellung zurück.

Verwenden Sie die Entwurfsvorschau anstelle von nativem Slack-Text-Streaming:

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

Legacy-Schlüssel:

channels.slack.streamMode (replace | status_final | append) wird automatisch nach channels.slack.streaming.mode migriert.
boolesches channels.slack.streaming wird automatisch nach channels.slack.streaming.mode und channels.slack.streaming.nativeTransport migriert.
Legacy-channels.slack.nativeStreaming wird automatisch nach channels.slack.streaming.nativeTransport migriert.

Typing-Reaction-Fallback

typingReaction fügt der eingehenden Slack-Nachricht vorübergehend eine Reaktion hinzu, während OpenClaw eine Antwort verarbeitet, und entfernt sie wieder, wenn der Lauf beendet ist. Dies ist besonders nützlich außerhalb von Thread-Antworten, die standardmäßig einen Statusindikator „is typing…“ verwenden. Auflösungsreihenfolge:

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

Hinweise:

Slack erwartet Shortcodes (zum Beispiel "hourglass_flowing_sand").
Die Reaktion erfolgt nach bestem Bemühen, und die Bereinigung wird automatisch versucht, nachdem die Antwort oder der Fehlerpfad abgeschlossen ist.

Medien, Chunking und Zustellung

Eingehende Anhänge

Slack-Dateianhänge werden von Slack-gehosteten privaten URLs heruntergeladen (token-authentifizierter Anfragefluss) und in den Medienspeicher geschrieben, wenn der Abruf erfolgreich ist und Größenlimits dies erlauben.Die Laufzeitobergrenze für eingehende Größen beträgt standardmäßig 20MB, sofern sie nicht durch channels.slack.mediaMaxMb überschrieben wird.

Ausgehender Text und Dateien

Text-Chunks verwenden channels.slack.textChunkLimit (Standard 4000)
channels.slack.chunkMode="newline" aktiviert paragrafenorientiertes Aufteilen
Dateisendungen verwenden Slack-Upload-APIs und können Thread-Antworten (thread_ts) enthalten
Das Limit für ausgehende Medien folgt bei Konfiguration channels.slack.mediaMaxMb; andernfalls verwenden Channel-Sendungen die MIME-Typ-Standards aus der Medienpipeline

Zustellungsziele

Bevorzugte explizite Ziele:

user:<id> für DMs
channel:<id> für Channels

Slack-DMs werden über die Slack-Conversation-APIs geöffnet, wenn an Benutzerziele gesendet wird.

Befehle und Slash-Verhalten

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

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

/openclaw /help

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

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

/help

Native Argumentmenüs verwenden eine adaptive Renderstrategie, die vor dem Senden eines ausgewählten Optionswerts ein Bestätigungsmodal anzeigt:

bis zu 5 Optionen: Button-Blöcke
6–100 Optionen: statisches Auswahlmenü
mehr als 100 Optionen: externe Auswahl mit asynchroner Optionsfilterung, wenn Interaktivitäts-Options-Handler verfügbar sind
überschrittene Slack-Limits: codierte Optionswerte fallen auf Buttons zurück

/think

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

Interaktive Antworten

Slack kann von Agenten verfasste interaktive Antwortsteuerungen rendern, aber diese Funktion ist standardmäßig deaktiviert. Global aktivieren:

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

Oder nur für ein Slack-Konto aktivieren:

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

Wenn aktiviert, können Agenten nur 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 vorhandenen Slack-Interaktionsereignispfad zurück. Hinweise:

Dies ist eine Slack-spezifische UI. Andere Channels übersetzen Slack-Block-Kit-Direktiven nicht in ihre eigenen Button-Systeme.
Die Werte interaktiver Callbacks sind von OpenClaw generierte undurchsichtige Token, keine unbearbeiteten, vom Agenten verfassten Werte.
Wenn generierte interaktive Blöcke die Slack-Block-Kit-Limits überschreiten würden, fällt OpenClaw auf die ursprüngliche Textantwort zurück, anstatt eine ungültige Blocks-Payload zu senden.

Exec-Freigaben in Slack

Slack kann als nativer Freigabe-Client mit interaktiven Buttons und Interaktionen dienen, anstatt auf die Web-UI oder das Terminal zurückzufallen.

Exec-Freigaben verwenden channels.slack.execApprovals.* für natives DM-/Channel-Routing.
Plugin-Freigaben können weiterhin über dieselbe native Slack-Button-Oberfläche aufgelöst werden, wenn die Anfrage bereits in Slack landet und die Freigabe-ID-Art plugin: ist.
Die Autorisierung der Freigebenden wird weiterhin erzwungen: Nur als Freigebende identifizierte Benutzer können Anfragen über Slack genehmigen oder ablehnen.

Dies verwendet dieselbe gemeinsame Freigabe-Button-Oberfläche wie andere Channels. Wenn interactivity in Ihren Slack-App-Einstellungen aktiviert ist, werden Freigabeaufforderungen direkt als Block-Kit-Buttons in der Konversation gerendert. Wenn diese Buttons vorhanden sind, sind sie die primäre Freigabe-UX; OpenClaw sollte einen manuellen /approve-Befehl nur einschließen, wenn das Tool-Ergebnis sagt, dass Chat-Freigaben nicht verfügbar sind oder manuelle Freigabe der einzige Weg ist. Konfigurationspfad:

channels.slack.execApprovals.enabled
channels.slack.execApprovals.approvers (optional; fällt wenn möglich auf commands.ownerAllowFrom zurück)
channels.slack.execApprovals.target (dm | channel | both, Standard: dm)
agentFilter, sessionFilter

Slack aktiviert native Exec-Freigaben automatisch, wenn enabled nicht gesetzt oder "auto" ist und sich mindestens ein Freigebender auflösen lässt. Setzen Sie enabled: false, um Slack explizit als nativen Freigabe-Client zu deaktivieren. Setzen Sie enabled: true, um native Freigaben zu erzwingen, wenn sich Freigebende auflösen lassen. Standardverhalten ohne explizite Slack-Exec-Freigabekonfiguration:

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

Eine explizite Slack-native Konfiguration ist nur erforderlich, wenn Sie Freigebende überschreiben, Filter hinzufügen oder sich für die Zustellung an den Ursprungschat entscheiden möchten:

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

Gemeinsame approvals.exec-Weiterleitung ist getrennt. Verwenden Sie sie nur, wenn Exec-Freigabeaufforderungen zusätzlich an andere Chats oder explizite Ziele außerhalb des Bandes weitergeleitet werden müssen. Gemeinsame approvals.plugin-Weiterleitung ist ebenfalls getrennt; native Slack-Buttons können Plugin-Freigaben weiterhin auflösen, wenn diese Anfragen bereits in Slack landen. /approve im selben Chat funktioniert ebenfalls in Slack-Channels und DMs, die bereits Befehle unterstützen. Siehe Exec approvals für das vollständige Modell zur Freigabeweiterleitung.

Ereignisse und Laufzeitverhalten

Nachrichtenbearbeitungen/-löschungen/Thread-Broadcasts werden in Systemereignisse abgebildet.
Hinzugefügte/entfernte Reaktionen werden in Systemereignisse abgebildet.
Beitritt/Austritt von Mitgliedern, Erstellung/Umbenennung von Channels und Hinzufügen/Entfernen von Pins werden in Systemereignisse abgebildet.
channel_id_changed kann Channel-Konfigurationsschlüssel migrieren, wenn configWrites aktiviert ist.
Channel-Topic-/Purpose-Metadaten werden als nicht vertrauenswürdiger Kontext behandelt und können in den Routing-Kontext eingefügt werden.
Thread-Starter und das anfängliche Seedings des Thread-Verlaufs-Kontexts werden, sofern zutreffend, durch konfigurierte Absender-Allowlists gefiltert.
Block-Aktionen und Modal-Interaktionen erzeugen strukturierte Systemereignisse Slack interaction: ... mit umfangreichen Payload-Feldern:
- Block-Aktionen: ausgewählte Werte, Labels, Picker-Werte und workflow_*-Metadaten
- Modal-Ereignisse view_submission und view_closed mit gerouteten Channel-Metadaten und Formulareingaben

Verweise auf die Konfigurationsreferenz

Primäre Referenz:

Konfigurationsreferenz - Slack Wichtige Slack-Felder:
- Modus/Auth: mode, botToken, appToken, signingSecret, webhookPath, accounts.*
- DM-Zugriff: dm.enabled, dmPolicy, allowFrom (Legacy: dm.policy, dm.allowFrom), dm.groupEnabled, dm.groupChannels
- Kompatibilitätsschalter: dangerouslyAllowNameMatching (Break-Glass; deaktiviert lassen, sofern nicht benötigt)
- Channel-Zugriff: groupPolicy, channels.*, channels.*.users, channels.*.requireMention
- Threading/Verlauf: replyToMode, replyToModeByChatType, thread.*, historyLimit, dmHistoryLimit, dms.*.historyLimit
- Zustellung: textChunkLimit, chunkMode, mediaMaxMb, streaming, streaming.nativeTransport
- Betrieb/Funktionen: configWrites, commands.native, slashCommand.*, actions.*, userToken, userTokenReadOnly

Fehlerbehebung

Keine Antworten in Channels

Prüfen Sie in dieser Reihenfolge:

groupPolicy
Channel-Allowlist (channels.slack.channels)
requireMention
users-Allowlist pro Channel

Nützliche Befehle:

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

DM-Nachrichten werden ignoriert

Prüfen Sie:

channels.slack.dm.enabled
channels.slack.dmPolicy (oder Legacy channels.slack.dm.policy)
Pairing-Freigaben / Allowlist-Einträge

openclaw pairing list slack

Socket Mode verbindet sich nicht

Validieren Sie Bot- + App-Token und die Aktivierung von Socket Mode in den Slack-App-Einstellungen.Wenn openclaw channels status --probe --json botTokenStatus oder appTokenStatus: "configured_unavailable" anzeigt, ist das Slack-Konto konfiguriert, aber die aktuelle Laufzeit konnte den durch SecretRef gestützten Wert nicht auflösen.

HTTP-Modus empfängt keine Ereignisse

Validieren Sie:

Signing Secret
Webhook-Pfad
Slack-Request-URLs (Events + Interaktivität + Slash-Befehle)
eindeutiger webhookPath pro HTTP-Konto

Wenn signingSecretStatus: "configured_unavailable" in Konto-Snapshots erscheint, ist das HTTP-Konto konfiguriert, aber die aktuelle Laufzeit konnte das durch SecretRef gestützte Signing Secret nicht auflösen.

Native/Slash-Befehle werden nicht ausgelöst

Prüfen Sie, ob Sie Folgendes beabsichtigt haben:

nativen Befehlsmodus (channels.slack.commands.native: true) mit passenden in Slack registrierten Slash-Befehlen
oder Modus mit einzelnem Slash-Befehl (channels.slack.slashCommand.enabled: true)

Prüfen Sie außerdem commands.useAccessGroups und Channel-/Benutzer-Allowlists.

Overview

Messaging platforms

Configuration

Slack

Slack

Kopplung

Slash-Befehle

Fehlerbehebung für Channels

Schnelleinrichtung

Manifest- und Scope-Checkliste

Zusätzliche Manifesteinstellungen

Token-Modell

Aktionen und Gates

Zugriffskontrolle und Routing

Threads, Sitzungen und Antwort-Tags

Bestätigungsreaktionen

Text-Streaming

Typing-Reaction-Fallback

Medien, Chunking und Zustellung

Befehle und Slash-Verhalten

Interaktive Antworten

Exec-Freigaben in Slack

Ereignisse und Laufzeitverhalten

Verweise auf die Konfigurationsreferenz

Fehlerbehebung

Verwandt

Overview

Messaging platforms

Configuration

​Slack

Kopplung

Slash-Befehle

Fehlerbehebung für Channels

​Schnelleinrichtung

​Manifest- und Scope-Checkliste

​Zusätzliche Manifesteinstellungen

​Token-Modell

​Aktionen und Gates

​Zugriffskontrolle und Routing

​Threads, Sitzungen und Antwort-Tags

​Bestätigungsreaktionen

​Text-Streaming

​Typing-Reaction-Fallback

​Medien, Chunking und Zustellung

​Befehle und Slash-Verhalten

​Interaktive Antworten

​Exec-Freigaben in Slack

​Ereignisse und Laufzeitverhalten

​Verweise auf die Konfigurationsreferenz

​Fehlerbehebung

​Verwandt

Slack

Schnelleinrichtung

Manifest- und Scope-Checkliste

Zusätzliche Manifesteinstellungen

Token-Modell

Aktionen und Gates

Zugriffskontrolle und Routing

Threads, Sitzungen und Antwort-Tags

Bestätigungsreaktionen

Text-Streaming

Typing-Reaction-Fallback

Medien, Chunking und Zustellung

Befehle und Slash-Verhalten

Interaktive Antworten

Exec-Freigaben in Slack

Ereignisse und Laufzeitverhalten

Verweise auf die Konfigurationsreferenz

Fehlerbehebung

Verwandt