OpenClaw

OpenClaw Slack Kanal

Unternehmen
Mittel

Verbinden Sie OpenClaw mit Slack ueber den Socket-Modus (Standard) oder die HTTP Events API. Diese Enterprise-Integration ermoeglicht Ihrem KI-Assistenten den Betrieb in Slack-Workspaces — mit Direktnachrichten, Channel-Gespraechen, Reaktionen, Threads und Slash-Befehlen. Der Socket-Modus verbindet sich per WebSocket ohne oeffentliche URL; der HTTP-Modus nutzt Slacks Events API fuer oeffentlich zugaengliche Deployments.

Kurzinfo
SchwierigkeitsgradMittel
KategorieUnternehmen
Unterstützte Funktionen5 / 6

Slack Unterstützte Funktionen

Textnachrichten

Unterstützt

Medien & Dateien

Unterstützt

Reaktionen

Unterstützt

Threads

Unterstützt

Sprachnachrichten

Nicht unterstützt

Gruppenchat

Unterstützt

Slack Voraussetzungen

  • Ein Slack-Workspace mit Administratorrechten (zur Installation benutzerdefinierter Apps)
  • Eine Slack-App, erstellt unter api.slack.com/apps
  • App Token (xapp-...) mit connections:write-Berechtigung (fuer den Socket-Modus)
  • Bot Token (xoxb-...), erhalten nach der Installation der App in Ihrem Workspace
  • OpenClaw Gateway laeuft und ist konfiguriert

Slack Schnelleinrichtung

1

Slack-App erstellen und Socket-Modus aktivieren

Gehen Sie zu api.slack.com/apps und klicken Sie auf 'Create New App' → 'From scratch'. Geben Sie der App einen Namen und waehlen Sie Ihren Workspace. Navigieren Sie in der Seitenleiste zu 'Socket Mode' und aktivieren Sie ihn. Generieren Sie ein App-Level Token mit dem Scope 'connections:write' — dies gibt Ihnen den xapp-...-Token.

2

OAuth-Berechtigungen konfigurieren und im Workspace installieren

Gehen Sie zu 'OAuth & Permissions' und fuegen Sie die erforderlichen Bot Token Scopes hinzu (chat:write, channels:history, channels:read, im:write, im:history, im:read, users:read, reactions:read, reactions:write, files:write usw.). Klicken Sie auf 'Install to Workspace' und autorisieren Sie. Kopieren Sie den Bot User OAuth Token (xoxb-...). Gehen Sie dann zu 'Event Subscriptions', aktivieren Sie Events und abonnieren Sie: message.channels, message.groups, message.im, message.mpim, app_mention, reaction_added, reaction_removed.

3

Konfiguration hinzufuegen, Gateway starten und Bot einladen

Fuegen Sie die Slack-Channel-Konfiguration zu ~/.openclaw/openclaw.json mit Ihrem appToken und botToken hinzu. Starten Sie das Gateway — es verbindet sich ueber den Socket-Modus mit Slack. Laden Sie den Bot in Ihre Ziel-Channels ein, indem Sie '/invite @IhrBotName' in Slack eingeben. Senden Sie eine Nachricht zum Testen.

Slack Konfigurationsbeispiel

config.json
{
  "channels": {
    "slack": {
      "enabled": true,
      "appToken": "xapp-1-YOUR_APP_TOKEN",
      "botToken": "xoxb-YOUR_BOT_TOKEN"
    }
  }
}

Slack Detaillierte Dokumentation

Architektur-Ueberblick

OpenClaw verbindet sich ueber zwei unterstuetzte Modi mit Slack: • Socket-Modus (Standard) — Verwendet eine WebSocket-Verbindung von Ihrem Server zu Slack. Keine oeffentliche URL oder Firewall-Konfiguration erforderlich. Ideal fuer Entwicklung, interne Deployments und Umgebungen hinter NATs. • HTTP-Modus (Events API) — Slack sendet Events an den HTTPS-Endpunkt Ihres Servers. Erfordert eine oeffentlich zugaengliche URL. Besser geeignet fuer hochverfuegbare Produktions-Deployments mit Load Balancern. In beiden Modi empfaengt der Bot Echtzeit-Events (Nachrichten, Reaktionen, Erwahnungen) und antwortet ueber die Slack API. Das Session-Routing ist kontextabhaengig: DMs verwenden die Haupt-Session des Agenten, Channel-Gespraeche erstellen isolierte Sessions pro Channel (agent:<agentId>:slack:channel:<channelId>), und Slash-Befehle erhalten Sessions pro Benutzer.
Der Socket-Modus wird fuer die meisten selbst gehosteten Setups empfohlen — er funktioniert hinter Firewalls und NATs ohne jegliche Netzwerkkonfiguration.
Sie koennen Tokens ueber Umgebungsvariablen setzen: SLACK_APP_TOKEN und SLACK_BOT_TOKEN, oder in Ihrer Konfigurationsdatei.

