​

Microsoft Teams (plugin)

« Abandonnez tout espoir, vous qui entrez ici.

​

Plugin requis

openclaw plugins install @openclaw/msteams

openclaw plugins install ./extensions/msteams

​

Demarrage rapide (debutant)

1. Installez le plugin Microsoft Teams.
2. Creez un Azure Bot (ID d’application + secret client + ID de locataire).
3. Configurez OpenClaw avec ces identifiants.
4. Exposez /api/messages (port 3978 par defaut) via une URL publique ou un tunnel.
5. Installez le package d’application Teams et demarrez la passerelle.

{
  channels: {
    msteams: {
      enabled: true,
      appId: "<APP_ID>",
      appPassword: "<APP_PASSWORD>",
      tenantId: "<TENANT_ID>",
      webhook: { port: 3978, path: "/api/messages" },
    },
  },
}

​

Objectifs

• Discuter avec OpenClaw via des Messages prives Teams, des discussions de groupe ou des canaux.
• Garder un routage deterministe : les reponses reviennent toujours sur le canal d’origine.
• Adopter par defaut un comportement de canal sur (mentions requises sauf configuration contraire).

​

Ecritures de configuration

{
  channels: { msteams: { configWrites: false } },
}

​

Controle d’acces (Messages prives + groupes)

• Par defaut : channels.msteams.dmPolicy = "pairing". Les expediteurs inconnus sont ignores jusqu’a approbation.
• channels.msteams.allowFrom accepte des ID d’objet AAD, des UPN ou des noms d’affichage. L’assistant resout les noms en ID via Microsoft Graph lorsque les identifiants le permettent.

• Par defaut : channels.msteams.groupPolicy = "allowlist" (bloque sauf si vous ajoutez groupAllowFrom). Utilisez channels.defaults.groupPolicy pour remplacer le defaut lorsqu’il n’est pas defini.
• channels.msteams.groupAllowFrom controle quels expediteurs peuvent declencher dans les discussions de groupe/canaux (repli sur channels.msteams.allowFrom).
• Definissez groupPolicy: "open" pour autoriser tout membre (mention toujours requise par defaut).
• Pour n’autoriser aucun canal, definissez channels.msteams.groupPolicy: "disabled".

{
  channels: {
    msteams: {
      groupPolicy: "allowlist",
      groupAllowFrom: ["[email protected]"],
    },
  },
}

• Cadrez les reponses de groupe/canal en listant les equipes et canaux sous channels.msteams.teams.
• Les cles peuvent etre des ID ou des noms d’equipe ; les cles de canal peuvent etre des ID de conversation ou des noms.
• Lorsque groupPolicy="allowlist" et qu’une liste d’autorisation d’equipes est presente, seules les equipes/canaux listes sont acceptes (mention requise).
• L’assistant de configuration accepte les entrees Team/Channel et les stocke pour vous.
• Au demarrage, OpenClaw resout les noms d’equipe/canal et de liste d’autorisation d’utilisateurs en ID (lorsque les autorisations Graph le permettent) et journalise le mappage ; les entrees non resolues sont conservees telles quelles.

{
  channels: {
    msteams: {
      groupPolicy: "allowlist",
      teams: {
        "My Team": {
          channels: {
            General: { requireMention: true },
          },
        },
      },
    },
  },
}

​

Fonctionnement

1. Installez le plugin Microsoft Teams.
2. Creez un Azure Bot (ID d’application + secret + ID de locataire).
3. Construisez un package d’application Teams qui reference le bot et inclut les autorisations RSC ci-dessous.
4. Televersez/installez l’application Teams dans une equipe (ou en perimetre personnel pour les Messages prives).
5. Configurez msteams dans ~/.openclaw/openclaw.json (ou via des variables d’environnement) et demarrez la passerelle.
6. La passerelle ecoute le trafic webhook Bot Framework sur /api/messages par defaut.

​

Configuration Azure Bot (Prerequis)

​

Etape 1 : Creer Azure Bot

