Prérequis
- Un espace de travail Slack où vous avez un accès administrateur
- Une instance Claw (créez-en une ici)
Guide de configuration
Créer une application Slack
- Allez sur Slack API et cliquez sur Create New App
- Choisissez From scratch
- Entrez un nom d’application (ex: “AI Assistant”) et sélectionnez votre espace de travail
- Cliquez sur Create App
Activer le Socket Mode
- Dans la barre latérale gauche, allez dans Socket Mode
- Basculez Enable Socket Mode sur ON
- Donnez un nom au token (ex: “claw-socket”) et cliquez sur Generate
- Copiez l’App-Level Token (commence par
xapp-) — vous en aurez besoin
Configurer les permissions du bot
- Allez dans OAuth & Permissions dans la barre latérale
- Sous Bot Token Scopes, ajoutez ces scopes :
chat:write— Envoyer des messagesim:history— Lire l’historique des DMim:read— Voir les DMim:write— Démarrer des DMapp_mentions:read— Détecter les @mentions
- Cliquez sur Install to Workspace en haut
- Autorisez l’application
- Copiez le Bot User OAuth Token (commence par
xoxb-)
Activer les événements
- Allez dans Event Subscriptions dans la barre latérale
- Basculez Enable Events sur ON
- Sous Subscribe to bot events, ajoutez :
message.im— Messages dans les DMapp_mention— @mentions dans les canaux
- Cliquez sur Save Changes
Configurer dans le tableau de bord LemonData
- Allez sur votre Claw Dashboard
- Cliquez sur l’icône de paramètres de votre instance
- Ouvrez l’onglet IM Integrations
- Développez la section Slack
- Collez votre App Token (
xapp-...) et votre Bot Token (xoxb-...) - Cliquez sur Save
Contrôle d’accès
Paramètres de groupe
Configurez l’accès aux canaux dans l’onglet IM Integrations de votre tableau de bord :| Paramètre | Options | Description |
|---|---|---|
| Group Policy | Open (par défaut) / Allowlist / Disabled | Contrôle les canaux dans lesquels le bot répond |
| Require @mention | On / Off | Le bot répond uniquement lorsqu’il est mentionné (@mention) |
| Group IDs | Liste d’IDs de canaux | Restreindre à des canaux spécifiques (vide = tous les canaux) |
| Group Allowed Users | Liste d’IDs d’utilisateurs | Seuls ces utilisateurs peuvent déclencher le bot (mode allowlist) |
Dépannage
Le bot ne répond pas aux DM
Le bot ne répond pas aux DM
- Vérifiez que les deux tokens sont corrects (le App Token commence par
xapp-, le Bot Token parxoxb-) - Vérifiez que l’événement
message.imest bien souscrit - Assurez-vous que l’application est installée dans votre espace de travail
Le bot ne répond pas aux @mentions
Le bot ne répond pas aux @mentions
- Vérifiez que le scope
app_mentions:readet l’événementapp_mentionsont configurés - Le bot doit d’abord être invité dans le canal (tapez
/invite @nomdubot)
Erreur 'not_allowed_token_type'
Erreur 'not_allowed_token_type'
- 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