​

Slack

​

Schnelleinrichtung

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

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

openclaw gateway

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

​

Checkliste für Manifest und Scopes

{
  "display_information": {
    "name": "OpenClaw",
    "description": "Slack connector for 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": "Send a message to OpenClaw",
        "should_escape": false
      }
    ]
  },
  "oauth_config": {
    "scopes": {
      "bot": [
        "app_mentions:read",
        "assistant:write",
        "channels:history",
        "channels:read",
        "chat:write",
        "commands",
        "emoji:read",
        "files:read",
        "files:write",
        "groups:history",
        "groups:read",
        "im:history",
        "im:read",
        "im:write",
        "mpim:history",
        "mpim:read",
        "mpim:write",
        "pins:read",
        "pins:write",
        "reactions:read",
        "reactions:write",
        "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"
      ]
    }
  }
}

​

Token-Modell

• botToken + appToken sind für Socket Mode erforderlich.
• HTTP-Modus erfordert botToken + signingSecret.
• botToken, appToken, signingSecret und userToken akzeptieren Klartext- Zeichenfolgen oder SecretRef-Objekte.
• Konfigurations-Tokens ü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).
• Optional: Fügen Sie chat:write.customize hinzu, wenn ausgehende Nachrichten die aktive Agentenidentität verwenden sollen (benutzerdefinierter username und Symbol). icon_emoji verwendet die Syntax :emoji_name:.

• Die Inspektion von Slack-Konten verfolgt pro Anmeldedaten die Felder *Source und *Status (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; in Socket Mode ist das erforderliche Paar botTokenStatus + appTokenStatus.

​

Aktionen und Gates

​

Zugriffskontrolle und Routing

​

Threading, Sitzungen und Antwort-Tags

• DMs werden als direct geroutet; Kanäle als channel; MPIMs als group.
• Mit dem Standard session.dmScope=main werden Slack-DMs auf die Agenten-Hauptsitzung reduziert.
• Kanalsitzungen: agent:<agentId>:slack:channel:<channelId>.
• Thread-Antworten können Suffixe für Thread-Sitzungen (:thread:<threadTs>) erzeugen, wenn anwendbar.
• Der Standardwert von channels.slack.thread.historyScope ist thread; thread.inheritParent ist standardmäßig false.
• channels.slack.thread.initialHistoryLimit steuert, wie viele vorhandene Thread-Nachrichten abgerufen werden, wenn eine neue Thread-Sitzung startet (Standard 20; auf 0 setzen, um zu deaktivieren).

• channels.slack.replyToMode: off|first|all (Standard off)
• channels.slack.replyToModeByChatType: pro direct|group|channel
• veralteter Fallback für Direktchats: channels.slack.dm.replyToMode

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

​

Bestätigungsreaktionen

• channels.slack.accounts.<accountId>.ackReaction
• channels.slack.ackReaction
• messages.ackReaction
• Fallback auf Agentenidentitäts-Emoji (agents.list[].identity.emoji, sonst ”👀”)

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

​

Text-Streaming

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

• Ein Antwort-Thread muss verfügbar sein, damit natives Text-Streaming angezeigt wird. Die Thread-Auswahl folgt weiterhin replyToMode. Ohne Thread wird die normale Entwurfsvorschau verwendet.
• Medien und Nicht-Text-Payloads fallen auf normale Zustellung zurück.
• Wenn Streaming mitten in einer Antwort fehlschlägt, fällt OpenClaw für verbleibende Payloads auf normale Zustellung zurück.

{
  channels: {
    slack: {
      streaming: "partial",
      nativeStreaming: false,
    },
  },
}

• channels.slack.streamMode (replace | status_final | append) wird automatisch nach channels.slack.streaming migriert.
• boolean channels.slack.streaming wird automatisch nach channels.slack.nativeStreaming migriert.

​

Fallback für Schreibreaktion

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

• Slack erwartet Shortcodes (zum Beispiel "hourglass_flowing_sand").
• Die Reaktion erfolgt nach bestem Bemühen, und die Bereinigung wird nach Abschluss des Antwort- oder Fehlerpfads automatisch versucht.

​

Medien, Chunking und Zustellung

​

Befehle und Slash-Verhalten

• Der native Befehls-Automatikmodus ist für Slack deaktiviert (commands.native: "auto" aktiviert keine nativen Slack-Befehle).
• Aktivieren Sie native Slack-Befehlshandler mit channels.slack.commands.native: true (oder global commands.native: true).
• Wenn native Befehle aktiviert sind, registrieren Sie passende Slash-Befehle in Slack (/<command>-Namen), mit einer Ausnahme:
  • registrieren Sie /agentstatus für den Statusbefehl (Slack reserviert /status)
• Wenn native Befehle nicht aktiviert sind, können Sie einen einzelnen konfigurierten Slash-Befehl über channels.slack.slashCommand ausführen.
• Native Argumentmenüs passen ihre Darstellungsstrategie jetzt an:
  • bis zu 5 Optionen: Button-Blöcke
  • 6-100 Optionen: statisches Select-Menü
  • mehr als 100 Optionen: externes Select mit asynchroner Optionsfilterung, wenn Interactivity-Option-Handler verfügbar sind
  • wenn kodierte Optionswerte die Slack-Grenzen überschreiten, fällt der Ablauf auf Buttons zurück
• Für lange Options-Payloads verwenden Slash-command-Argumentmenüs einen Bestätigungsdialog, bevor ein ausgewählter Wert ausgeführt wird.

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

• agent:<agentId>:slack:slash:<userId>

​

Interaktive Antworten

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

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

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

• Dies ist Slack-spezifische UI. Andere Kanäle übersetzen Slack-Block-Kit-Direktiven nicht in ihre eigenen Button-Systeme.
• Die interaktiven Callback-Werte sind von OpenClaw generierte opake Tokens, keine vom Agenten roh verfassten Werte.
• Wenn generierte interaktive Blöcke die Grenzen von Slack Block Kit überschreiten würden, fällt OpenClaw auf die ursprüngliche Textantwort zurück, statt eine ungültige Blocks-Payload zu senden.

​

Exec-Freigaben in Slack

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

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

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

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

​

Ereignisse und betriebliches Verhalten

• Bearbeitungen/Löschungen von Nachrichten sowie Thread-Broadcasts werden in Systemereignisse umgewandelt.
• Ereignisse zum Hinzufügen/Entfernen von Reaktionen werden in Systemereignisse umgewandelt.
• Ereignisse zum Beitreten/Verlassen von Mitgliedern, Erstellen/Umbenennen von Kanälen und Hinzufügen/Entfernen von Pins werden in Systemereignisse umgewandelt.
• channel_id_changed kann Kanalkonfigurationsschlüssel migrieren, wenn configWrites aktiviert ist.
• Metadaten zu Kanalthema/-zweck werden als nicht vertrauenswürdiger Kontext behandelt und können in den Routing-Kontext eingespeist werden.
• Kontext-Seeding für Thread-Starter und initialen Thread-Verlauf wird, wenn anwendbar, anhand konfigurierter Sender-Allowlists gefiltert.
• Block-Aktionen und Modal-Interaktionen erzeugen strukturierte Systemereignisse Slack interaction: ... mit umfangreichen Payload-Feldern:
  • Block-Aktionen: ausgewählte Werte, Beschriftungen, Picker-Werte und workflow_*-Metadaten
  • Modal-Ereignisse view_submission und view_closed mit gerouteten Kanalmetadaten und Formulareingaben

​

Verweise auf die Konfigurationsreferenz

• Configuration reference - Slack Wichtige Slack-Felder:
  • Modus/Auth: mode, botToken, appToken, signingSecret, webhookPath, accounts.*
  • DM-Zugriff: dm.enabled, dmPolicy, allowFrom (veraltet: dm.policy, dm.allowFrom), dm.groupEnabled, dm.groupChannels
  • Kompatibilitätsschalter: dangerouslyAllowNameMatching (Notfalloption; deaktiviert lassen, wenn nicht nötig)
  • Kanalzugriff: groupPolicy, channels.*, channels.*.users, channels.*.requireMention
  • Threading/Verlauf: replyToMode, replyToModeByChatType, thread.*, historyLimit, dmHistoryLimit, dms.*.historyLimit
  • Zustellung: textChunkLimit, chunkMode, mediaMaxMb, streaming, nativeStreaming
  • Betrieb/Funktionen: configWrites, commands.native, slashCommand.*, actions.*, userToken, userTokenReadOnly

​

Fehlerbehebung

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

openclaw pairing list slack

​

Verwandt

• Pairing
• Groups
• Security
• Channel routing
• Troubleshooting
• Configuration
• Slash commands