Compatible avec OpenClaw v2026.2 | Cet article suppose que vous avez déjà installé OpenClaw et que vous disposez d’un Token de Bot Telegram (obtention gratuite).

TL;DR : Telegram est le canal le plus simple à configurer : créez un Bot (@BotFather), obtenez le Token, configurez-le dans ~/.openclaw/openclaw.json, puis démarrez le Gateway. Par défaut, la protection par appairage DM est activée, et dans les groupes, le Bot ne répond qu’aux @mentions. Ce guide couvre également WhatsApp (connexion par QR code), Discord (Bot Token) et Slack.

Pourquoi commencer par Telegram ?

Comparaison des canaux

Pourquoi choisir Telegram

1. Configuration la plus simple : il suffit de créer un Bot et d’obtenir un Token
2. Documentation la plus complète : l’API Bot de Telegram est une référence dans l’industrie
3. Fonctionnalités les plus riches : commandes, boutons, requêtes inline, etc.
4. Communauté la plus active : les solutions aux problèmes se trouvent facilement

Création du Bot Telegram

Étape 1 : trouver BotFather

1. Ouvrez l’application Telegram
2. Recherchez @BotFather (l’outil officiel de gestion des Bots)
3. Cliquez pour entrer dans la conversation

sequenceDiagram
    participant U as Vous
    participant BF as BotFather
    participant TG as Telegram
    
    U->>BF: /newbot
    BF->>U: Entrez le nom d'affichage du Bot
    U->>BF: My OpenClaw Assistant
    BF->>U: Entrez le nom d'utilisateur du Bot (doit finir par bot)
    U->>BF: myclaw_bot
    BF->>TG: Création du Bot
    TG-->>BF: Bot créé avec succès
    BF->>U: Retourne le Token API

Étape 2 : créer un nouveau Bot

Envoyez la commande suivante dans BotFather :

/newbot

Suivez les instructions :

1. Nom d’affichage du Bot : par exemple My OpenClaw (les espaces sont autorisés)
2. Nom d’utilisateur du Bot : par exemple myclaw_bot (doit se terminer par bot)

Une fois créé, BotFather retourne :

Done! Congratulations on your new bot...

Use this token to access the HTTP API:
7123456789:AAHxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Keep your token secure...

⚠️ Important : conservez précieusement votre Token API, il donne un contrôle total sur votre Bot.

Étape 3 : configurer les informations du Bot (optionnel)

# Définir l'avatar du Bot dans BotFather
/setuserpic
# Sélectionnez votre Bot, puis téléchargez une image

# Définir la description du Bot
/setdescription
# Sélectionnez votre Bot, puis saisissez le texte de description

# Définir la bio du Bot
/setabouttext
# Sélectionnez votre Bot, puis saisissez le texte de bio

# Définir les commandes du Bot
/setcommands
# Saisissez la liste des commandes, par exemple :
# start - Démarrer
# help - Obtenir de l'aide
# status - Voir le statut

Configuration d’OpenClaw

Méthode A : variables d’environnement (test rapide)

# Définir la variable d'environnement
export TELEGRAM_BOT_TOKEN="7123456789:AAHxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

# Démarrer le Gateway
openclaw gateway

Méthode B : fichier de configuration (recommandé en production)

Éditez ~/.openclaw/openclaw.json :

{
  "agent": {
    "model": "anthropic/claude-opus-4-6"
  },
  "channels": {
    "telegram": {
      "botToken": "7123456789:AAHxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
    }
  }
}

Méthode C : configuration via CLI

# Configuration interactive
openclaw config set channels.telegram.botToken "7123456789:AAH..."

# Ou via l'assistant d'intégration
openclaw onboard

Vérification de la configuration

# Vérifier la configuration
openclaw config get channels.telegram.botToken

# Lancer le diagnostic
openclaw doctor

# Démarrer le Gateway (mode debug)
openclaw gateway --verbose