Ihre Slack-App erstellen

Die Einrichtung einer Slack-App erfordert die Konfiguration mehrerer Komponenten im Slack API-Portal: 1. Gehen Sie zu api.slack.com/apps und klicken Sie auf 'Create New App' → 'From scratch' 2. Benennen Sie Ihre App und waehlen Sie den Ziel-Workspace 3. Aktivieren Sie den Socket-Modus (Settings → Socket Mode → Enable). Generieren Sie ein App-Level Token mit dem Scope connections:write 4. Fuegen Sie Bot Token Scopes unter OAuth & Permissions hinzu: • chat:write, im:write — Nachrichten senden und verwalten • channels:history, groups:history, im:history, mpim:history — Nachrichtenverlauf lesen • channels:read, groups:read, im:read, mpim:read — Konversationsinformationen lesen • users:read — Benutzerprofile abfragen • reactions:read, reactions:write — Auf Nachrichten reagieren • pins:read, pins:write — Angepinnte Nachrichten verwalten • emoji:read — Benutzerdefinierte Emoji auflisten • files:write — Dateien hochladen 5. Installieren Sie die App in Ihrem Workspace und kopieren Sie den Bot Token (xoxb-...) 6. Aktivieren Sie Event Subscriptions und abonnieren Sie Bot-Events: • message.channels, message.groups, message.im, message.mpim • app_mention • reaction_added, reaction_removed • member_joined_channel, member_left_channel • channel_rename, pin_added, pin_removed 7. Optional: Erstellen Sie einen /openclaw Slash-Befehl unter Slash Commands 8. Aktivieren Sie den Messages Tab unter App Home fuer DM-Unterstuetzung Tipp: Sie koennen das bereitgestellte App-Manifest verwenden, um alle Scopes und Events bei der App-Erstellung automatisch zu konfigurieren.
Halten Sie Ihre Tokens geheim. Der App Token (xapp-...) und der Bot Token (xoxb-...) gewaehren volle Kontrolle ueber Ihre App. Bei Kompromittierung generieren Sie diese sofort im Slack API-Portal neu.
Die Manifest-Option bei der App-Erstellung kann alle erforderlichen Scopes, Events und Funktionen in einem Schritt einrichten.
Stellen Sie sicher, dass Sie Event Subscriptions aktivieren und die erforderlichen Bot-Events abonnieren. Ohne dies verbindet sich der Bot, empfaengt aber keine Nachrichten.

DM-Sicherheit (Pairing)

Slack-DM-Richtlinien steuern, wer mit Ihrem KI-Assistenten in Direktnachrichten interagieren kann. OpenClaw unterstuetzt zwei Modi: • Pairing (Standard) — Unbekannte DM-Absender erhalten einen zeitlich begrenzten Pairing-Code (laeuft nach 1 Stunde ab). Genehmigen Sie ueber 'openclaw pairing approve slack <code>' in Ihrem Terminal. Nach der Genehmigung koennen sie frei chatten. Maximal 3 ausstehende Pairing-Anfragen pro Channel. • Open — Jeder, der dem Bot eine DM schreibt, erhaelt eine Antwort. Erfordert dm.allowFrom=["*"] zur Funktion. Mit Vorsicht in grossen Workspaces verwenden. Erlaubnislisten-Eintraege unterstuetzen mehrere Formate: • Slack User-IDs (z.B. "U01ABCDEF") • @Benutzername-Referenzen • E-Mail-Adressen Sie koennen ausstehende Pairings auch mit 'openclaw pairing list slack' pruefen.
openclaw.json
{
  "channels": {
    "slack": {
      "enabled": true,
      "appToken": "xapp-...",
      "botToken": "xoxb-...",
      "dm": {
        "policy": "pairing",
        "allowFrom": ["U01ABCDEF", "user@company.com"]
      }
    }
  }
}
Verwenden Sie die Pairing-Richtlinie fuer Workspaces mit vielen Benutzern, um unbefugte KI-Nutzung zu verhindern. Jeder Pairing-Code laeuft nach 1 Stunde ab.
Im Open-Modus setzen Sie allowFrom auf ["*"], um alle Benutzer zuzulassen, oder geben Sie einzelne User-IDs/E-Mails an, um den Zugang einzuschraenken.