1. Allez sur Creer Azure Bot
2. Remplissez l’onglet Basics :

   Champ	Valeur
   Identifiant du bot	Nom de votre bot, p. ex., openclaw-msteams (doit etre unique)
   Abonnement	Selectionnez votre abonnement Azure
   Groupe de ressources	Creez-en un nouveau ou utilisez l’existant
   Niveau tarifaire	Free pour dev/test
   Type d’application	Single Tenant (recommande – voir note ci-dessous)
   Type de création	Créer un nouvel ID d’application Microsoft

Avis de deprecation : la creation de nouveaux bots multi-locataires a ete depreciee apres le 2025-07-31. Utilisez Single Tenant pour les nouveaux bots.

3. Cliquez sur Review + create → Create (attendez ~1–2 minutes)

​

Etape 2 : Obtenir les identifiants

1. Allez sur votre ressource Azure Bot → Configuration
2. Copiez Microsoft App ID → c’est votre appId
3. Cliquez sur Manage Password → allez sur l’Inscription d’application
4. Sous Certificates & secrets → New client secret → copiez la Value → c’est votre appPassword
5. Allez sur Overview → copiez Directory (tenant) ID → c’est votre tenantId

​

Etape 3 : Configurer le point de terminaison de messagerie

1. Dans Azure Bot → Configuration
2. Definissez Messaging endpoint sur l’URL de votre webhook :
   • Production : https://your-domain.com/api/messages
   • Dev local : utilisez un tunnel (voir Developpement local ci-dessous)

​

Etape 4 : Activer le canal Teams

1. Dans Azure Bot → Channels
2. Cliquez sur Microsoft Teams → Configurer → Enregistrer
3. Acceptez les Conditions d’utilisation

​

Developpement local (Tunneling)

ngrok http 3978
# Copy the https URL, e.g., https://abc123.ngrok.io
# Set messaging endpoint to: https://abc123.ngrok.io/api/messages

tailscale funnel 3978
# Use your Tailscale funnel URL as the messaging endpoint

​

Portail Developpeur Teams (Alternative)

1. Cliquez sur + New app
2. Renseignez les informations de base (nom, description, informations developpeur)
3. Allez sur App features → Bot
4. Selectionnez Enter a bot ID manually et collez l’ID d’application Azure Bot
5. Cochez les perimetres : Personal, Team, Group Chat
6. Cliquez sur Distribute → Download app package
7. Dans Teams : Apps → Manage your apps → Upload a custom app → selectionnez le ZIP

​

Tester le bot

1. Dans le Portail Azure → votre ressource Azure Bot → Test in Web Chat
2. Envoyez un message – vous devriez voir une reponse
3. Cela confirme que votre point de terminaison webhook fonctionne avant la configuration Teams

1. Installez l’application Teams (sideload ou catalogue d’organisation)
2. Trouvez le bot dans Teams et envoyez un Message prive
3. Verifiez les journaux de la passerelle pour l’activite entrante

​

Configuration (texte uniquement, minimale)

1. Installer le plugin Microsoft Teams
   • Depuis npm : openclaw plugins install @openclaw/msteams
   • Depuis un depot local : openclaw plugins install ./extensions/msteams
2. Enregistrement du bot
   • Creez un Azure Bot (voir ci-dessus) et notez :
     • ID d’application
     • Secret client (mot de passe de l’application)
     • ID de locataire (single-tenant)
3. Manifeste de l’application Teams
   • Inclure une entree bot avec botId = <App ID>.
   • Perimetres : personal, team, groupChat.
   • supportsFiles: true (requis pour la gestion des fichiers en perimetre personnel).
   • Ajouter les autorisations RSC (ci-dessous).
   • Creer des icones : outline.png (32x32) et color.png (192x192).
   • Zipper les trois fichiers ensemble : manifest.json, outline.png, color.png.
4. Configurer OpenClaw
   {
     "msteams": {
       "enabled": true,
       "appId": "<APP_ID>",
       "appPassword": "<APP_PASSWORD>",
       "tenantId": "<TENANT_ID>",
       "webhook": { "port": 3978, "path": "/api/messages" }
     }
   }
   
   Vous pouvez aussi utiliser des variables d’environnement a la place des cles de configuration :
   • MSTEAMS_APP_ID
   • MSTEAMS_APP_PASSWORD
   • MSTEAMS_TENANT_ID