Après un démarrage réussi, vous devriez voir des logs similaires à :

[INFO] Gateway starting on port 18789
[INFO] Telegram channel connected
[INFO] Bot: @myclaw_bot
[INFO] Waiting for messages...

Configuration de la sécurité

Mécanisme d’appairage DM

Par défaut, OpenClaw active le mécanisme d’appairage DM (dmPolicy: "pairing"), empêchant les inconnus d’abuser de votre Bot.

sequenceDiagram
    participant S as Inconnu
    participant B as Bot
    participant G as Gateway
    participant O as Vous
    
    S->>B: Envoie un message "Bonjour"
    B->>G: Message reçu
    G->>G: Vérification de l'appairage
    G-->>B: Non appairé, retourne le code
    B-->>S: "Veuillez vous appairer : code ABC123"
    S->>O: Vous communique le code
    O->>G: openclaw pairing approve telegram ABC123
    G->>G: Ajout à la liste blanche
    G-->>S: Appairage réussi, conversation possible

Configuration de la politique DM

{
  "channels": {
    "telegram": {
      "botToken": "your_token",
      "dmPolicy": "pairing",
      "allowFrom": []
    }
  }
}

Gestion des demandes d’appairage

# Voir la liste des appairages en attente
openclaw pairing list

# Exemple de sortie :
# Channel    Code     User        Created
# telegram   ABC123   @stranger   2026-02-26 10:30:00

# Approuver un appairage
openclaw pairing approve telegram ABC123

# Refuser un appairage
openclaw pairing reject telegram ABC123

# Voir les utilisateurs appairés
openclaw pairing show telegram

Mode liste blanche

Autoriser uniquement des utilisateurs spécifiques à envoyer des messages :

{
  "channels": {
    "telegram": {
      "botToken": "your_token",
      "dmPolicy": "open",
      "allowFrom": [123456789, 987654321]
    }
  }
}

💡 Obtenir un ID utilisateur Telegram : envoyez un message quelconque à @userinfobot, il retournera votre ID numérique.

Configuration des groupes

Configuration de base

{
  "channels": {
    "telegram": {
      "botToken": "your_token",
      "groups": {
        "*": {
          "requireMention": true
        }
      }
    }
  }
}

Configuration différenciée par groupe

{
  "channels": {
    "telegram": {
      "botToken": "your_token",
      "groups": {
        "-100123456789": {
          "requireMention": false,
          "name": "Groupe travail"
        },
        "-100987654321": {
          "requireMention": true,
          "name": "Groupe discussion"
        },
        "*": {
          "requireMention": true
        }
      }
    }
  }
}

💡 Obtenir l’ID d’un groupe : après avoir ajouté le Bot au groupe, envoyez un message dans le groupe et consultez les logs du Gateway pour voir l’ID du groupe.

Ajouter le Bot à un groupe

1. Dans les paramètres du groupe, cliquez sur « Ajouter un membre »
2. Recherchez le nom d’utilisateur de votre Bot (par exemple @myclaw_bot)
3. Sélectionnez et ajoutez
4. (Optionnel) Définissez le Bot comme administrateur pour obtenir plus de permissions

Configuration de WhatsApp

Méthode : connexion par QR code

WhatsApp utilise le protocole Web et nécessite une liaison par QR code :

# Démarrer le processus de connexion
openclaw channels login whatsapp

# Le terminal affiche un QR code
# Scannez avec votre téléphone WhatsApp :
# Paramètres > Appareils connectés > Connecter un appareil > Scanner le QR code

sequenceDiagram
    participant U as Utilisateur
    participant C as CLI
    participant W as WhatsApp
    participant G as Gateway
    
    U->>C: openclaw channels login whatsapp
    C->>W: Demande de QR code
    W-->>C: Retourne le QR code
    C->>U: Affiche le QR code
    U->>W: Scanne avec le téléphone
    W-->>C: Authentification réussie
    C->>G: Sauvegarde des identifiants
    G-->>U: WhatsApp connecté

Exemple de configuration

{
  "channels": {
    "whatsapp": {
      "allowFrom": ["+8613800138000"],
      "groups": {
        "*": {
          "requireMention": true
        }
      }
    }
  }
}

Limitations de WhatsApp

Configuration de Discord

Créer un Bot Discord

1. Rendez-vous sur le Discord Developer Portal
2. Cliquez sur « New Application »
3. Saisissez un nom, par exemple OpenClaw Assistant
4. Allez dans la page « Bot », cliquez sur « Add Bot »
5. Copiez le Token (attention, pas l’Application ID)

Configurer les permissions OAuth2

1. Allez dans « OAuth2 » > « URL Generator »
2. Cochez les permissions suivantes :

3. Copiez le lien d’invitation généré
4. Ouvrez le lien dans un navigateur pour inviter le Bot sur votre serveur

Exemple de configuration

{
  "channels": {
    "discord": {
      "token": "MTk4NjIyNDgzNDc...",
      "guilds": {
        "*": {
          "requireMention": true
        }
      }
    }
  }
}

Configuration avancée de Discord

{
  "channels": {
    "discord": {
      "token": "your_token",
      "commands": {
        "native": true,
        "text": true
      },
      "mediaMaxMb": 25
    }
  }
}

Configuration de Slack

Créer une application Slack

1. Rendez-vous sur Slack API
2. Cliquez sur « Create New App »
3. Sélectionnez « From scratch »
4. Saisissez le nom de l’application et sélectionnez l’espace de travail

Configurer les permissions OAuth

Dans la page « OAuth & Permissions », ajoutez les Bot Token Scopes suivants :

app_mentions:read
channels:history
channels:read
chat:write
files:read
files:write
groups:history
groups:read
im:history
im:read
im:write
mpim:history
mpim:read
mpim:write
reactions:read
reactions:write
users:read

Installer dans l’espace de travail

1. Cliquez sur « Install to Workspace »
2. Autorisez les permissions
3. Copiez le Bot User OAuth Token (commence par xoxb-)

Exemple de configuration

{
  "channels": {
    "slack": {
      "botToken": "xoxb-...",
      "appToken": "xapp-...",
      "signingSecret": "..."
    }
  }
}

Activer le Socket Mode (recommandé)

1. Activez-le dans la page « Socket Mode »
2. Générez un App-Level Token
3. Configurez-le dans OpenClaw :

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

Activation simultanée de plusieurs canaux

Exemple de configuration complète

{
  "agent": {
    "model": "anthropic/claude-opus-4-6"
  },
  "gateway": {
    "port": 18789,
    "bind": "loopback"
  },
  "channels": {
    "telegram": {
      "botToken": "telegram_bot_token",
      "dmPolicy": "pairing",
      "groups": {
        "*": { "requireMention": true }
      }
    },
    "whatsapp": {
      "allowFrom": ["+8613800138000"]
    },
    "discord": {
      "token": "discord_token",
      "guilds": {
        "*": { "requireMention": true }
      }
    },
    "slack": {
      "botToken": "xoxb-...",
      "appToken": "xapp-..."
    }
  }
}

Schéma de routage des messages

flowchart TB
    subgraph Users["Utilisateurs"]
        WA[Utilisateur WhatsApp]
        TG[Utilisateur Telegram]
        DC[Utilisateur Discord]
        SL[Utilisateur Slack]
    end
    
    subgraph Gateway["Gateway"]
        MR[Message Router]
        SM[Session Manager]
    end
    
    subgraph Agent["Pi Agent"]
        AI[Noyau IA]
        CTX[Contexte partagé]
    end
    
    WA --> MR
    TG --> MR
    DC --> MR
    SL --> MR
    MR --> SM
    SM --> AI
    AI --> CTX

Tous les canaux partagent le même Agent, avec une gestion unifiée du contexte. Cela signifie :

• Une question posée sur Telegram peut être poursuivie sur WhatsApp
• Les utilisateurs de différents canaux peuvent partager la même mémoire
• Chaque canal peut avoir sa propre stratégie d’isolation des sessions

Commandes de gestion des sessions

Commandes universelles pour tous les canaux (envoyées dans le chat) :

Dépannage

Le Bot Telegram ne répond pas

Symptôme : aucune réponse après l’envoi d’un message

Étapes de diagnostic :

# 1. Vérifier que le Gateway est en cours d'exécution
curl http://127.0.0.1:18789/health

# 2. Vérifier le Token du Bot
openclaw config get channels.telegram.botToken

# 3. Consulter les logs détaillés
openclaw gateway --verbose

# 4. Lancer le diagnostic
openclaw doctor

Causes fréquentes :

Échec du scan QR WhatsApp

Symptôme : échec affiché après le scan

Solution :

# Régénérer le QR code
openclaw channels logout whatsapp
openclaw channels login whatsapp

# Vérifier le réseau
ping web.whatsapp.com

# Effacer le cache des identifiants
rm -rf ~/.openclaw/credentials/whatsapp*

Le Bot Discord n’a pas les permissions

Symptôme : le Bot ne répond pas ou n’a pas de permissions sur le serveur

Solution :

1. Vérifiez les permissions du rôle du Bot
2. Confirmez que le Bot a bien été invité sur le serveur
3. Réinvitez le Bot (avec l’URL OAuth correcte)

# Vérifier les erreurs de permission dans les logs
openclaw gateway --verbose 2>&1 | grep -i permission

La configuration ne prend pas effet

Symptôme : le comportement ne change pas après modification de la configuration

Solution :

# 1. Redémarrer le Gateway
openclaw gateway --restart

# 2. Vider le cache
rm -rf ~/.openclaw/cache/*

# 3. Vérifier la syntaxe du fichier de configuration
cat ~/.openclaw/openclaw.json | jq .

# 4. Vérifier la priorité de la configuration
openclaw config list

Bonnes pratiques de sécurité

1. Sécurité des Tokens

# Ne jamais commiter les Tokens dans le contrôle de version
echo ".openclaw/" >> .gitignore

# Utiliser des variables d'environnement pour les informations sensibles
export TELEGRAM_BOT_TOKEN="your_token"

# Renouveler régulièrement les Tokens (dans BotFather)
# La commande /revoke permet de régénérer le Token

2. Contrôle d’accès

{
  "channels": {
    "telegram": {
      "dmPolicy": "pairing",
      "allowFrom": [],
      "groups": {
        "*": { "requireMention": true }
      }
    }
  },
  "agents": {
    "defaults": {
      "sandbox": {
        "mode": "non-main"
      }
    }
  }
}

3. Audit des logs

# Activer les logs détaillés
openclaw gateway --verbose

# Consulter l'historique des sessions
openclaw sessions list
openclaw sessions show <session-id>

# Auditer l'exécution des commandes
grep "bash" ~/.openclaw/logs/gateway.log

Prochaines étapes

Félicitations ! Vous avez terminé la configuration de votre premier canal. Vous pouvez maintenant :

1. Tester la conversation → Envoyez un message dans le canal configuré
2. Installer des Skills → Étendez les capacités de l’IA
3. Configurer plusieurs canaux → Ajoutez d’autres canaux

Résumé de cet article :

• Maîtrise de la création et de la configuration d’un Bot Telegram
• Compréhension de l’appairage DM et de la configuration des groupes
• Apprentissage de la configuration de WhatsApp, Discord et Slack
• Connaissance de l’activation simultanée de plusieurs canaux
• Maîtrise du dépannage des problèmes courants

Historique des mises à jour :

• 26/02/2026 : publication initiale, basée sur OpenClaw v2026.2

Navigation de la série :

• ← Précédent : Mise en place de l’environnement et premier lancement
• → Suivant : Concepts fondamentaux du Gateway