Channel-Konfiguration (Gruppenrichtlinie)

Channel-Richtlinien steuern, in welchen Slack-Channels der Bot arbeitet und wie er sich verhaelt: Uebergeordnete groupPolicy: • open — Bot antwortet in allen Channels, in die er eingeladen wurde • disabled — Bot ignoriert alle Channel-Nachrichten • allowlist — Bot antwortet nur in explizit konfigurierten Channels Pro-Channel-Konfiguration ermoeglicht die Feinabstimmung des Verhaltens fuer einzelne Channels: • allow — Channel im Allowlist-Modus aktivieren/deaktivieren • requireMention — Ob der Bot @erwaehnt werden muss, um zu antworten • users — Benutzer-Erlaubnisliste fuer diesen bestimmten Channel • skills — Verfuegbare Skills/Tools in diesem Channel einschraenken • systemPrompt — Benutzerdefinierte KI-Anweisungen fuer diesen Channel • allowBots — Ob Nachrichten von anderen Bots verarbeitet werden (Standard: false) • enabled — Channel vollstaendig aktivieren/deaktivieren
openclaw.json
{
  "channels": {
    "slack": {
      "groupPolicy": "allowlist",
      "channels": {
        "C01ABCDEF": {
          "allow": true,
          "requireMention": true,
          "users": ["U01ABCDEF"],
          "skills": ["search", "docs"],
          "systemPrompt": "Antworten kurz und technisch halten."
        },
        "#general": {
          "allow": true,
          "requireMention": true
        }
      }
    }
  }
}
Channel-Schluessel koennen entweder Channel-IDs (C01ABCDEF) oder Channel-Namen (#general) sein. IDs sind zuverlaessiger, da sie Channel-Umbenennungen ueberstehen.
Verwenden Sie pro-Channel systemPrompt, um der KI verschiedene Persoenlichkeiten oder Anweisungen fuer verschiedene Channels zu geben — z.B. technisch in #engineering, locker in #watercooler.

Antwort-Threading

OpenClaw unterstuetzt flexibles Antwort-Threading in Slack und steuert, ob der Bot im Hauptkanal antwortet oder Threads erstellt. Globaler replyToMode: • off (Standard) — Antworten im Hauptkanal. Threads werden nur erstellt, wenn die ausloesende Nachricht bereits in einem Thread ist. • first — Erste Antwort geht in einen Thread, nachfolgende Antworten gehen in den Hauptkanal. • all — Alle Antworten werden als Thread-Antworten gesendet. Pro-Chat-Typ-Ueberschreibungen ueber replyToModeByChatType: • direct — 1:1 DM-Gespraeche • group — Gruppen-DM / MPIM-Gespraeche • channel — Standard-Slack-Channels Manuelle Thread-Steuerung ueber Antwort-Tags: • [[reply_to_current]] — Auf die ausloesende Nachricht antworten • [[reply_to:<message_id>]] — Auf eine bestimmte Nachrichten-ID antworten
openclaw.json
{
  "channels": {
    "slack": {
      "replyToMode": "off",
      "replyToModeByChatType": {
        "direct": "all",
        "group": "first",
        "channel": "off"
      }
    }
  }
}
Fuer stark frequentierte Channels verwenden Sie replyToMode: 'all', um Gespraeche in Threads zu organisieren und den Hauptkanal nicht zu ueberladen.
Pro-Chat-Typ-Ueberschreibungen ermoeglichen es, DMs zu threaden, aber Channel-Antworten inline zu halten, oder umgekehrt.

User Token (Optional)

Zusaetzlich zum Bot Token koennen Sie optional einen User Token (xoxp-...) fuer erweiterten Lesezugriff konfigurieren. Der User Token bietet reichhaltigere Daten fuer Verlauf, Pins, Reaktionen, benutzerdefinierte Emoji und Mitgliederinformationen. Token-Nutzungsprioritaet: • Leseoperationen — User Token wird bevorzugt; Fallback auf Bot Token wenn nicht verfuegbar • Schreiboperationen — Bot Token wird standardmaessig immer verwendet Das Flag userTokenReadOnly (Standard: true) stellt sicher, dass der User Token niemals fuer Schreiboperationen verwendet wird. Setzen Sie es nur auf false, wenn die KI als Benutzer agieren soll (erfordert zusaetzliche Schreib-Scopes auf dem User Token). Um einen User Token hinzuzufuegen, konfigurieren Sie User Token Scopes unter OAuth & Permissions unter 'User Token Scopes' — typischerweise Nur-Lese-Scopes wie channels:history, channels:read, users:read, reactions:read, pins:read, emoji:read, search:read.
openclaw.json
{
  "channels": {
    "slack": {
      "enabled": true,
      "appToken": "xapp-...",
      "botToken": "xoxb-...",
      "userToken": "xoxp-...",
      "userTokenReadOnly": true
    }
  }
}
Das Setzen von userTokenReadOnly auf false ermoeglicht der KI, Schreiboperationen (Nachrichten senden, Reaktionen hinzufuegen, Nachrichten anheften) als der installierende Benutzer statt als Bot durchzufuehren. Aktivieren Sie dies nur, wenn Sie die Sicherheitsauswirkungen verstehen.

Slash-Befehle & App Home

OpenClaw unterstuetzt Slack Slash-Befehle und App Home-Konfiguration: Slash-Befehle: Erstellen Sie einen /openclaw-Befehl im Slack API-Portal unter 'Slash Commands'. Im Socket-Modus wird keine Request-URL benoetigt — Slack leitet den Befehl ueber die WebSocket-Verbindung weiter. Falls native Befehle verwendet werden, erstellen Sie bei Bedarf zusaetzliche Slash-Befehle. App Home: Aktivieren Sie den 'Messages Tab' unter App Home, um Benutzern das direkte Schreiben an den Bot von dessen App-Seite zu ermoeglichen. Dies bietet eine saubere, dedizierte Oberflaeche fuer 1:1-Gespraeche. Session-Routing: • DMs → Haupt-Session (agent:main:main) • Channel-Nachrichten → agent:<agentId>:slack:channel:<channelId> • Slash-Befehle → agent:<agentId>:slack:slash:<userId> Zustellziele fuer Cron/CLI: • user:<userId> — DM an einen bestimmten Benutzer senden • channel:<channelId> — In einen bestimmten Channel posten
openclaw.json
{
  "channels": {
    "slack": {
      "slashCommand": {
        "enabled": true,
        "name": "openclaw",
        "sessionPrefix": "slack:slash",
        "ephemeral": true
      }
    }
  }
}
Ephemere Slash-Befehl-Antworten sind nur fuer den Benutzer sichtbar, der den Befehl aufgerufen hat. Setzen Sie ephemeral: false, um Antworten fuer alle im Channel sichtbar zu machen.
Der Messages Tab in App Home muss fuer die DM-Funktionalitaet aktiviert sein — ohne ihn koennen Benutzer keine Gespraeche mit dem Bot starten.

Berechtigungen & Scopes

Slack verwendet OAuth-Scopes, um zu steuern, was Ihre App tun kann. Hier sind die erforderlichen und optionalen Scopes: Erforderliche Bot Token Scopes: • chat:write — Nachrichten senden, aktualisieren und loeschen • im:write — DM-Gespraeche oeffnen • channels:history, groups:history, im:history, mpim:history — Nachrichtenverlauf lesen • channels:read, groups:read, im:read, mpim:read — Konversationsinformationen lesen • users:read — Benutzerprofile abfragen • reactions:read, reactions:write — Reaktionen lesen und hinzufuegen • pins:read, pins:write — Angepinnte Nachrichten verwalten • emoji:read — Benutzerdefinierte Workspace-Emoji auflisten • files:write — Dateien und Medien hochladen Optionale User Token Scopes (nur lesen): • channels:history, groups:history, im:history, mpim:history — Erweiterter Verlaufszugriff • channels:read, groups:read, im:read, mpim:read — Erweiterte Konversationsinformationen • users:read — Benutzerprofilabfrage • reactions:read, pins:read, emoji:read — Reaktionen, Pins, Emoji lesen • search:read — Nachrichten und Dateien durchsuchen
Beginnen Sie nur mit den Bot Token Scopes. Fuegen Sie den User Token und seine Scopes nur hinzu, wenn Sie erweiterte Lesefaehigkeiten benoetigen (wie search:read).
Das bereitgestellte App-Manifest enthaelt alle empfohlenen Scopes — verwenden Sie es bei der App-Erstellung fuer die schnellste Einrichtung.

HTTP-Modus (Events API)

Wenn Ihr Gateway oeffentlich ueber HTTPS erreichbar ist, koennen Sie den HTTP-Modus anstelle des Socket-Modus verwenden. Im HTTP-Modus sendet Slack Events direkt an Ihren Server-Endpunkt. Einrichtungsschritte: 1. Erstellen Sie die Slack-App, aktivieren Sie aber NICHT den Socket-Modus 2. Holen Sie das Signing Secret unter 'Basic Information' → 'App Credentials' 3. Installieren Sie die App, um den Bot Token zu erhalten 4. Setzen Sie unter 'Event Subscriptions' die Request URL auf: https://ihr-gateway-host/slack/events 5. Setzen Sie unter 'Interactivity & Shortcuts' dieselbe Request URL 6. Setzen Sie unter 'Slash Commands' die Request URL auf denselben Endpunkt Der HTTP-Modus benoetigt keinen App Token — er verwendet das Signing Secret, um zu verifizieren, dass eingehende Anfragen tatsaechlich von Slack stammen.
openclaw.json
{
  "channels": {
    "slack": {
      "enabled": true,
      "mode": "http",
      "botToken": "xoxb-...",
      "signingSecret": "your-signing-secret",
      "webhookPath": "/slack/events"
    }
  }
}
Fuer den HTTP-Modus sollten alle drei Endpunkte (Events, Interactivity, Slash Commands) auf dieselbe URL zeigen: https://ihr-host/slack/events.
Verwenden Sie das Signing Secret (nicht den App Token) fuer den HTTP-Modus. Das Signing Secret verifiziert die Authentizitaet von Anfragen ueber HMAC-SHA256-Signaturen.
Der HTTP-Modus erfordert ein gueltiges SSL-Zertifikat und einen oeffentlich zugaenglichen Endpunkt. Stellen Sie sicher, dass Ihr Server von Slacks IP-Bereichen erreichbar ist.

Erweiterte Konfiguration

OpenClaw bietet mehrere erweiterte Einstellungen zur Feinabstimmung des Slack-Verhaltens: Verlauf & Kontext: • historyLimit (Standard: 50) — Anzahl der letzten Nachrichten, die im KI-Kontext enthalten sind. Auf 0 setzen, um die Verlaufsinjektion zu deaktivieren. Text & Medien: • textChunkLimit (Standard: 4000) — Maximale Zeichen pro Nachrichtenblock fuer lange Antworten • chunkMode: "newline" — An Absatzgrenzen aufteilen statt an harten Zeichenlimits • mediaMaxMb (Standard: 20) — Maximale Mediendateigroesse in Megabyte Tool-Aktions-Gates: Steuern Sie, welche Slack-Operationen der Agent ausfuehren kann: • reactions: true — Reaktionen hinzufuegen und auflisten • messages: true — Nachrichten lesen, senden, bearbeiten und loeschen • pins: true — Nachrichten anheften, loesentfixieren und angepinnte auflisten • memberInfo: true — Workspace-Mitgliederinformationen abfragen • emojiList: true — Benutzerdefinierte Workspace-Emoji auflisten Sicherheitshinweise: • Schreiboperationen verwenden standardmaessig den Bot Token und wahren die Berechtigungsisolierung auf Anwendungsebene • Wenn userTokenReadOnly false ist und ein User Token konfiguriert ist, koennen Schreibvorgaenge den User Token verwenden (als installierender Benutzer agierend) • Wenn allowBots in einem Channel aktiviert wird, kombinieren Sie es mit requireMention und Benutzer-Erlaubnislisten, um Bot-zu-Bot-Antwortschleifen zu verhindern
openclaw.json
{
  "channels": {
    "slack": {
      "historyLimit": 50,
      "textChunkLimit": 4000,
      "chunkMode": "newline",
      "mediaMaxMb": 20,
      "actions": {
        "reactions": true,
        "messages": true,
        "pins": true,
        "memberInfo": true,
        "emojiList": true
      }
    }
  }
}

Slack Konfigurationsreferenz

enabled
Type: booleanDefault: true

Slack-Channel aktivieren oder deaktivieren

mode
Type: stringDefault: "socket"

Verbindungsmodus. Optionen: socket (Socket-Modus, Standard), http (Events API)

appToken
Type: stringDefault: ""

Slack App-Level Token (xapp-...) fuer den Socket-Modus. Alternativ Umgebungsvariable SLACK_APP_TOKEN

botToken
Type: stringDefault: ""

Slack Bot User OAuth Token (xoxb-...). Alternativ Umgebungsvariable SLACK_BOT_TOKEN

userToken
Type: stringDefault: ""

Optionaler Slack User Token (xoxp-...) fuer erweiterten Lesezugriff

userTokenReadOnly
Type: booleanDefault: true

User Token auf Nur-Lese-Operationen beschraenken. Auf false setzen, um Schreibzugriff als installierender Benutzer zu ermoeglichen

signingSecret
Type: stringDefault: ""

Signing Secret fuer die Verifizierung von HTTP-Modus-Anfragen (aus Basic Information → App Credentials)

webhookPath
Type: stringDefault: "/slack/events"

Webhook-Endpunktpfad fuer den HTTP-Modus

dm.policy
Type: stringDefault: "pairing"

DM-Zugriffssteuerungsrichtlinie. Optionen: pairing (Code-basierte Genehmigung), open (jeder kann DMs senden)

dm.allowFrom
Type: string[]Default: []

Benutzer, die dem Bot DMs senden duerfen. Unterstuetzt User-IDs, @Benutzernamen, E-Mails und Platzhalter (*)

dm.enabled
Type: booleanDefault: true

Ob Direktnachrichten akzeptiert werden

dm.groupEnabled
Type: booleanDefault: false

Gruppen-DM (MPIM)-Verarbeitung aktivieren

dm.groupChannels
Type: string[]Default: []

Erlaubte Gruppen-DM-Channel-IDs

groupPolicy
Type: stringDefault: "open"

Channel-Verarbeitungsrichtlinie. Optionen: open (alle Channels), disabled (keine Channels), allowlist (nur konfigurierte)

channels.<id>.allow
Type: booleanDefault: true

Diesen Channel im Allowlist-Modus erlauben oder verweigern

channels.<id>.requireMention
Type: booleanDefault: false

Ob der Bot in diesem Channel @erwaehnt werden muss, um zu antworten

channels.<id>.users
Type: string[]Default: []

Benutzer-Erlaubnisliste fuer diesen Channel (IDs, @Benutzernamen oder E-Mails)

channels.<id>.skills
Type: string[]Default: []

Verfuegbare Skills in diesem Channel einschraenken (leer = alle Skills)

channels.<id>.systemPrompt
Type: stringDefault: ""

Benutzerdefinierter KI-System-Prompt fuer diesen Channel

channels.<id>.allowBots
Type: booleanDefault: false

Nachrichten von anderen Bots in diesem Channel verarbeiten

replyToMode
Type: stringDefault: "off"

Antwort-Threading-Modus. Optionen: off (Hauptkanal), first (erste Antwort threaden), all (alle Antworten threaden)

replyToModeByChatType
Type: objectDefault: {}

Pro-Chat-Typ-Threading-Ueberschreibungen. Schluessel: direct, group, channel. Werte: off, first, all

reactionNotifications
Type: stringDefault: "off"

Welche Reaktionen Agenten-Benachrichtigungen ausloesen. Optionen: off, own, all

historyLimit
Type: numberDefault: 50

Anzahl der letzten Nachrichten, die als KI-Kontext einbezogen werden. Auf 0 setzen zum Deaktivieren

textChunkLimit
Type: numberDefault: 4000

Maximale Zeichen pro Nachrichtenblock fuer lange KI-Antworten

chunkMode
Type: stringDefault: "split"

Wie lange Antworten aufgeteilt werden. Optionen: split (hartes Limit), newline (Absatzgrenzen)

mediaMaxMb
Type: numberDefault: 20

Maximale Mediendateigroesse in Megabyte

slashCommand.enabled
Type: booleanDefault: true

Slash-Befehl-Verarbeitung aktivieren

slashCommand.name
Type: stringDefault: "openclaw"

Der Slash-Befehlsname (ohne /)

slashCommand.ephemeral
Type: booleanDefault: true

Ob Slash-Befehl-Antworten nur fuer den Aufrufer sichtbar sind

Slack Häufig gestellte Fragen

Slack Fehlerbehebung

Bot antwortet nicht in Channels

Der Channel wird durch groupPolicy blockiert, oder der Bot ist nicht in der Erlaubnisliste, oder der Bot wurde nicht in den Channel eingeladen.

Ueberpruefen Sie Ihre groupPolicy-Einstellung. Bei Verwendung von 'allowlist' stellen Sie sicher, dass die Channel-ID oder der Name mit 'allow: true' konfiguriert ist. Verifizieren Sie, dass der Bot in den Channel eingeladen wurde (/invite @IhrBotName). Pruefen Sie die Gateway-Logs auf 'blocked by group policy'-Meldungen.
DMs an den Bot werden ignoriert

Die DM-Richtlinie ist auf 'pairing' gesetzt und der Absender wurde nicht genehmigt, oder der Messages Tab ist in App Home nicht aktiviert.

Bei Verwendung des Pairing-Modus pruefen Sie ausstehende Pairings mit 'openclaw pairing list slack' und genehmigen Sie ueber 'openclaw pairing approve slack <code>'. Aktivieren Sie den Messages Tab in App Home (Slack API-Portal → App Home → Show Tab). Stellen Sie sicher, dass dm.policy nicht auf 'disabled' gesetzt ist.
Socket-Modus-Verbindung schlaegt fehl oder trennt sich wiederholt

Der App Token (xapp-...) ist ungueltig oder abgelaufen, oder es gibt ein Netzwerkproblem zwischen Ihrem Server und Slack.

Verifizieren Sie, dass Ihr App Token korrekt ist und den Scope connections:write hat. Generieren Sie den App Token bei Bedarf im Slack API-Portal neu. Pruefen Sie die Gateway-Logs auf WebSocket-Verbindungsfehler. Stellen Sie sicher, dass Ihr Server stabilen Internetzugang zu wss://wss-primary.slack.com hat.
API-Fehler (missing_scope oder invalid_auth)

Dem Bot Token fehlen erforderliche OAuth-Scopes, oder der Token wurde widerrufen/neu generiert.

Gehen Sie zu OAuth & Permissions im Slack API-Portal und verifizieren Sie, dass alle erforderlichen Scopes hinzugefuegt sind. Wenn Scopes kuerzlich hinzugefuegt wurden, installieren Sie die App erneut in Ihrem Workspace, um die neuen Berechtigungen anzuwenden. Pruefen Sie, ob der Token in Ihrer Konfiguration mit dem aktuellen Token im Portal uebereinstimmt.
Slash-Befehle zeigen 'dispatch_failed' oder erscheinen nicht

Der Slash-Befehl wurde nicht im Slack API-Portal erstellt, oder die Request-URL ist falsch konfiguriert (HTTP-Modus).

Erstellen Sie den /openclaw-Befehl unter Slash Commands im API-Portal. Fuer den Socket-Modus wird keine URL benoetigt. Fuer den HTTP-Modus setzen Sie die Request URL auf https://ihr-host/slack/events. Nach dem Hinzufuegen des Befehls muessen Sie die App moeglicherweise erneut im Workspace installieren.
Nachrichten werden abgeschnitten oder als mehrere Bloecke gesendet

Lange KI-Antworten, die das textChunkLimit von OpenClaw (Standard: 4.000 Zeichen) ueberschreiten, werden automatisch in mehrere Nachrichten aufgeteilt. Hinweis: Slacks eigene Limits sind 3.000 Zeichen pro Section Block und 40.000 Zeichen pro Nachrichten-Textfeld.

Dies ist erwartetes Verhalten. Passen Sie textChunkLimit an, um die Blockgroesse zu steuern (Standard: 4000). Setzen Sie chunkMode auf 'newline', um an Absatzgrenzen aufzuteilen fuer natuerlichere Aufteilung. Erwaegen Sie, die KI ueber systemPrompt anzuweisen, Antworten kurz zu halten.
Vollständige Dokumentation anzeigenZurück zu allen Kanälen

Verwandte Kanäle

Feishu / Lark

Medium

OpenClaw Feishu/Lark-Integration ueber WebSocket

Einrichtungsanleitung

Google Chat

Medium

OpenClaw Google Chat API-App ueber HTTP-Endpunkt

Einrichtungsanleitung

Microsoft Teams

Medium

OpenClaw Unternehmensintegration ueber Bot Framework

Einrichtungsanleitung