Slack Skill für OpenClaw

OpenClaw Slack Skill Übersicht

Der Slack Skill verbindet OpenClaw mit Ihrem Slack-Workspace und ermöglicht Ihrem KI-Agenten, Nachrichten zu senden, Reaktionen zu verwalten, Elemente anzuheften und Konversationen zu lesen — alles durch Befehle in natürlicher Sprache. Anstatt zwischen Terminal und Slack hin und her zu wechseln, können Sie OpenClaw bitten, routinemäßige Messaging-Aufgaben in Sekunden zu erledigen.

Slack ist eine der am weitesten verbreiteten Team-Kommunikationsplattformen, und die Integration mit OpenClaw erschließt leistungsstarke Automatisierungs-Workflows. Ob Sie Deployment-Benachrichtigungen posten, auf Nachrichten reagieren oder wichtige Entscheidungen anheften möchten — der OpenClaw Slack Skill verwandelt mehrstufige Slack-Operationen in einfache Konversationen.

Typischer Workflow:

1. Bitten Sie OpenClaw, ein Deployment-Update im #releases-Kanal zu posten.
2. Der Agent ruft die Slack API über das konfigurierte Bot-Token auf.
3. Die Nachricht wird sofort gepostet — kein Kontextwechsel erforderlich.

Der Skill unterstützt zwei Verbindungsmodi: Socket Mode (empfohlen für Entwicklung und kleine Teams) und HTTP Events API (besser für Produktionsumgebungen hinter einer Firewall). Beide Modi verwenden dasselbe Bot-Token und bieten identische Funktionalität.

Voraussetzungen für den Slack Skill

Bevor Sie den Slack Skill installieren, stellen Sie sicher, dass Sie Folgendes haben:

• OpenClaw installiert und laufend (v1.0+)
• Einen Slack-Workspace, in dem Sie die Berechtigung haben, Apps zu installieren
• Eine Slack-App, erstellt unter api.slack.com/apps mit den erforderlichen OAuth-Scopes
• clawhub CLI installiert für die Skill-Verwaltung — mit clawhub installieren

Erforderliche OAuth-Scopes (Bot Token)

Fügen Sie beim Erstellen Ihrer Slack-App die folgenden Bot-Token-Scopes hinzu:

| Scope | Zweck | |-------|-------| | chat:write | Nachrichten senden und bearbeiten | | channels:history | Kanal-Nachrichtenverlauf lesen | | channels:read | Kanalinformationen auflisten und anzeigen | | im:history | Direktnachrichtenverlauf lesen | | im:write | Direktnachrichten senden | | reactions:read | Reaktionen auf Nachrichten auflisten | | reactions:write | Emoji-Reaktionen hinzufügen | | pins:read | Angeheftete Elemente auflisten | | pins:write | Nachrichten anheften und lösen | | emoji:read | Auf benutzerdefinierte Emoji-Liste zugreifen | | app_mentions:read | Auf @-Erwähnungen antworten |

Optional: Fügen Sie chat:write.customize hinzu, um den Bot-Anzeigenamen pro Nachricht anzupassen, oder files:read und files:write für Dateioperationen.

Überprüfen Sie Ihr Setup:

# OpenClaw-Version prüfen
openclaw --version

# Prüfen, ob clawhub installiert ist
clawhub --version

Slack Skill installieren

Installieren Sie den Slack Skill mit einem einzigen Befehl:

npx clawhub@latest install slack

Zur Überprüfung der Installation:

clawhub list

Sie sollten slack in der Liste der installierten Skills sehen. Der Skill wird von steipete auf ClawHub veröffentlicht und regelmäßig aktualisiert.

Slack Skill Konfiguration

Der Slack Skill benötigt ein Bot Token und für den Socket Mode ein App Token. OpenClaw liest diese Token automatisch aus Umgebungsvariablen.

Umgebungseinrichtung

# Erforderlich: Bot Token (beginnt mit xoxb-)
export SLACK_BOT_TOKEN=xoxb-your-bot-token-here

# Erforderlich für Socket Mode (beginnt mit xapp-)
export SLACK_APP_TOKEN=xapp-your-app-token-here

Wichtig: Kodieren Sie Token niemals direkt in Konfigurationsdateien. Verwenden Sie Umgebungsvariablen oder einen Secret-Manager wie 1Password oder Bitwarden.

Verbindungsmodi

Socket Mode (Standard):

• Benötigt SLACK_BOT_TOKEN und SLACK_APP_TOKEN
• Keine öffentliche URL erforderlich — ideal für lokale Entwicklung
• Starten Sie mit openclaw gateway

HTTP Events API:

• Benötigt SLACK_BOT_TOKEN und ein Signing Secret
• Konfigurieren Sie einen Webhook-Endpunkt (Standard: /slack/events)
• Besser für Produktionsumgebungen hinter einem Reverse Proxy

Zugriffskontrolle

OpenClaw bietet granulare Zugriffskontrolle für Slack-Interaktionen:

• DM-Richtlinie: pairing (Standard), allowlist, open oder disabled
• Kanal-Richtlinie: open, allowlist oder disabled
• Erwähnung erforderlich: In Kanälen ist standardmäßig eine @bot-Erwähnung erforderlich

Für Teamumgebungen wird die DM-Richtlinie pairing empfohlen. Benutzer müssen openclaw pairing approve slack <code> ausführen, bevor der Bot auf ihre DMs antwortet. Konsultieren Sie die Sicherheits-Checkliste für weitere Härtungstipps.

Slack Skill Anwendungsbeispiele

1. Deployment-Benachrichtigung posten

Sie: „Sende eine Nachricht an #releases, dass Version 2.4.0 ohne Ausfallzeit in der Produktion deployed wurde."

Der Agent ruft sendMessage mit dem Zielkanal und Nachrichteninhalt auf. Die Benachrichtigung erscheint sofort im Kanal mit der Bot-Identität.

2. Auf eine Teamentscheidung reagieren

Sie: „Füge eine Häkchen-Reaktion zur letzten Nachricht in #engineering-decisions hinzu."

Der Agent liest die neueste Nachricht im angegebenen Kanal mittels readMessages und wendet dann eine ✅-Reaktion über react an. Ideal zum Bestätigen von Entscheidungen oder zum Markieren von Aufgaben als geprüft.

3. Wichtiges Update anheften

Sie: „Hefte die Nachricht über die Q1-Roadmap in #product an."

Der Agent sucht in den neuesten Nachrichten nach Inhalten, die mit „Q1-Roadmap" übereinstimmen, und verwendet dann pinMessage zum Anheften. Angeheftete Elemente bleiben oben im Kanal für das gesamte Team zugänglich.

4. Kanalaktivität lesen und zusammenfassen

Sie: „Fasse zusammen, was heute in #support passiert ist."

Der Agent verwendet readMessages, um die Nachrichten des Tages abzurufen, und analysiert und fasst dann die wichtigsten Themen, Fragen und Lösungen zusammen. Funktioniert besonders gut zusammen mit dem Summarize Skill für längere Konversationen.

Sicherheit und Best Practices

Der Slack Skill kann Nachrichten senden und Inhalte ändern in Ihrem Workspace. Befolgen Sie diese Richtlinien für mehr Sicherheit:

• Minimale Berechtigungen verwenden. Gewähren Sie nur die OAuth-Scopes, die Sie tatsächlich benötigen. Wenn Sie nur Kanäle lesen, überspringen Sie chat:write und pins:write.
• Pairing-Modus aktivieren. Die Standard-DM-Richtlinie pairing verhindert, dass nicht autorisierte Benutzer in Direktnachrichten mit dem Bot interagieren.
• Vor dem Senden prüfen. OpenClaw fordert standardmäßig eine Bestätigung vor dem Senden von Nachrichten an. Deaktivieren Sie diese Funktion nicht in Produktions-Workspaces.
• Kanalzugriff einschränken. Verwenden Sie die Kanal-Richtlinie allowlist, um den Bot auf bestimmte Kanäle zu beschränken, anstatt workspace-weiten Zugriff zu gewähren.
• Token regelmäßig rotieren. Generieren Sie Ihr Bot-Token regelmäßig neu und widerrufen Sie nicht mehr verwendete Token auf der Slack App-Verwaltung-Seite.
• Nachrichtenaktivität auditieren. Überprüfen Sie die Audit-Logs Ihres Slack-Workspace, um vom Bot gesendete Nachrichten zu prüfen.

Häufige Slack Skill Fehler beheben

„not_authed" oder „invalid_auth"

Ihr Bot-Token fehlt oder ist ungültig.

# Prüfen, ob das Token gesetzt ist
echo $SLACK_BOT_TOKEN

# Bei Bedarf neu exportieren
export SLACK_BOT_TOKEN=xoxb-your-new-token

Wenn das Token kürzlich neu generiert wurde, stellen Sie sicher, dass es in allen Umgebungen aktualisiert wurde.

„channel_not_found"

Der Bot kann auf den angegebenen Kanal nicht zugreifen. Dies bedeutet normalerweise:

1. Der Bot wurde nicht in den Kanal eingeladen — geben Sie /invite @your-bot-name im Kanal ein.
2. Die Kanal-ID ist falsch — verwenden Sie die Slack API oder das Kontextmenü des Kanals, um die richtige ID zu erhalten.
3. Der Kanal ist privat und dem Bot fehlt der groups:read-Scope.

„missing_scope"

Dem Bot-Token fehlt ein erforderlicher OAuth-Scope.

1. Gehen Sie zu api.slack.com/apps → Ihre App → OAuth & Permissions.
2. Fügen Sie den in der Fehlermeldung genannten fehlenden Scope hinzu.
3. Installieren Sie die App in Ihrem Workspace neu, um die neuen Scopes anzuwenden.