🩞
Integration de canal

Connecter OpenClaw a Slack

Ajoutez OpenClaw a votre espace de travail Slack. Obtenez une assistance IA dans les canaux, fils de discussion ou MP avec support des commandes slash.

đŸ’Œ Pourquoi utiliser Slack ?
  • ✓Connexion WebSocket — Messagerie en temps reel via Slack Bot API + Socket Mode
  • ✓Commandes slash — Interface de commande native /clawd
  • ✓Support des fils — Gardez les conversations organisees avec le contexte historique
  • ✓Formatage enrichi — Reponses formatees avec reactions et epingles
  • ✓Acces flexible — MP, canaux publics et canaux prives
Prerequis
  • ‱Token Bot Slack — Commence par xoxb-...
  • ‱Token App Slack — Commence par xapp-... (pour Socket Mode)
  • ‱Application Slack — Avec les scopes OAuth appropries configures

Etapes de configuration

1

Creer une application Slack

Allez sur le portail API Slack et creez une nouvelle application :

  • ‱ Visitez api.slack.com/apps
  • ‱ Cliquez sur "Create New App"
  • ‱ Choisissez "From scratch"
  • ‱ Nommez-la (ex. "OpenClaw") et selectionnez votre espace de travail
2

Ajouter les scopes du token Bot

Configurez les permissions OAuth pour votre bot :

  • ‱ Allez dans "OAuth & Permissions" dans la barre laterale
  • ‱ Sous "Bot Token Scopes", ajoutez :
  • - app_mentions:read — Lire les mentions
  • - channels:history — Voir les messages du canal
  • - channels:read — Voir les infos du canal
  • - chat:write — Envoyer des messages
  • - im:history — Voir l'historique des MP
  • - im:read — Voir les infos des MP
  • - im:write — Demarrer des conversations MP
  • - reactions:write — Ajouter des reactions
  • - users:read — Voir les infos utilisateur
3

Activer Socket Mode

Socket Mode permet une communication en temps reel sans URL publique :

  • ‱ Allez dans "Socket Mode" dans la barre laterale
  • ‱ Activez "Enable Socket Mode"
  • ‱ Generez un token de niveau App avec le scope connections:write
  • ‱ Copiez le token (commence par xapp-...)
4

Installer l'app dans l'espace de travail

Installez l'app et obtenez votre token Bot :

  • ‱ Allez dans "Install App" dans la barre laterale
  • ‱ Cliquez sur "Install to Workspace"
  • ‱ Autorisez les permissions demandees
  • ‱ Copiez le Bot User OAuth Token (commence par xoxb-...)
5

Configurer OpenClaw

Ajoutez la configuration Slack a votre openclaw.json :

{
  "channels": {
    "slack": {
      "enabled": true,
      "botToken": "xoxb-...",
      "appToken": "xapp-..."
    }
  }
}
6

Inviter le bot dans les canaux

Ajoutez le bot aux canaux ou vous voulez qu'il reponde :

  • ‱ Ouvrez le canal dans Slack
  • ‱ Tapez /invite @OpenClaw
  • ‱ Ou cliquez sur le nom du canal -> Integrations -> Ajouter des apps
  • ‱ Redemarrez OpenClaw avec openclaw restart et testez en mentionnant le bot.
Fonctionnalites

Support des fils

Maintient le contexte de conversation dans les fils avec une portee d'historique configurable.

Reactions emoji

Le bot peut ajouter des reactions pour accuser reception des messages ou indiquer le statut.

Epinglage de messages

Epinglez les reponses importantes pour une reference facile plus tard.

Commandes slash

Utilisez /clawd pour des requetes IA rapides depuis n'importe ou.

Infos membre

Consultez les informations des membres de l'espace de travail si necessaire.

Support MP

Conversations privees en tete-a-tete avec le bot.

Configuration avancee

Options de configuration completes pour l'integration Slack :

{
  "channels": {
    "slack": {
      "enabled": true,
      "botToken": "xoxb-...",
      "appToken": "xapp-...",
      "dm": {
        "enabled": true,
        "policy": "pairing",
        "allowFrom": ["U123", "U456"]
      },
      "channels": {
        "#general": {
          "allow": true,
          "requireMention": true,
          "users": ["U123"]
        }
      },
      "historyLimit": 50,
      "slashCommand": {
        "enabled": true,
        "name": "clawd"
      },
      "actions": {
        "reactions": true,
        "messages": true,
        "pins": true
      }
    }
  }
}
  • dm.enabled — Autoriser les messages prives au bot
  • dm.policy — Politique d'acces MP ("pairing" ou "open")
  • dm.allowFrom — Tableau d'IDs utilisateurs autorises a envoyer des MP
  • channels — Objet de configuration par canal
  • requireMention — Repondre uniquement lorsque @mentionne
  • historyLimit — Nombre de messages a inclure pour le contexte
  • slashCommand — Configurer les parametres des commandes slash
  • actions — Activer/desactiver les reactions, messages et epingles
Politiques de canal

Mode liste blanche

Repondre uniquement dans les canaux explicitement configures. Ideal pour les environnements controles.

Mode ouvert

Repondre dans tous les canaux ou le bot est invite. Utilisez requireMention pour filtrer les reponses.

Comment obtenir les IDs utilisateurs Slack

Depuis le profil :

Cliquez sur le nom d'un utilisateur -> Voir le profil -> Cliquez sur les trois points (...) -> Copier l'ID membre

Depuis l'admin Slack :

Parametres de l'espace de travail -> Gerer les membres -> Exporter la liste des membres en CSV

⚠ Depannage

Le bot ne repond pas dans les canaux ?

Assurez-vous que le bot est invite dans le canal et a les bons scopes. Verifiez si requireMention est active.

Erreurs de connexion Socket Mode ?

Verifiez que votre App Token (xapp-...) est correct et a le scope connections:write.

La commande slash n'apparait pas ?

Allez dans "Slash Commands" dans les parametres de votre app Slack et creez la commande manuellement, en la pointant vers Socket Mode.

Erreurs de permission refusee ?

Reinstallez l'app dans votre espace de travail apres avoir ajoute de nouveaux scopes. Certains changements de scope necessitent une reinstallation.

Slack connecte !

Configurez maintenant d'autres canaux ou ameliorez votre bot avec des competences personnalisees.