Passer au contenu principal
Ajoutez un assistant IA à votre espace de travail Slack en utilisant le Socket Mode — aucune URL publique n’est requise.

Prérequis

Guide de configuration

1

Créer une application Slack

  1. Allez sur Slack API et cliquez sur Create New App
  2. Choisissez From scratch
  3. Entrez un nom d’application (ex: “AI Assistant”) et sélectionnez votre espace de travail
  4. Cliquez sur Create App
2

Activer le Socket Mode

  1. Dans la barre latérale gauche, allez dans Socket Mode
  2. Basculez Enable Socket Mode sur ON
  3. Donnez un nom au token (ex: “claw-socket”) et cliquez sur Generate
  4. Copiez l’App-Level Token (commence par xapp-) — vous en aurez besoin
3

Configurer les permissions du bot

  1. Allez dans OAuth & Permissions dans la barre latérale
  2. Sous Bot Token Scopes, ajoutez ces scopes :
    • chat:write — Envoyer des messages
    • im:history — Lire l’historique des DM
    • im:read — Voir les DM
    • im:write — Démarrer des DM
    • app_mentions:read — Détecter les @mentions
  3. Cliquez sur Install to Workspace en haut
  4. Autorisez l’application
  5. Copiez le Bot User OAuth Token (commence par xoxb-)
4

Activer les événements

  1. Allez dans Event Subscriptions dans la barre latérale
  2. Basculez Enable Events sur ON
  3. Sous Subscribe to bot events, ajoutez :
    • message.im — Messages dans les DM
    • app_mention — @mentions dans les canaux
  4. Cliquez sur Save Changes
5

Ouvrir la LemonClaw WebUI

  1. Si vous utilisez Claw hébergé, allez sur votre Claw Dashboard et cliquez sur Open WebUI
  2. Si vous auto-hébergez LemonClaw, ouvrez votre propre WebUI (par exemple http://your-ip:18789) et connectez-vous avec votre token
  3. Dans la WebUI, allez dans SettingsChannels
  4. Développez la section Slack
  5. Collez votre App Token (xapp-...) et votre Bot Token (xoxb-...)
  6. Cliquez sur Save
6

Commencer à discuter

  1. Dans Slack, envoyez un DM à votre bot ou mentionnez-le (@mention) dans un canal
  2. Le premier utilisateur est automatiquement associé en tant que propriétaire — aucun code n’est nécessaire !
  3. Commencez à discuter avec l’IA !

Contrôle d’accès

Paramètres de groupe

Configurez l’accès aux canaux dans l’onglet Channels de votre WebUI :
ParamètreOptionsDescription
Group PolicyOpen (par défaut) / Allowlist / DisabledContrôle les canaux dans lesquels le bot répond
Require @mentionOn / OffLe bot répond uniquement lorsqu’il est mentionné (@mention)
Group IDsListe d’IDs de canauxRestreindre à des canaux spécifiques (vide = tous les canaux)
Group Allowed UsersListe d’IDs d’utilisateursSeuls ces utilisateurs peuvent déclencher le bot (mode allowlist)
Par défaut, Slack utilise la politique de groupe open — le bot répond dans tous les canaux où il est invité. Utilisez allowlist pour restreindre l’accès à des canaux spécifiques.

Dépannage

  • Vérifiez que les deux tokens sont corrects (le App Token commence par xapp-, le Bot Token par xoxb-)
  • Vérifiez que l’événement message.im est bien souscrit
  • Assurez-vous que l’application est installée dans votre espace de travail
  • Vérifiez que le scope app_mentions:read et l’événement app_mention sont configurés
  • Le bot doit d’abord être invité dans le canal (tapez /invite @nomdubot)
  • Assurez-vous d’utiliser l’App-Level Token (xapp-) pour le champ App Token, et non le Bot Token
  • Le Bot Token (xoxb-) va dans le champ Bot Token