5. Point de terminaison du bot
   • Definissez le Messaging Endpoint Azure Bot sur :
     • https://<host>:3978/api/messages (ou le chemin/port de votre choix).
6. Lancer la passerelle
   • Le canal Teams demarre automatiquement lorsque le plugin est installe et que la configuration msteams existe avec des identifiants.

​

Contexte d’historique

• channels.msteams.historyLimit controle le nombre de messages recents de canal/groupe inclus dans l’invite.
• Repli sur messages.groupChat.historyLimit. Definissez 0 pour desactiver (50 par defaut).
• L’historique des Messages prives peut etre limite avec channels.msteams.dmHistoryLimit (tours utilisateur). Remplacements par utilisateur : channels.msteams.dms["<user_id>"].historyLimit.

​

Autorisations RSC Teams actuelles (Manifeste)

• ChannelMessage.Read.Group (Application) – recevoir tous les messages de canal sans @mention
• ChannelMessage.Send.Group (Application)
• Member.Read.Group (Application)
• Owner.Read.Group (Application)
• ChannelSettings.Read.Group (Application)
• TeamMember.Read.Group (Application)
• TeamSettings.Read.Group (Application)

• ChatMessage.Read.Chat (Application) – recevoir tous les messages de discussion de groupe sans @mention

​

Exemple de manifeste Teams (expurge)

{
  "$schema": "https://developer.microsoft.com/en-us/json-schemas/teams/v1.23/MicrosoftTeams.schema.json",
  "manifestVersion": "1.23",
  "version": "1.0.0",
  "id": "00000000-0000-0000-0000-000000000000",
  "name": { "short": "OpenClaw" },
  "developer": {
    "name": "Your Org",
    "websiteUrl": "https://example.com",
    "privacyUrl": "https://example.com/privacy",
    "termsOfUseUrl": "https://example.com/terms"
  },
  "description": { "short": "OpenClaw in Teams", "full": "OpenClaw in Teams" },
  "icons": { "outline": "outline.png", "color": "color.png" },
  "accentColor": "#5B6DEF",
  "bots": [
    {
      "botId": "11111111-1111-1111-1111-111111111111",
      "scopes": ["personal", "team", "groupChat"],
      "isNotificationOnly": false,
      "supportsCalling": false,
      "supportsVideo": false,
      "supportsFiles": true
    }
  ],
  "webApplicationInfo": {
    "id": "11111111-1111-1111-1111-111111111111"
  },
  "authorization": {
    "permissions": {
      "resourceSpecific": [
        { "name": "ChannelMessage.Read.Group", "type": "Application" },
        { "name": "ChannelMessage.Send.Group", "type": "Application" },
        { "name": "Member.Read.Group", "type": "Application" },
        { "name": "Owner.Read.Group", "type": "Application" },
        { "name": "ChannelSettings.Read.Group", "type": "Application" },
        { "name": "TeamMember.Read.Group", "type": "Application" },
        { "name": "TeamSettings.Read.Group", "type": "Application" },
        { "name": "ChatMessage.Read.Chat", "type": "Application" }
      ]
    }
  }
}

​

Points d’attention du manifeste (champs indispensables)

• bots[].botId doit correspondre a l’ID d’application Azure Bot.
• webApplicationInfo.id doit correspondre a l’ID d’application Azure Bot.
• bots[].scopes doit inclure les surfaces que vous prevoyez d’utiliser (personal, team, groupChat).
• bots[].supportsFiles: true est requis pour la gestion des fichiers en perimetre personnel.
• authorization.permissions.resourceSpecific doit inclure la lecture/envoi de canal si vous voulez du trafic de canal.

​

Mettre a jour une application existante

1. Mettez a jour votre manifest.json avec les nouveaux parametres
2. Incrementez le champ version (p. ex., 1.0.0 → 1.1.0)
3. Re-zippez le manifeste avec les icones (manifest.json, outline.png, color.png)
4. Televersez le nouveau zip :
   • Option A (Centre d’administration Teams) : Teams Admin Center → Teams apps → Manage apps → trouvez votre app → Upload new version
   • Option B (Sideload) : Dans Teams → Apps → Manage your apps → Upload a custom app
5. Pour les canaux d’equipe : Reinstallez l’app dans chaque equipe pour que les nouvelles autorisations prennent effet
6. Quittez completement et relancez Teams (pas seulement fermer la fenetre) pour vider les metadonnees d’app en cache

​

Capacites : RSC uniquement vs Graph

​

Avec Teams RSC uniquement (app installee, sans autorisations Graph API)

• Lire le contenu texte des messages de canal.
• Envoyer du texte dans les canaux.
• Recevoir des pieces jointes personnelles (Message prive).

• Images ou contenus de fichiers de canal/groupe (la charge utile n’inclut qu’un stub HTML).
• Telechargement de pieces jointes stockees dans SharePoint/OneDrive.
• Lecture de l’historique des messages (au-dela de l’evenement webhook en direct).

​

Avec Teams RSC + autorisations d’application Microsoft Graph

• Telechargement de contenus heberges (images collees dans les messages).
• Telechargement de pieces jointes stockees dans SharePoint/OneDrive.
• Lecture de l’historique des messages de canal/discussion via Graph.

​

RSC vs Graph API

​

Medias + historique actives par Graph (requis pour les canaux)

1. Dans Entra ID (Azure AD) App Registration, ajoutez des autorisations d’application Microsoft Graph :
   • ChannelMessage.Read.All (pieces jointes de canal + historique)
   • Chat.Read.All ou ChatMessage.Read.All (discussions de groupe)
2. Accordez le consentement admin pour le locataire.
3. Incrementez la version du manifeste de l’app Teams, re-televersez et reinstallez l’app dans Teams.
4. Quittez completement et relancez Teams pour vider les metadonnees d’app en cache.

​

Limitations connues

​

Delais d’expiration des webhooks

• Délai d’attente de la passerelle
• Des tentatives de re-livraison par Teams (causant des doublons)
• Des reponses perdues

​

Mise en forme

• La mise en forme de base fonctionne : gras, italique, code, liens
• Le markdown complexe (tableaux, listes imbriquees) peut mal s’afficher
• Les Cartes adaptatives sont prises en charge pour les sondages et les envois arbitraires (voir ci-dessous)

​

Configuration

• channels.msteams.enabled : activer/desactiver le canal.
• channels.msteams.appId, channels.msteams.appPassword, channels.msteams.tenantId : identifiants du bot.
• channels.msteams.webhook.port (par defaut 3978)
• channels.msteams.webhook.path (par defaut /api/messages)
• channels.msteams.dmPolicy : pairing | allowlist | open | disabled (par defaut : appairage)
• channels.msteams.allowFrom : liste d’autorisation pour les Messages prives (ID d’objet AAD, UPN ou noms d’affichage). L’assistant resout les noms en ID lors de la configuration quand l’acces Graph est disponible.
• channels.msteams.textChunkLimit : taille des segments de texte sortant.
• channels.msteams.chunkMode : length (par defaut) ou newline pour decouper sur les lignes vides (limites de paragraphes) avant le decoupage par longueur.
• channels.msteams.mediaAllowHosts : liste d’autorisation des hotes de pieces jointes entrantes (par defaut domaines Microsoft/Teams).
• channels.msteams.mediaAuthAllowHosts : liste d’autorisation pour joindre des en-tetes Authorization lors des reprises media (par defaut hotes Graph + Bot Framework).
• channels.msteams.requireMention : exiger @mention dans les canaux/groupes (par defaut true).
• channels.msteams.replyStyle : thread | top-level (voir Style de reponse).
• channels.msteams.teams.<teamId>.replyStyle : remplacement par equipe.
• channels.msteams.teams.<teamId>.requireMention : remplacement par equipe.
• channels.msteams.teams.<teamId>.tools : remplacements de politique d’outils par defaut par equipe (allow/deny/alsoAllow) utilises lorsqu’un remplacement de canal est manquant.
• channels.msteams.teams.<teamId>.toolsBySender : remplacements de politique d’outils par defaut par equipe et par expediteur ("*" joker pris en charge).
• channels.msteams.teams.<teamId>.channels.<conversationId>.replyStyle : remplacement par canal.
• channels.msteams.teams.<teamId>.channels.<conversationId>.requireMention : remplacement par canal.
• channels.msteams.teams.<teamId>.channels.<conversationId>.tools : remplacements de politique d’outils par canal (allow/deny/alsoAllow).
• channels.msteams.teams.<teamId>.channels.<conversationId>.toolsBySender : remplacements de politique d’outils par canal et par expediteur ("*" joker pris en charge).
• channels.msteams.sharePointSiteId : ID de site SharePoint pour les televersements de fichiers dans les discussions de groupe/canaux (voir Envoi de fichiers dans les discussions de groupe).

​

Routage & Sessions

• Les cles de session suivent le format standard d’agent (voir /concepts/session) :
  • Les Messages prives partagent la session principale (agent:<agentId>:<mainKey>).
  • Les messages de canal/groupe utilisent l’ID de conversation :
    • agent:<agentId>:msteams:channel:<conversationId>
    • agent:<agentId>:msteams:group:<conversationId>

​

Style de reponse : Fils vs Publications

• thread dans un canal de type Fils → les reponses apparaissent imbriquees de facon maladroite
• top-level dans un canal de type Publications → les reponses apparaissent comme des publications de premier niveau separees au lieu d’etre en fil

{
  "msteams": {
    "replyStyle": "thread",
    "teams": {
      "19:[email protected]": {
        "channels": {
          "19:[email protected]": {
            "replyStyle": "top-level"
          }
        }
      }
    }
  }
}

​

Pieces jointes & Images

• Messages prives : les images et pieces jointes fonctionnent via les API de fichiers des bots Teams.
• Canaux/groupes : les pieces jointes vivent dans le stockage M365 (SharePoint/OneDrive). La charge utile du webhook n’inclut qu’un stub HTML, pas les octets du fichier. Des autorisations Graph API sont requises pour telecharger les pieces jointes de canal.

​

Envoi de fichiers dans les discussions de groupe

​

Pourquoi les discussions de groupe necessitent SharePoint

​

Délai d’attente de la passerelle

1. Ajouter des autorisations Graph API dans Entra ID (Azure AD) → App Registration :
   • Sites.ReadWrite.All (Application) – televerser des fichiers vers SharePoint
   • Chat.Read.All (Application) – optionnel, active les liens de partage par utilisateur
2. Accorder le consentement admin pour le locataire.
3. Obtenir l’ID de votre site SharePoint :
   # Via Graph Explorer or curl with a valid token:
   curl -H "Authorization: Bearer $TOKEN" \
     "https://graph.microsoft.com/v1.0/sites/{hostname}:/{site-path}"
   
   # Example: for a site at "contoso.sharepoint.com/sites/BotFiles"
   curl -H "Authorization: Bearer $TOKEN" \
     "https://graph.microsoft.com/v1.0/sites/contoso.sharepoint.com:/sites/BotFiles"
   
   # Response includes: "id": "contoso.sharepoint.com,guid1,guid2"
   
4. Configurer OpenClaw :
   {
     channels: {
       msteams: {
         // ... other config ...
         sharePointSiteId: "contoso.sharepoint.com,guid1,guid2",
       },
     },
   }
   

​

Comportement de partage

​

Comportement de repli

​

Emplacement de stockage des fichiers

​

Sondages (Cartes adaptatives)

• CLI : openclaw message poll --channel msteams --target conversation:<id> ...
• Les votes sont enregistres par la passerelle dans ~/.openclaw/msteams-polls.json.
• La passerelle doit rester en ligne pour enregistrer les votes.
• Les sondages ne publient pas encore automatiquement des resumes de resultats (inspectez le fichier de stockage si necessaire).

​

Cartes adaptatives (arbitraires)

{
  "action": "send",
  "channel": "msteams",
  "target": "user:<id>",
  "card": {
    "type": "AdaptiveCard",
    "version": "1.5",
    "body": [{ "type": "TextBlock", "text": "Hello!" }]
  }
}

openclaw message send --channel msteams \
  --target "conversation:19:[email protected]" \
  --card '{"type":"AdaptiveCard","version":"1.5","body":[{"type":"TextBlock","text":"Hello!"}]}'

​

Formats cibles

# Send to a user by ID
openclaw message send --channel msteams --target "user:40a1a0ed-..." --message "Hello"

# Send to a user by display name (triggers Graph API lookup)
openclaw message send --channel msteams --target "user:John Smith" --message "Hello"

# Send to a group chat or channel
openclaw message send --channel msteams --target "conversation:19:[email protected]" --message "Hello"

# Send an Adaptive Card to a conversation
openclaw message send --channel msteams --target "conversation:19:[email protected]" \
  --card '{"type":"AdaptiveCard","version":"1.5","body":[{"type":"TextBlock","text":"Hello"}]}'

{
  "action": "send",
  "channel": "msteams",
  "target": "user:John Smith",
  "message": "Hello!"
}

{
  "action": "send",
  "channel": "msteams",
  "target": "conversation:19:[email protected]",
  "card": {
    "type": "AdaptiveCard",
    "version": "1.5",
    "body": [{ "type": "TextBlock", "text": "Hello" }]
  }
}

​

Messagerie proactive

• Les messages proactifs ne sont possibles qu’apres qu’un utilisateur a interagi, car nous stockons alors les references de conversation.
• Voir /gateway/configuration pour dmPolicy et le filtrage par liste d’autorisation.

​

ID d’equipe et de canal (piege courant)

https://teams.microsoft.com/l/team/19%3ABk4j...%40thread.tacv2/conversations?groupId=...
                                    └────────────────────────────┘
                                    Team ID (URL-decode this)

https://teams.microsoft.com/l/channel/19%3A15bc...%40thread.tacv2/ChannelName?groupId=...
                                      └─────────────────────────┘
                                      Channel ID (URL-decode this)

• ID d’equipe = segment du chemin apres /team/ (URL-decode, p. ex., 19:[email protected])
• ID de canal = segment du chemin apres /channel/ (URL-decode)
• Ignorez le parametre de requete groupId

​

Canaux prives

1. Utilisez des canaux standards pour les interactions avec le bot
2. Utilisez les Messages prives – les utilisateurs peuvent toujours contacter le bot directement
3. Utilisez Graph API pour l’acces historique (requiert ChannelMessage.Read.All)

​

Problemes courants

​

Problemes courants

• Images absentes dans les canaux : autorisations Graph ou consentement admin manquants. Reinstallez l’app Teams et quittez/reouvrez completement Teams.
• Aucune reponse dans le canal : les mentions sont requises par defaut ; definissez channels.msteams.requireMention=false ou configurez par equipe/canal.
• Incoherence de version (Teams affiche encore l’ancien manifeste) : supprimez puis re-ajoutez l’app et quittez completement Teams pour rafraichir.
• 401 Unauthorized depuis le webhook : attendu lors de tests manuels sans JWT Azure – signifie que le point de terminaison est accessible mais que l’authentification a echoue. Utilisez Azure Web Chat pour tester correctement.

​

Erreurs de televersement du manifeste

• « Icon file cannot be empty » : le manifeste reference des fichiers d’icones de 0 octet. Creez des icones PNG valides (32x32 pour outline.png, 192x192 pour color.png).
• « webApplicationInfo.Id already in use » : l’app est encore installee dans une autre equipe/discussion. Trouvez-la et desinstallez-la d’abord, ou attendez 5–10 minutes pour la propagation.
• « Something went wrong » lors du televersement : televersez via https://admin.teams.microsoft.com a la place, ouvrez les DevTools du navigateur (F12) → onglet Network, et verifiez le corps de reponse pour l’erreur reelle.
• Echec du sideload : essayez « Upload an app to your org’s app catalog » au lieu de « Upload a custom app » – cela contourne souvent les restrictions de sideload.

​

Autorisations RSC qui ne fonctionnent pas

1. Verifiez que webApplicationInfo.id correspond exactement a l’ID d’application de votre bot
2. Re-televersez l’app et reinstallez-la dans l’equipe/discussion
3. Verifiez si votre administrateur d’organisation a bloque les autorisations RSC
4. Confirmez le bon perimetre : ChannelMessage.Read.Group pour les equipes, ChatMessage.Read.Chat pour les discussions de groupe

​

References

• Create Azure Bot – Guide de configuration Azure Bot
• Teams Developer Portal – creer/gerer des apps Teams
• Teams app manifest schema
• Receive channel messages with RSC
• RSC permissions reference
• Teams bot file handling (canal/groupe requiert Graph)
• Proactive messaging