Skill Slack pour OpenClaw

Présentation du skill Slack pour OpenClaw

Le skill Slack connecte OpenClaw à votre espace de travail Slack, permettant à votre agent IA d'envoyer des messages, de gérer les réactions, d'épingler des éléments et de lire les conversations — le tout par des commandes en langage naturel. Au lieu de basculer entre votre terminal et Slack, vous pouvez demander à OpenClaw de gérer les tâches de messagerie courantes en quelques secondes.

Slack est l'une des plateformes de communication d'équipe les plus utilisées, et son intégration avec OpenClaw libère de puissants flux de travail automatisés. Que vous ayez besoin de publier des notifications de déploiement, de réagir à des messages ou d'épingler des décisions importantes, le skill Slack pour OpenClaw transforme les opérations Slack en plusieurs étapes en simples conversations.

Flux de travail typique :

1. Demandez à OpenClaw d'envoyer une mise à jour de déploiement sur le canal #releases.
2. L'agent appelle l'API Slack via le jeton de bot configuré.
3. Le message est publié instantanément — aucun changement de contexte nécessaire.

Le skill prend en charge deux modes de connexion : Socket Mode (recommandé pour le développement et les petites équipes) et HTTP Events API (mieux adapté aux déploiements en production derrière un pare-feu). Les deux modes utilisent le même jeton de bot et offrent des fonctionnalités identiques.

Prérequis pour le skill Slack

Avant d'installer le skill Slack, assurez-vous d'avoir :

• OpenClaw installé et en cours d'exécution (v1.0+)
• Un espace de travail Slack où vous avez la permission d'installer des applications
• Une application Slack créée sur api.slack.com/apps avec les scopes OAuth requis
• clawhub CLI installé pour la gestion des skills — installer avec clawhub

Scopes OAuth requis (Bot Token)

Lors de la création de votre application Slack, ajoutez ces scopes de jeton de bot :

| Scope | Objectif | |-------|----------| | chat:write | Envoyer et modifier des messages | | channels:history | Lire l'historique des messages du canal | | channels:read | Lister et voir les informations du canal | | im:history | Lire l'historique des messages directs | | im:write | Envoyer des messages directs | | reactions:read | Lister les réactions sur les messages | | reactions:write | Ajouter des réactions emoji | | pins:read | Lister les éléments épinglés | | pins:write | Épingler et désépingler des messages | | emoji:read | Accéder à la liste d'emojis personnalisés | | app_mentions:read | Répondre aux @mentions |

Optionnel : ajoutez chat:write.customize pour personnaliser le nom d'affichage du bot par message, ou files:read et files:write pour les opérations sur les fichiers.

Vérifiez votre configuration :

# Vérifier la version d'OpenClaw
openclaw --version

# Vérifier que clawhub est installé
clawhub --version

Comment installer le skill Slack

Installez le skill Slack avec une seule commande :

npx clawhub@latest install slack

Pour vérifier l'installation :

clawhub list

Vous devriez voir slack dans la liste des skills installés. Le skill est publié par steipete sur ClawHub et reçoit des mises à jour régulières.

Configuration du skill Slack

Le skill Slack nécessite un Bot Token et, pour le Socket Mode, un App Token. OpenClaw lit ces jetons automatiquement à partir des variables d'environnement.

Configuration de l'environnement

# Requis : Bot Token (commence par xoxb-)
export SLACK_BOT_TOKEN=xoxb-your-bot-token-here

# Requis pour Socket Mode (commence par xapp-)
export SLACK_APP_TOKEN=xapp-your-app-token-here

Important : Ne codez jamais les jetons en dur dans les fichiers de configuration. Utilisez des variables d'environnement ou un gestionnaire de secrets comme 1Password ou Bitwarden.

Modes de connexion

Socket Mode (par défaut) :

• Nécessite SLACK_BOT_TOKEN et SLACK_APP_TOKEN
• Aucune URL publique nécessaire — idéal pour le développement local
• Démarrez avec openclaw gateway

HTTP Events API :

• Nécessite SLACK_BOT_TOKEN et un Signing Secret
• Configurez un endpoint webhook (par défaut : /slack/events)
• Mieux adapté aux environnements de production derrière un proxy inverse

Contrôle d'accès

OpenClaw fournit un contrôle d'accès granulaire pour les interactions Slack :

• Politique DM : pairing (par défaut), allowlist, open ou disabled
• Politique de canal : open, allowlist ou disabled
• Mention requise : Les canaux nécessitent par défaut une mention @bot

Pour les environnements d'équipe, la politique DM pairing est recommandée. Les utilisateurs doivent exécuter openclaw pairing approve slack <code> avant que le bot réponde à leurs DMs. Consultez la liste de vérification de sécurité pour des conseils de durcissement supplémentaires.

Exemples d'utilisation du skill Slack

1. Publier une notification de déploiement

Vous : « Envoie un message sur #releases disant que la version 2.4.0 a été déployée en production sans temps d'arrêt. »

L'agent appelle sendMessage avec le canal cible et le contenu du message. La notification apparaît instantanément dans le canal avec l'identité du bot.

2. Réagir à une décision d'équipe

Vous : « Ajoute une réaction coche au dernier message dans #engineering-decisions. »

L'agent lit le message le plus récent dans le canal spécifié via readMessages, puis applique une réaction ✅ via react. Idéal pour confirmer des décisions ou marquer des tâches comme revues.

3. Épingler une mise à jour importante

Vous : « Épingle le message sur la feuille de route Q1 dans #product. »

L'agent recherche dans les messages récents un contenu correspondant à « feuille de route Q1 », puis utilise pinMessage pour l'épingler. Les éléments épinglés restent accessibles en haut du canal pour toute l'équipe.

4. Lire et résumer l'activité du canal

Vous : « Résume ce qui s'est passé aujourd'hui dans #support. »

L'agent utilise readMessages pour récupérer les messages du jour, puis analyse et résume les sujets clés, questions et résolutions. Se combine bien avec le skill Summarize pour les conversations plus longues.

Sécurité et bonnes pratiques

Le skill Slack peut envoyer des messages et modifier du contenu dans votre espace de travail. Suivez ces directives pour rester en sécurité :

• Utilisez le moindre privilège. N'accordez que les scopes OAuth dont vous avez réellement besoin. Si vous ne lisez que les canaux, ignorez chat:write et pins:write.
• Activez le mode pairing. La politique DM pairing par défaut empêche les utilisateurs non autorisés d'interagir avec le bot en messages directs.
• Vérifiez avant d'envoyer. OpenClaw demande confirmation avant d'envoyer des messages par défaut. Ne désactivez pas cette fonction dans les espaces de travail de production.
• Limitez l'accès aux canaux. Utilisez la politique de canal allowlist pour restreindre le bot à des canaux spécifiques plutôt que d'accorder un accès à tout l'espace de travail.
• Faites tourner les jetons régulièrement. Régénérez votre jeton de bot périodiquement et révoquez les jetons inutilisés depuis la page de gestion des applications Slack.
• Auditez l'activité des messages. Consultez les journaux d'audit de votre espace de travail Slack pour vérifier les messages envoyés par le bot.

Résolution des erreurs courantes du skill Slack

« not_authed » ou « invalid_auth »

Votre jeton de bot est manquant ou invalide.

# Vérifier que le jeton est défini
echo $SLACK_BOT_TOKEN

# Ré-exporter si nécessaire
export SLACK_BOT_TOKEN=xoxb-your-new-token

Si le jeton a été récemment régénéré, assurez-vous de le mettre à jour dans tous les environnements où il est utilisé.

« channel_not_found »

Le bot ne peut pas accéder au canal spécifié. Cela signifie généralement :

1. Le bot n'a pas été invité dans le canal — tapez /invite @your-bot-name dans le canal.
2. L'ID du canal est incorrect — utilisez l'API Slack ou le menu contextuel du canal pour obtenir l'ID correct.
3. Le canal est privé et le bot n'a pas le scope groups:read.

« missing_scope »

Le jeton de bot manque d'un scope OAuth requis.

1. Allez sur api.slack.com/apps → votre application → OAuth & Permissions.
2. Ajoutez le scope manquant indiqué dans le message d'erreur.
3. Réinstallez l'application dans votre espace de travail pour appliquer les nouveaux scopes.