Slack

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

# Socket Mode oder HTTP Request URLs auswählen

Beide Transporte sind produktionsreif und erreichen Feature-Parität für Messaging, Slash Commands, App Home und Interaktivität. Wählen Sie anhand der Bereitstellungsform, nicht anhand der Funktionen.

# Schnelleinrichtung

{
"display_information": {
"name": "OpenClaw",
"description": "Slack connector for 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
},
"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",
"usergroups:read",
"users:read"
]
}
},
"settings": {
"socket_mode_enabled": true,
"event_subscriptions": {
"bot_events": [
"app_home_opened",
"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 connector for 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
},
"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",
"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",
"message.channels",
"message.groups",
"message.im"
]
}
}
}

export SLACK_APP_TOKEN=xapp-...
export SLACK_BOT_TOKEN=xoxb-...
cat > 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" },
},
},
}
JSON5
openclaw config patch --file ./slack.socket.patch.json5 --dry-run
openclaw config patch --file ./slack.socket.patch.json5

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

openclaw gateway

{
"display_information": {
"name": "OpenClaw",
"description": "Slack connector for 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
},
"slash_commands": [
{
"command": "/openclaw",
"description": "Send a message to OpenClaw",
"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",
"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 for 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
},
"slash_commands": [
{
"command": "/openclaw",
"description": "Send a message to OpenClaw",
"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",
"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=xoxb-...
export 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",
},
},
}
JSON5
openclaw config patch --file ./slack.http.patch.json5 --dry-run
openclaw config patch --file ./slack.http.patch.json5

openclaw gateway

# Transport-Optimierung 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 Sie Workspace- oder Host-spezifische Anpassungen benötigen:

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

Verwenden Sie dies nur für Socket-Mode-Workspaces, die Slack-Websocket-Pong- oder Server-Ping-Timeouts protokollieren, oder für Hosts mit bekannter Event-Loop-Überlastung. clientPingTimeout ist die Wartezeit auf Pong, nachdem das SDK einen Client-Ping gesendet hat; serverPingTimeout ist die Wartezeit auf Slack-Server-Pings. App-Nachrichten und Events bleiben Anwendungszustand, keine Signale für Transport-Liveness.

# Checkliste für Manifest und Scopes

Das Basis-Manifest der Slack-App ist für Socket Mode und HTTP Request URLs gleich. Nur der settings-Block (und die Slash-Befehl-url) unterscheidet sich.

Basis-Manifest (Socket Mode Standard):

{
  "display_information": {
    "name": "OpenClaw",
    "description": "Slack connector for 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
    },
    "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",
        "usergroups:read",
        "users:read"
      ]
    }
  },
  "settings": {
    "socket_mode_enabled": true,
    "event_subscriptions": {
      "bot_events": [
        "app_home_opened",
        "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"
      ]
    }
  }
}

Für den HTTP Request URLs-Modus ersetzen Sie settings durch die HTTP-Variante und fügen jedem Slash-Befehl url hinzu. Öffentliche URL erforderlich:

{
  "features": {
    "slash_commands": [
      {
        "command": "/openclaw",
        "description": "Send a message to OpenClaw",
        "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",
        "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 Standards erweitern.

Das Standard-Manifest aktiviert den Slack-App-Home-Tab Home und abonniert app_home_opened. Wenn ein Workspace-Mitglied den Home-Tab öffnet, veröffentlicht OpenClaw mit views.publish eine sichere Standard-Home-Ansicht; es sind keine Konversations-Payloads oder privaten Konfigurationen enthalten. Der Tab Messages bleibt für Slack-DMs aktiviert.

{
"slash_commands": [
{
"command": "/new",
"description": "Start a new session",
"usage_hint": "[model]"
},
{
"command": "/reset",
"description": "Reset the current session"
},
{
"command": "/compact",
"description": "Compact the session context",
"usage_hint": "[instructions]"
},
{
"command": "/stop",
"description": "Stop the current run"
},
{
"command": "/session",
"description": "Manage thread-binding expiry",
"usage_hint": "idle <duration|off> or max-age <duration|off>"
},
{
"command": "/think",
"description": "Set the thinking level",
"usage_hint": "<level>"
},
{
"command": "/verbose",
"description": "Toggle verbose output",
"usage_hint": "on|off|full"
},
{
"command": "/fast",
"description": "Show or set fast mode",
"usage_hint": "[status|on|off]"
},
{
"command": "/reasoning",
"description": "Toggle reasoning visibility",
"usage_hint": "[on|off|stream]"
},
{
"command": "/elevated",
"description": "Toggle elevated mode",
"usage_hint": "[on|off|ask|full]"
},
{
"command": "/exec",
"description": "Show or set exec defaults",
"usage_hint": "host=<auto|sandbox|gateway|node> security=<deny|allowlist|full> ask=<off|on-miss|always> node=<id>"
},
{
"command": "/model",
"description": "Show or set the model",
"usage_hint": "[name|#|status]"
},
{
"command": "/models",
"description": "List providers/models",
"usage_hint": "[provider] [page] [limit=<n>|size=<n>|all]"
},
{
"command": "/help",
"description": "Show the short help summary"
},
{
"command": "/commands",
"description": "Show the generated command catalog"
},
{
"command": "/tools",
"description": "Show what the current agent can use right now",
"usage_hint": "[compact|verbose]"
},
{
"command": "/agentstatus",
"description": "Show runtime status, including provider usage/quota when available"
},
{
"command": "/tasks",
"description": "List active/recent background tasks for the current session"
},
{
"command": "/context",
"description": "Explain how context is assembled",
"usage_hint": "[list|detail|json]"
},
{
"command": "/whoami",
"description": "Show your sender identity"
},
{
"command": "/skill",
"description": "Run a skill by name",
"usage_hint": "<name> [input]"
},
{
"command": "/btw",
"description": "Ask a side question without changing session context",
"usage_hint": "<question>"
},
{
"command": "/side",
"description": "Ask a side question without changing session context",
"usage_hint": "<question>"
},
{
"command": "/usage",
"description": "Control the usage footer or show cost summary",
"usage_hint": "off|tokens|full|cost"
}
]
}

{
"slash_commands": [
{
"command": "/new",
"description": "Start a new session",
"usage_hint": "[model]",
"url": "https://gateway-host.example.com/slack/events"
},
{
"command": "/help",
"description": "Show the short help summary",
"url": "https://gateway-host.example.com/slack/events"
}
]
}

# Token-Modell

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

Verhalten des Status-Snapshots:

• Die Slack-Kontoprüfung 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 angegebene Geheimnisquelle konfiguriert ist, der aktuelle Befehls-/Runtime-Pfad den tatsächlichen Wert jedoch nicht auflösen konnte.
• Im HTTP-Modus ist signingSecretStatus enthalten; im Socket Mode ist das erforderliche Paar botTokenStatus + appTokenStatus.

# Aktionen und Gates

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

Verfügbare Aktionsgruppen im aktuellen Slack-Tooling:

Aktuelle 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 eingehenden Datei-Platzhaltern angezeigt werden, und gibt Bildvorschauen für Bilder oder lokale Dateimetadaten für andere Dateitypen zurück.

# Zugriffskontrolle und Routing

# Threading, Sitzungen und Antwort-Tags

• DMs werden als direct geroutet; Channels als channel; MPIMs als group.
• Slack-Routenbindungen akzeptieren rohe Peer-IDs sowie Slack-Zielformen wie channel:C12345678, user:U12345678 und <@U12345678>.
• Mit dem Standard session.dmScope=main werden Slack-DMs auf die Hauptsitzung des Agenten zusammengeführt.
• Channel-Sitzungen: agent:<agentId>:slack:channel:<channelId>.
• Thread-Antworten können gegebenenfalls Thread-Sitzungssuffixe erstellen (:thread:<threadTs>).
• Der Standard für channels.slack.thread.historyScope ist thread; der Standard für thread.inheritParent ist 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 dies zu deaktivieren).
• channels.slack.thread.requireExplicitMention (Standard false): Wenn true, werden implizite Thread-Mentions unterdrückt, sodass der Bot innerhalb von Threads nur auf explizite @bot-Mentions antwortet, selbst wenn der Bot bereits am Thread beteiligt war. Ohne dies umgehen Antworten in einem Thread, an dem der Bot beteiligt ist, das requireMention-Gate.

Steuerung 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>]]

# Ack-Reaktionen

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
• Agentenidentitäts-Emoji-Fallback (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 Live-Vorschau-Verhalten:

• off: Live-Vorschau-Streaming deaktivieren.
• partial (Standard): Vorschautext durch die neueste Teilausgabe ersetzen.
• block: gestückelte Vorschauaktualisierungen anhängen.
• progress: Fortschrittsstatustext während der Generierung anzeigen, danach den finalen Text senden.
• streaming.preview.toolProgress: Wenn die Entwurfsvorschau aktiv ist, Tool-/Fortschrittsaktualisierungen in dieselbe bearbeitete Vorschaunachricht routen (Standard: true). Auf false setzen, um separate Tool-/Fortschrittsnachrichten beizubehalten.
• streaming.preview.commandText / streaming.progress.commandText: auf status setzen, um kompakte Tool-Fortschrittszeilen beizubehalten und gleichzeitig rohen Befehls-/Exec-Text auszublenden (Standard: raw).

Rohen Befehls-/Exec-Text ausblenden und kompakte Fortschrittszeilen beibehalten:

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

channels.slack.streaming.nativeTransport steuert das native Text-Streaming von Slack, wenn channels.slack.streaming.mode partial ist (Standard: true).

• Ein Antwort-Thread muss verfügbar sein, damit natives Text-Streaming und Slack-Assistenten-Threadstatus angezeigt werden. Die Thread-Auswahl folgt weiterhin replyToMode.
• Channel-, Gruppenchat- und Top-Level-DM-Wurzeln können weiterhin die normale Entwurfsvorschau verwenden, wenn natives Streaming nicht verfügbar ist oder kein Antwort-Thread existiert.
• Top-Level-Slack-DMs bleiben standardmäßig außerhalb von Threads, daher zeigen sie keine Thread-artige native Stream-/Statusvorschau von Slack; OpenClaw postet und bearbeitet stattdessen eine Entwurfsvorschau in der DM.
• Medien und Nicht-Text-Payloads fallen auf die normale Zustellung zurück.
• Medien-/Fehler-Finalnachrichten brechen ausstehende Vorschau-Bearbeitungen ab; geeignete Text-/Block-Finalnachrichten werden nur ausgegeben, wenn sie die Vorschau an Ort und Stelle bearbeiten können.
• Wenn Streaming mitten in einer Antwort fehlschlägt, fällt OpenClaw für die verbleibenden Payloads auf normale Zustellung zurück.

Entwurfsvorschau statt nativem Slack-Text-Streaming verwenden:

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

Legacy-Schlüssel:

• channels.slack.streamMode (replace | status_final | append) ist ein veralteter Laufzeit-Alias für channels.slack.streaming.mode.
• Der boolesche Wert channels.slack.streaming ist ein veralteter Laufzeit-Alias für channels.slack.streaming.mode und channels.slack.streaming.nativeTransport.
• Das veraltete channels.slack.nativeStreaming ist ein Laufzeit-Alias für channels.slack.streaming.nativeTransport.
• Führen Sie openclaw doctor --fix aus, um die persistierte Slack-Streaming-Konfiguration auf die kanonischen Schlüssel umzuschreiben.

# Fallback für Tippreaktionen

typingReaction fügt der eingehenden Slack-Nachricht eine temporäre Reaktion hinzu, während OpenClaw eine Antwort verarbeitet, und entfernt sie wieder, wenn der Lauf beendet ist. Dies ist vor allem außerhalb von Thread-Antworten nützlich, die eine standardmäßige Statusanzeige „schreibt ...“ 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 Aufwand, und die Bereinigung wird nach Abschluss des Antwort- oder Fehlerpfads automatisch versucht.

# Medien, Chunking und Zustellung

# Befehle und Slash-Verhalten

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

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

/openclaw /help

Native Befehle erfordern stattdessen zusätzliche Manifest-Einstellungen in Ihrer Slack-App und werden 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 aus, sodass commands.native: "auto" native Slack-Befehle nicht aktiviert.

/help

Native Argumentmenüs verwenden eine adaptive Rendering-Strategie, die vor dem Auslösen 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ätsoptions-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 mithilfe von CommandTargetSessionKey an die Ziel-Konversationssitzung weiter.

# Interaktive Antworten

Slack kann von Agenten erstellte interaktive Antwortsteuerelemente rendern, aber diese Funktion ist standardmäßig deaktiviert.

Aktivieren Sie sie global:

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

Oder aktivieren Sie sie nur für ein Slack-Konto:

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

Wenn aktiviert, können Agenten Slack-spezifische Antwortdirektiven ausgeben:

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

Diese Direktiven werden zu Slack Block Kit kompiliert und leiten Klicks oder Auswahlen über den bestehenden Slack-Interaktionsereignispfad zurück.

Hinweise:

• 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 undurchsichtige Token, keine rohen, vom Agenten erstellten Werte.
• Wenn generierte interaktive Blöcke Slack-Block-Kit-Limits überschreiten würden, fällt OpenClaw auf die ursprüngliche Textantwort zurück, anstatt eine ungültige Blocks-Nutzlast zu senden.

# Exec-Genehmigungen in Slack

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

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

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

Konfigurationspfad:

• 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

Slack aktiviert native Exec-Genehmigungen automatisch, wenn enabled nicht gesetzt oder "auto" ist und mindestens eine genehmigende Person aufgelöst wird. Setzen Sie enabled: false, um Slack explizit als nativen Genehmigungsclient zu deaktivieren. Setzen Sie enabled: true, um native Genehmigungen zu erzwingen, wenn genehmigende Personen aufgelöst werden.

Standardverhalten ohne explizite Slack-Exec-Genehmigungskonfiguration:

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

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

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

Die gemeinsame approvals.exec-Weiterleitung ist separat. Verwenden Sie sie nur, wenn Exec-Genehmigungsaufforderungen auch an andere Chats oder explizite Out-of-Band-Ziele weitergeleitet werden müssen. Die gemeinsame approvals.plugin-Weiterleitung ist ebenfalls separat; Slack-native Buttons können Plugin-Genehmigungen weiterhin auflösen, wenn diese Anfragen bereits in Slack landen.

Same-Chat-/approve funktioniert auch in Slack-Kanälen und DMs, die bereits Befehle unterstützen. Siehe Exec-Genehmigungen für das vollständige Modell der Genehmigungsweiterleitung.

# Ereignisse und Betriebsverhalten

• Nachrichtenbearbeitungen/-löschungen werden Systemereignissen zugeordnet.
• Thread-Broadcasts („Auch an Kanal senden“-Thread-Antworten) werden als normale Benutzernachrichten verarbeitet.
• Ereignisse zum Hinzufügen/Entfernen von Reaktionen werden Systemereignissen zugeordnet.
• Ereignisse zu Mitgliederbeitritt/-austritt, Kanalerstellung/-umbenennung und Pin-Hinzufügung/-Entfernung werden Systemereignissen zugeordnet.
• 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 injiziert werden.
• Thread-Starter und anfängliches Thread-Verlaufskontext-Seeding werden nach konfigurierten Absender-Allowlists gefiltert, wenn zutreffend.
• Blockaktionen und Modalinteraktionen geben strukturierte Slack interaction: ...-Systemereignisse mit umfangreichen Nutzlastfeldern aus:
  • Blockaktionen: ausgewählte Werte, Labels, Picker-Werte und workflow_*-Metadaten
  • Modalereignisse view_submission und view_closed mit gerouteten Kanalmetadaten und Formulareingaben

# Konfigurationsreferenz

Primäre Referenz: Konfigurationsreferenz - Slack.

# Fehlerbehebung

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

openclaw pairing list slack

# Referenz zu Anhangserkennung mit Vision

Slack kann heruntergeladene Medien an den Agent-Turn anhängen, wenn Slack-Dateidownloads erfolgreich sind und Größenlimits dies zulassen. Bilddateien können über den Pfad für Medienverständnis oder direkt an ein vision-fähiges Antwortmodell weitergegeben werden; andere Dateien bleiben als herunterladbarer Dateikontext erhalten und werden nicht als Bildeingabe behandelt.

# Unterstützte Medientypen

# Inbound-Pipeline

Wenn eine Slack-Nachricht mit Dateianhängen eingeht:

1. OpenClaw lädt die Datei über die private URL von Slack mit dem Bot-Token (xoxb-...) herunter.
2. Die Datei wird bei Erfolg in den Medienspeicher geschrieben.
3. Heruntergeladene Medienpfade und Inhaltstypen werden dem Inbound-Kontext hinzugefügt.
4. Bildfähige Modell-/Tool-Pfade können Bildanhänge aus diesem Kontext verwenden.
5. Nicht-Bilddateien bleiben als Dateimetadaten oder Medienreferenzen für Tools verfügbar, die sie verarbeiten können.

# Vererbung von Anhängen der Thread-Root-Nachricht

Wenn eine Nachricht in einem Thread eingeht (mit einem thread_ts-Parent):

• Wenn die Antwort selbst keine direkten Medien enthält und die enthaltene Root-Nachricht Dateien hat, kann Slack die Root-Dateien als Kontext der Thread-Startnachricht hydrieren.
• Direkte Antwortanhänge haben Vorrang vor Anhängen der Root-Nachricht.
• Eine Root-Nachricht, die nur Dateien und keinen Text enthält, wird mit einem Anhang-Platzhalter dargestellt, sodass der Fallback ihre Dateien weiterhin einschließen kann.

# Verarbeitung mehrerer Anhänge

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

• Jeder Anhang wird unabhängig durch die Medien-Pipeline verarbeitet.
• Heruntergeladene Medienreferenzen werden im Nachrichtenkontext aggregiert.
• Die Verarbeitungsreihenfolge folgt der Dateireihenfolge von Slack in der Event-Payload.
• Ein Fehler beim Download eines Anhangs blockiert die anderen nicht.

# Größen-, Download- und Modelllimits

• Größenlimit: Standardmäßig 20 MB pro Datei. Konfigurierbar über channels.slack.mediaMaxMb.
• Downloadfehler: Dateien, die Slack nicht bereitstellen kann, abgelaufene URLs, unzugängliche Dateien, übergroße Dateien und Slack-Auth-/Login-HTML-Antworten werden übersprungen, statt als nicht unterstützte Formate gemeldet zu werden.
• Vision-Modell: Die Bildanalyse verwendet das aktive Antwortmodell, wenn es Vision unterstützt, oder das unter agents.defaults.imageModel konfigurierte Bildmodell.

# Bekannte Einschränkungen

# Verwandte Dokumentation

• Pipeline für Medienverständnis
• PDF-Tool
• Epic: #51349 — Aktivierung von Slack-Anhang-Vision
• Regressionstests: #51353
• Live-Verifizierung: #51354

# Verwandt