Si vous avez déjà passé trois heures à déboguer une intégration Slack qui refuse de coopérer, bienvenue dans le club. Lorsque j’ai essayé pour la première fois de connecter OpenClaw à l’espace de travail Slack de notre équipe, j’ai sérieusement envisagé de jetez mon ordinateur portable par la fenêtre. La documentation faisait croire que c’était une configuration de 15 minutes. Ce n’était pas une configuration de 15 minutes.
Mais j’ai réussi à faire fonctionner l’intégration. Et maintenant que je suis passé par cette douleur, je peux vous en épargner une grande partie. Voici mon véritable journal de configuration — les étapes réelles, les vraies erreurs, et les choses que la documentation ne vous dit pas.
Pourquoi s’embêter avec cette intégration
Notre équipe utilisait déjà Slack pour tout. Conversations, décisions, partage de fichiers, le mème occasionnel. Et nous avions commencé à utiliser OpenClaw pour l’automatisation des tâches avec intelligence artificielle — surveillance des systèmes, génération de rapports, gestion des flux de travail répétitifs.
Le problème : ces deux mondes étaient déconnectés. Quelqu’un remarquait un problème dans Slack, allait manuellement sur OpenClaw pour déclencher un flux de travail, puis revenait sur Slack pour rapporter le résultat. Les connecter signifiait que tout le cycle pouvait se produire à l’intérieur de Slack. Quelqu’un mentionne un problème → OpenClaw s’en charge → exécute le flux de travail → publie le résultat en retour. Pas de changement de contexte.
Le gain de productivité après la configuration a été immédiat. Mais y parvenir a été un parcours.
Ce dont vous avez besoin avant de commencer
Trois choses, et ne les sautez pas :
Un espace de travail Slack où vous êtes administrateur (ou au moins avez l’autorisation d’installer des applications). Si vous n’êtes pas administrateur, arrêtez-vous ici et obtenez le bon accès. J’ai perdu 45 minutes à essayer de contourner les autorisations avant de reconnaître que je devais demander à notre informaticien.
Une instance OpenClaw qui fonctionne et est accessible depuis Internet. Mot clé : accessible depuis Internet. Si OpenClaw fonctionne sur votre ordinateur portable derrière un pare-feu, Slack ne peut pas y accéder. J’ai appris cela à mes dépens lorsque mon URL webhook était localhost:3000 et que je n’arrivais pas à comprendre pourquoi la vérification de Slack échouait constamment. Utilisez ngrok pour le développement, ou déployez correctement pour la production.
Environ 30 à 60 minutes de temps ininterrompu. C’est une tâche de type configuration-une-fois-exécution-pour-toujours, mais vous devez être concentré. La moitié des erreurs proviennent d’une mauvaise copie des tokens ou d’un oubli du tab dans lequel vous êtes.
Étape 1 : Créer l’application Slack
Rendez-vous sur api.slack.com et cliquez sur « Créer une nouvelle application. » Choisissez « À partir de zéro » (l’option manifeste fonctionne aussi mais est plus difficile à déboguer si quelque chose ne va pas).
Donnez-lui un nom que votre équipe reconnaîtra — j’ai choisi « OpenClaw Bot » parce que la créativité n’était pas ma priorité à ce moment-là. Sélectionnez votre espace de travail.
Maintenant, voici où cela devient important. Allez dans « OAuth & Permissions » dans la barre latérale. Sous « Bot Token Scopes », ajoutez ces éléments :
– chat:write — pour que le bot puisse poster des messages
– app_mentions:read — pour qu’il réponde lorsque quelqu’un le mentionne
– channels:read — pour qu’il puisse voir quels canaux existent
– channels:history — si vous voulez qu’il lise les messages récents pour le contexte
Ne sautez pas channels:history si vous voulez qu’OpenClaw ait un contexte sur les conversations récentes. Je l’ai initialement sauté et j’ai été confus lorsque le bot ne pouvait pas « se souvenir » de ce que les gens venaient de dire.
Installez l’application dans votre espace de travail. Vous recevrez un Bot User OAuth Token — copiez-le dans un endroit sûr. Vous en aurez besoin dans environ deux minutes.
Étape 2 : Configurer le côté OpenClaw
Dans votre configuration OpenClaw, vous devez ajouter la configuration du canal Slack. C’est ici que vous collez ce Bot Token que vous venez de copier.
L’URL webhook est la partie qui m’a posé problème. OpenClaw doit exposer un point de terminaison auquel Slack peut envoyer des événements. En production, cela devrait être une véritable URL HTTPS pointant vers votre instance OpenClaw. En développement, ngrok fonctionne bien — il suffit d’exécuter ngrok http 3000 (ou tout autre port utilisé par OpenClaw) et d’utiliser l’URL générée.
Définissez l’URL webhook sur la page « Event Subscriptions » de Slack. Slack enverra immédiatement un défi de vérification à cette URL. Si OpenClaw est configuré correctement, il gérera cela automatiquement. Si ce n’est pas le cas, vous regarderez une erreur « Request URL not verified » et vous vous demanderez ce que vous avez fait de mal.
Raisons courantes pour lesquelles la vérification échoue :
– OpenClaw ne fonctionne pas (vérifiez votre terminal)
– L’URL est incorrecte (copiez-collez avec soin, vérifiez les barres obliques à la fin)
– Le pare-feu bloque la connexion (essayez depuis un navigateur d’abord)
– Vous avez oublié de sauvegarder la configuration avant que Slack essaie de vérifier (je l’ai fait deux fois)
Étape 3 : S’abonner aux événements
Toujours sur la page Event Subscriptions de Slack, ajoutez ces événements de bot :
– app_mention — déclenche quand quelqu’un @mentionne votre bot
– message.channels — déclenche sur n’importe quel message dans les canaux où se trouve le bot
Enregistrez. Slack vérifiera l’URL à nouveau. Cela devrait passer cette fois.
Allez sur un canal Slack, invitez votre bot (/invite @OpenClaw Bot), et essayez de le mentionner : « @OpenClaw Bot quel est le statut ? » Si tout est correctement connecté, OpenClaw reçoit l’événement, le traite, et répond dans le canal.
Lorsque le mien a répondu avec succès pour la première fois, j’ai littéralement dit « oui ! » à voix haute dans mon bureau. Mon collègue a pensé que j’avais gagné à la loterie. J’avais gagné quelque chose de mieux : une intégration qui fonctionne.
À quoi je l’utilise réellement
Alertes de surveillance automatisées. OpenClaw vérifie nos systèmes toutes les 5 minutes et publie sur #alerts si quelque chose ne va pas. Avant l’intégration, nous avions des alertes par email. Personne ne lit les alertes par email.
Rapports à la demande. « @OpenClaw Bot exécute le résumé des ventes de la semaine » et il génère un rapport formaté directement dans Slack. L’équipe des ventes adore cela car ils n’ont pas besoin de se connecter à notre tableau de bord d’analyse.
Réponse aux incidents. Quelqu’un publie à propos d’un problème de production → OpenClaw récupère automatiquement les journaux pertinents, vérifie les déploiements récents, et publie un résumé. Cela a réduit notre temps de réponse aux incidents d’environ 40 %.
Automatisation du stand-up quotidien. Chaque matin à 9h, OpenClaw publie un résumé des tâches complétées hier et des priorités d’aujourd’hui, tirées de notre outil de gestion de projet. La réunion de stand-up qui durait 20 minutes ne dure maintenant plus que 5.
Conseils de débogage issus de ma souffrance
Vérifiez les journaux en premier. OpenClaw enregistre chaque événement Slack entrant. Si les messages ne passent pas, les journaux vous indiqueront si l’événement est arrivé mais n’a pas pu être traité, ou n’est jamais arrivé du tout.
Slack a une politique de réessai qui prend les gens au dépourvu. Si votre webhook ne répond pas dans les 3 secondes, Slack réessaie — jusqu’à trois fois. Si OpenClaw est lent à répondre, vous pourriez recevoir des messages en double. La solution : accuser réception de l’événement immédiatement et le traiter de manière asynchrone.
Les permissions de canal comptent. Le bot ne peut voir et publier que dans les canaux où il a été invité. Si vous testez dans un canal privé, assurez-vous que le bot en est membre.
Rotation des tokens. Si les choses cessent soudainement de fonctionner après avoir bien fonctionné, vérifiez si vos tokens Slack ont expiré ou ont été tournés. Cela m’est arrivé après un changement de paramètres d’espace de travail Slack.
Étaient-ils bien valables la douleur de configuration ?
Absolument. La configuration initiale m’a pris environ 90 minutes (cela aurait pris 45 minutes si j’avais lu ce guide en premier). Depuis, l’intégration a fait gagner à notre équipe des heures chaque semaine et a éliminé plusieurs changements de contexte par jour.
Les meilleures intégrations sont celles que vous cessez de remarquer. Après la première semaine, notre équipe a cessé de considérer OpenClaw comme un outil séparé — c’était juste une partie de Slack. C’est là que vous savez que l’intégration fonctionne.
🕒 Published: